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.
- La macro AddTAG sirve en el área de entrada del usuario al utilizar la plantilla de pedido para:
- El análisis del cuadro de edición
- La distribución de parámetros en la etiqueta y sus atributos.
- La utilización de una indicación de entrada como ayuda para el cuadro de edición que simplifica la aplicación (tiene que aparecer entre paréntesis rectos)
- La entrada de varios datos en una línea
(Los datos deben estar separados por punto y coma) - La utilización opcional de parámetros predeterminados si no fue entrado nada
- No generar ningún resultado XML, si no fue entrado nada
- La macro tiene el formato:
AddTAG $TAG $Param $Default - Etiqueta
$TAG
XML incluyendo los atributos necesarios $Param
Entrega en este lugar el string completo de entrada que es procesado por la macro.$Default
opcional
Indica el valor que es utilizado cuando el cuadro de edición correspondiente permanece sin completar.
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:
- Usted desea entrar una etiqueta para definir la indicación de tamaño y peso de una pieza de tisaje.
- 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>
- Al aplicar la plantilla, recibirá el siguiente cuadro de edición (sin M;60...)
- 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)
- 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
- 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.
- 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>
- Al aplicar la plantilla, recibirá el siguiente cuadro de edición
- 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")
- 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>
- 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:
- 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
<USER_TAG label="Update ok" editable="true"></USER_TAG>
- 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:
-
<STOLL:OPERATOR_INFO>
-
<STOLL:USER_TAGS>
-
<STOLL:USER_TAG Index="0" Label="Update Ok" /> </STOLL:USER_TAGS>
-
</STOLL:OPERATOR_INFO>