自己的模板

默认订单模板

STOLL随STOLL PPS一起提供的订单模板（见订单模板管理，默认订单模板及其参数）可帮助您快速掌握模板的使用方法。

模板用来创建一个XML工票。

您可以根据具体应用情况调整模板，可通过如下方式：

• 移除参数
• 添加参数
• 预设参数
• 锁定模板的预设，以防止不正确的输入。
• 在模板XML里TEMPLATE_TAGS下的所有内容是用来在工票里创建编辑框的。
• 包含在 CDATA 段的所有内容都通过 Velocity 机制，借助输入的数据和 AddTag 宏，写入*.XML工票文件。
• Velocity 机制对模板中的每个条目行进行处理，不管之前处理的行，在XML模板中搜索指定的引用，用输入的内容来替代，并在工票中写入行。如果引用被整合到一个宏里，那么可以调用这个宏来创建 XML 文件中的输出。

默认订单模板的参数

默认订单模板的参数有几种不同的输入格式，具有以下共同点：

• 参数的编辑框通常包含一个注释，位于括号[]内。当工票是由 Velocity 宏 AddTag 创建时，这个注释会被移除。
• 参数编辑框可用于记录多个参数元素。
• 在这种情况下，参数元素之间由分号（;）分隔。可以在注释字段描述希望哪些单个元素。
• 对于那些不使用的可选参数，应该保留分号，以保持参数的排列顺序。在示例中，第三个参数被省略。大多数参数不是可选填的，只要一个参数被填写就必须指定这些参数。
• 如果没有输入，标签将不会包括在XML订单里。例外:
• 您可以使用 Velocity AddTAG 宏来预设默认值。
  如果有用来输入这个参数的编辑框，且未输入任何内容，这些默认值包含在结果 XML 工票里。（例如：IMAGE、LOGO或OP_AUTHENTICATION_NEEDED）
  示例:
  #AddTAG("<LOGO>$ParamList[0]</LOGO>" $LOGO "Templates/Logo.png")
• 如果编辑框 LOGO 为空白，在工票中 LOGO 选项卡将会取 Templates/Logo.png。
• 如果ORDER_VELOCITY和CUSTOM_VELOCITY区块中的一行没有对编辑框的引用设置，则该行将自动输入到工票XML中。
  示例:
  <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>
• 模板中提到的 Velocity AddTAG- 宏可以在一行中输入几个参数和注释。
• 每个 ORDER_VELOCITY 和 CUSTOM_VELOCITY 区块都有各自的AddTAG-宏，但目前这些宏是不相同的。
• 注意，条目不能包括任何 XML 控制符，如<>,。如果确实需要使用这类控制符，可以用{},替代，或者转换字符（XML 中的特殊字符）
• 如果应用了宏，输入数据中不能包含任何;或[符号，因为这些字符会被AddTAG宏认为是分隔符。
  如果必要，可以在模板里修改宏，或者添加另一个使用其他分隔符的宏。
• 下表是默认Auto Production模板的三个示例参数 TITLE、LOGO和DIMENSION。
• 所有参数都有一个注释。
• LOGO 参数是一个到图像文件的路径。这个参数可以是绝对或相对地指向template目录。
• DIMENSION参数包含四个元素，分别为尺码、长度、宽度、重量。