Struttura del modello Template del ticket

<?xml version="1.0" encoding="UTF-8"?>

<ORDER_TEMPLATE_LIST xmlns="http://schemas.stoll.com/ticketing/ordertemplate/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schemas.stoll.com/ticketing/ordertemplate/v1.0 StollOrderTemplates.xsd">

1 <ORDER_TEMPLATE name="NAME_OF_TEMPLATE">

<TEMPLATE_DESCRIPTION>Description of Template</TEMPLATE_DESCRIPTION>

<PRODUCTION_INFO>

2 Mandatory tags from PRODUCTION_INFO group

<ORDER_NUM...>

<ORDER_TYPE...>

<TOTAL_NUM_OF_EXECUTIONS...>

<ESTIMATED_ORDER_DURATION...>

<ORDER_DESCRIPTION...>

<ARTICLE_NUM...>

<STYLE_FILE_PATH...>

</PRODUCTION_INFO>

<ORDER_VELOCITY>

<![CDATA[

3 Add here tags from STOLL:TICKET namespace

## Macro V1.1 to add TAG to resulting XML under commented conditions

#macro (AddTAG $TAG $Param $Default)

...

]]>

</ORDER_VELOCITY>

<CUSTOM_VELOCITY>

<![CDATA[<STOLL:CUSTOM xsi:schemaLocation="http://schemas.custom.com/ticketing/ticket/v0.5 CustomTicket.xsd" xmlns="http://schemas.custom.com/ticketing/ticket/v0.5">

<CARD Version="1.1">

4 Add here tags from STOLL:CUSTOM namespace

</CARD>

</STOLL:CUSTOM>

## Macro V1.1 to add TAG to resulting XML under commented conditions

#macro (AddTAG $TAG $Param $Default)

...

]]>

</CUSTOM_VELOCITY>

<TEMPLATE_TAGS>

5 Add here definitions which produce lines for entering data when using this template and references the corresponding tags in above ORDER_VELOCITY or CUSTOM_VELOCITY block

</TEMPLATE_TAGS>

</ORDER_TEMPLATE>

</ORDER_TEMPLATE_LIST>

Spiegazione

In (3) e (4) è possibile utilizzare la macro AddTAG.

Procedimento:

    1
    Assegnare al modello lo stesso nome con il quale deve essere visualizzato nell'elenco a discesa dei modelli.
    2
    Aggiungere al gruppo di tag PRODUCTION_INFO i tag comprendenti dati preassegnati e per i quali esistono di default caselle di modifica nell'editor degli ordini del PPS.
    3
    Aggiungere in questo riquadro tag dal gruppo STOLL:TICKET ad eccezione dei tag STOLL:CUSTOM. Qui è possibile utilizzare la macro AddTAG.
    4
    Aggiungere in questo riquadro i tag dal gruppo STOLL:CUSTOM. Qui è possibile utilizzare la macro AddTAG.
    5
    Definire qui le caselle di modifica necessarie con riferimenti ai tag STOLL:TICKET e STOLL:CUSTOM.

Esempio:

  1. Si intende registrare un tag per definire le misure e il peso di un telo.
  2. La casella di modifica deve essere modificabile.
    1
    Riportare in (5) la stringa seguente.
    <CUSTOM_TAG label="DIMENSION" editable="true">;;;; [Size;Length;Width;Weight; of knit]</CUSTOM_TAG>
  1. Durante l'applicazione del modello si riceve la casella di modifica seguente (senza M;60…)
    3. 2
    Questo tag deriva dallo spazio dei nomi tag STOLL:CUSTOM e deve essere pertanto referenziato in (4). Ricorrere al riguardo alla macro AddTAG per separare il commento ([Size;Length;Width;Weight; of knit]) e ripartire i parametri.
    #AddTAG(" <DIMENSION Size='$ParamList[0]' Length='$ParamList[1]' Width='$ParamList[2]' Weight='$ParamList[3]' />" $DIMENSION)
  3. Il tag presenta 4 parametri per la definizione di misura e peso del tessuto, da distribuire a loro volta su 4 attributi. I parametri possono essere distribuiti tramite ParamList[N], tendendo presente che N conta a partire da 0, valore che corrisponde al primo parametro nell'immissione.
    L'immissione nella figura precedente viene scomposta come segue:
    ParamList[0]=M
    ParamList[1]=60
    ParamList[2]=52
    ParamList[3]=0,5
  1. Il tag nel file XML risultante viene strutturato come segue:
    <DIMENSION Size='M' Length='60' Width='52' Weight='0,5' />

Altro esempio:

    1
    Si intende rendere impostabile la funzione di stampa al termine dell'ordine.
    L'immissione PRINT attiva la stampa, con NONE la stampa non ha luogo.
  1. La casella di modifica deve essere modificabile.
    1
    Riportare in (5) un tag per attivare la funzione di stampa.
    <CUSTOM_TAG label="ACTION_DEFINITION" editable="true">; [NONE|PRINT; Action to take place after knit is done]</CUSTOM_TAG>
  1. Durante l'applicazione del modello si riceve la casella di modifica seguente
    2. 2
    Referenziare questo tag in (3), considerando che esso deriva dal gruppo STOLL:TICKET\STOLL:PRODUCTION_INFO.
    3
    Ricorrere alla macro AddTAG per separare il commento [NONE|PRINT; Action to take place after knit is done], per estrarre l'unico parametro e impostare il valore di default in mancanza di immissione su NONE.
    #AddTAG(" <STOLL:ACTION_DEFINITION>$ParamList[0]</STOLL:ACTION_DEFINITION>" $ACTION_DEFINITION "NONE")
  2. Se non si immette niente nel campo ACTION_DEFINITION, al momento di creare il ticket viene riportato nella XML "NONE", in quanto la macro riconosce che non è stato immesso niente, pur risultando un valore di default "NONE".
    Senza il valore di default il tag non sarebbe contenuto nel ticket.
    Nel file XML risultante la struttura è in questo caso la seguente:
    <STOLL:ACTION_DEFINITION>NONE</STOLL:ACTION_DEFINITION>
  3. Se si riporta PRINT, l'output nella XML sarà:
    <STOLL:ACTION_DEFINITION>PRINT</STOLL:ACTION_DEFINITION>

Un altro esempio per l'incorporazione di User Tag:

  1. Si intende aggiungere un User Tag, ad es. per ricevere dall'operatore della macchina la conferma sulla riuscita di un aggiornamento.
    1
    Riportare in (5) questo tag:
    <USER_TAG label="Update ok" editable="true"></USER_TAG>
  1. I tag utente vengono supportati implicitamente dal PPS e questo tag, incluso il tag di gruppo, viene scritto automaticamente nel file XML risultante: