Estructura del modelo de plantilla de 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>

Explicación

En (3) y (4) es posible insertar la macro AddTAG.

Procedimiento:

    1
    Entre el nombre para la plantilla tal cual debe ser mostrado en la lista desplegable de las plantillas.
    2
    En este grupo de etiquetas agregue etiquetas PRODUCTION_INFO que contengan datos preasignados y para los cuales existan de forma estándar cuadros de edición en el editor de pedidos del PPS.
    3
    En esta área agregue etiquetas del grupo STOLL:TICKET a excepción de etiquetas STOLL:CUSTOM. Aquí puede insertar la macro AddTAG.
    4
    En esta área agregue etiquetas del grupo STOLL:CUSTOM. Aquí puede insertar la macro AddTAG.
    5
    Defina aquí los necesarios cuadros de edición con referencia a etiquetas STOLL:TICKET y STOLL:CUSTOM

Ejemplo:

  1. Usted desea entrar una etiqueta para definir la indicación de tamaño y peso de una pieza de tisaje.
  2. Y que el cuadro de edición sea editable.
    1
    Entre el siguiente string en (5).
    <CUSTOM_TAG label="DIMENSION" editable="true">;;;; [Size;Length;Width;Weight; of knit]</CUSTOM_TAG>
  1. Al aplicar la plantilla, recibirá el siguiente cuadro de edición (sin M;60...)
  2. 2
    Esta etiqueta proviene del área de nombres de la etiqueta STOLL:CUSTOM y por consiguiente debe ser referenciada en (4). Para ello inserta la macro AddTAG para separar el comentario ([Size;Length;Width;Weight; of knit]) y distribuir los parámetros.
    #AddTAG(" <DIMENSION Size='$ParamList[0]' Length='$ParamList[1]' Width='$ParamList[2]' Weight='$ParamList[3]' />" $DIMENSION)
  3. La etiqueta tiene 4 parámetros para determinar el tamaño y el peso del tejido que deben ser distribuidos a 4 atributos. Los parámetros pueden ser divididos a través de ParamList[N], donde N cuenta a partir de 0, lo cual equivale al primer parámetro en la entrada.
    La entrada en la ilustración anterior es dividida como sigue:
    ParamList[0]=M
    ParamList[1]=60
    ParamList[2]=52
    ParamList[3]=0,5
  1. La etiqueta es integrada en el archivo XML resultante de la siguiente manera:
    <DIMENSION Size='M' Length='60' Width='52' Weight='0,5' />

Otro ejemplo:

    1
    Usted desea que la función de impresión sea configurable después de la finalización del pedido.
    La entrada PRINT activa la impresión con NONE no se imprime.
  1. Y que el cuadro de edición sea editable.
    1
    En (5) entre una etiqueta para conmutar la función de impresión.
    <CUSTOM_TAG label="ACTION_DEFINITION" editable="true">; [NONE|PRINT; Action to take place after knit is done]</CUSTOM_TAG>
  1. Al aplicar la plantilla, recibirá el siguiente cuadro de edición
  2. 2
    Referencie esta etiqueta (3), dado que proviene del grupo STOLL:TICKET\STOLL:PRODUCTION_INFO.
    3
    Inserte la macro AddTAG para separar el comentario [NONE|PRINT; Action to take place after knit is done], extraer el único parámetro y determinar el valor por defecto como NONE en caso de una entrada vacía.
    #AddTAG(" <STOLL:ACTION_DEFINITION>$ParamList[0]</STOLL:ACTION_DEFINITION>" $ACTION_DEFINITION "NONE")
  3. Si no entra nada en el campo ACTION_DEFINITION, se entrará "NONE" al generar el ticket en XML, porque la macro detecta que no fue entrado nada, pero existe un valor por defecto "NONE".
    Sin el valor por defecto, la etiqueta no estaría incluida en el ticket.
    En este caso, en el archivo XML resultante se entrará:
    <STOLL:ACTION_DEFINITION>NONE</STOLL:ACTION_DEFINITION>
  4. Si usted entra PRINT, el resultado en XML será:
    <STOLL:ACTION_DEFINITION>PRINT</STOLL:ACTION_DEFINITION>

Otro ejemplo para la integración de etiquetas de usuario:

  1. Usted desea agregar una etiqueta de usuario para que el usuario de la máquina p.ej. confirme si una actualización fue exitosa.
    1
    En (5) entre la siguiente etiqueta:
    <USER_TAG label="Update ok" editable="true"></USER_TAG>
  1. Las etiquetas de usuario son respaldadas por el PPS de forma implícita y esta etiqueta es escrita automáticamente en el archivo XML resultante, incluyendo la etiqueta de grupo: