工票模板方案的结构

<?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>

解释

在 (3) 和 (4)，可以插入宏 AddTAG。

应用订单模板时，在用户输入区的 AddTAG 宏用于以下目的：

分析编辑框
将参数分发到标记及其属性，
在编辑框中使用条目注释作为帮助，这简化了使用（必须位于方括号之间）
在一行中输入多个数据
（数据之间必须由分号隔开）
如果未输入任何内容时选择使用默认参数
如果未输入任何内容，则不创建一个 XML 输出。

宏的格式为：
AddTAG $TAG $Param $Default

$TAGXML 标签包含所需属性
$Param 在该点传送由宏处理的完整条目字符串
$Default可选
指定如果对应编辑框保持空白时要使用的值

过程：

1: 输入模板名称，这个名称显示在模板选择列表里。

2: 添加标签到这个标签组 PRODUCTION_INFO，这些标签包含预分配的数据，并且默认出现在PPS 的订单编辑器的编辑框里。

3: 在这个区域添加来自 STOLL:TICKET 组的标签，STOLL:CUSTOM 标签除外。这里，您可以使用 AddTAG 宏。

4: 在这个区域添加来自 STOLL:CUSTOM 组的标签。这里，您可以使用 AddTAG 宏。

5: 在这里定义所需要的引用 STOLL:TICKET 和 STOLL:CUSTOM 标签的输入框。

示例：

您想输入一个标签来确定一个织片的尺码规格和重量。
编辑框必须为可编辑。

1: 在位置 (5) 输入下列字符串。
<CUSTOM_TAG label=" DIMENSION" editable="true">;;;; [Size;Length;Width;Weight; of knit]</CUSTOM_TAG>

应用模板时，会出现以下输入框（不含M; 60 ...）

2: 此标签来自 STOLL:CUSTOM 标签名称区域，因此需要在 (4) 中引用。为此，插入 AddTAG 宏，将注释（[编织物的尺码，长度，宽度]）分隔开来，并且分配参数。
#AddTAG(" <DIMENSION Size='$ParamList[0]' Length='$ParamList[1]' Width='$ParamList[2]' Weight='$ParamList[3]' />" $DIMENSION)

标签有 4 个·参数用来确定织片的尺码和重量，这些参数要分发给 4 个属性。可以使用 ParamList[N] 来分发参数，其中 N 从 0 开始计数，对应于条目中的第一个参数。
上面的图片中的条目分为以下几部分：
ParamList[0]=M ParamList[1]=60 ParamList[2]=52 ParamList[3]=0,5

在生成的 XML 文件中，标签的结构如下：<DIMENSION Size='M' Length='60' Width='52' Weight='0,5' />

另一个例子：

1: 您希望在订单完成之后可以使用打印功能。
PRINT 条目激活打印机，NONE 不打印。

编辑框必须为可编辑。

1: 在 (5) 处输入一个标记，用来切换打印功能。
<CUSTOM_TAG label="ACTION_DEFINITION" editable="true">; [NONE|PRINT; Action to take place after knit is done]</CUSTOM_TAG>

应用模板时，会出现以下编辑框

2: 在 (3) 引用这个标签，因为标签来自 STOLL:TICKET\STOLL:PRODUCTION_INFO 组。

3: 插入 AddTAG 宏，用来分开 [NONE|PRINT; Action to take place after knit is done] 注释，用来提取单个参数，当条目为空时用来将默认设置为NONE。
#AddTAG(" <STOLL:ACTION_DEFINITION>$ParamList[0]</STOLL:ACTION_DEFINITION>" $ACTION_DEFINITION "NONE")

如果在 ACTION_DEFINITION 字段不输入任何内容，则在生成工票时 “NONE” 将被输入到XML 文件里。宏监测到未输入任何内容，但有默认值“NONE”。
无默认值，标签将不会包含在工票中。
因此，生成的XML文件将包含：
<STOLL:ACTION_DEFINITION>NONE</STOLL:ACTION_DEFINITION>
如果输入 PRINT，在 XML 文件里的输出将为：
<STOLL:ACTION_DEFINITION>PRINT</STOLL:ACTION_DEFINITION>

嵌入用户标签的另一个示例：

您要为机器用户添加一个用户标签，以确认更新是否成功

1: 在 (5) 位置输入这个标签：
<USER_TAG label="Update ok" editable="true"></USER_TAG>

用户标签由 PPS 隐性支持，此标签自动写入到生成的包含组标签的 XML文件中：

<STOLL:OPERATOR_INFO>
<STOLL:USER_TAGS>
<STOLL:USER_TAG Index="0" Label="Update Ok" /> </STOLL:USER_TAGS>
</STOLL:OPERATOR_INFO>