Plantillas propias

Plantillas de pedidos estándar

Las plantillas de pedido suministradas por STOLL junto con el STOLL PPS (ver Administración de plantillas de pedidos, Plantillas de pedidos estándar y sus parámetros) permiten un rápido inicio en el uso de plantillas.

Una plantilla sirve para crear un ticket XML

Usted puede adaptar las plantillas a su caso de uso:

• quitando parámetros
• agregando parámetros
• preasignando parámetros
• Bloquear preasignaciones para modificaciones en la aplicación de la plantilla para impedir entradas incorrectas.
• Todo lo que figura en el XML de plantillas bajo TEMPLATE_TAGS sirve para generar cuadros de edición en el ticket.
• Todo lo que está contenido en los bloques CDATA es escrito en un archivo de ticket *.XML a través del mecanismo Velocity mediante los datos y con la ayuda de la macro AddTag.
• El mecanismo Velocity procesa cada línea de entrada en la plantilla independientemente de las líneas procesadas previamente y busca la referencia indicada en el XML de plantilla para reemplazarla por la entrada y escribir la línea en el ticket. Si la referencia está integrada en una macro, la macro es llamada para generar el resultado en el archivo XML.

Parámetros en las plantillas de pedidos estándar

En los parámetros en las plantillas de pedido estándar se encuentran diferentes formatos de entradas, las cuales tienen en común lo siguiente:

• El cuadro de edición para un parámetro generalmente contiene un comentario entre paréntesis rectos [ ]. Este comentario es quitado cuando el ticket es generado por la macro Velocity AddTag.
• El cuadro de edición para un parámetro puede ser utilizado para entrar varios componentes de parámetros.
• En este caso los mismos son separados por punto y coma (;). Para asistir al usuario, en un cuadro de comentario se pueden describir los diferentes componentes que se esperan.
• Para parámetros opcionales que no deben ser usados, el punto y coma debe ser conservado para mantener el orden de los parámetros. En el ejemplo se omitió el tercer parámetro. La mayoría de los parámetros no son opcionales y deben ser indicados a penas es completado tan solo un parámetro.
• Si no se realiza ninguna entrada, la etiqueta no es incluida en el pedido XML. Excepciones:
• Si se utiliza la macro Velocity AddTAG, es posible especificar valores predeterminados.
  Estos valores predeterminados son integrados en el ticket XML resultante si para este parámetro está previsto un cuadro de edición pero no fue entrado nada. (Por ejemplo IMAGE, LOGO o OP_AUTHENTICATION_NEEDED)
  Ejemplo:
  #AddTAG("<LOGO>$ParamList[0]</LOGO>" $LOGO "Templates/Logo.png")
• Si el cuadro de edición LOGO permanece vacío, a la etiqueta LOGO igualmente se le asignará Templates/Logo.png en el ticket.
• Si una línea en los bloques ORDER_VELOCITY y CUSTOM_VELOCITY no tiene ninguna indicación de referencia para un cuadro de entrada, la línea es enviada automáticamente al XML de ticket.
  Ejemplo:
  <STOLL:MACHINE_INFO>
    <STOLL:TC_LOAD_DATE/>
    <STOLL:TC_DONE_DATE/>
    <STOLL:DONE_EXECUTIONS/>
    <STOLL:TC_STATE/>
    <STOLL:PATTERN_NAME/>
    <STOLL:CURRENT_SHIFT/>
    <STOLL:USER_NAME/>
</STOLL:MACHINE_INFO>
• La macro AddTAG- Velocity que figura en la plantilla, permite la entrada de varios parámetros y del comentario en una línea.
• Cada bloque ORDER_VELOCITY y CUSTOM_VELOCITY con esto tiene su propia macro AddTAG-, que actualmente son idénticos.
• Tenga en cuenta que la entrada en general no debe contener caracteres de control XML como por ejemplo <>,. Si a pesar de ello necesita estos caracteres, existen alternativas como {}, o tendrá que convertir estos caracteres (Caracteres en XML).
• Si se aplica la macro, los datos de entrada además no deben contener ni ; ni [ ya que estos caracteres son considerados caracteres separadores por la macro AddTAG.
  En caso de ser necesario, usted puede modificar la macro en la plantilla o agregar una adicional que utilice otros caracteres separadores.
• En la siguiente tabla figuran como ejemplo tres parámetros TITLE, LOGO y DIMENSION de la plantilla Auto Production.
• Todos estos tienen un comentario.
• En el parámetro LOGO se trata de una ruta de archivo hacia un archivo de imagen. Puede ser indicado de forma absoluta o relativa al directorio template.
• El parámetro DIMENSION tiene los componentes Tamaño, Longitud, Anchura y Peso.