基于列表的 XML 版本控制文件格式
用于定义基于列表的版本控制方案的 XML 文件必须符合以下格式：
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "myListSeries">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
</scheme>
<scheme>
<series name = "myListSeries">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
</scheme>
 |
必须具有以下各项：
• 至少一个系列
• 每个系列至少两个 value 元素
基于列表的方案不需要种子，但基于状态的方案需要种子。
|
在 XML 文件中，序列名称可包含除句点 (.) 或 "at" 符号 (@) 以外的任意字母数字字符。在 XML 文件中指定的序列名称也必须附加到 wt.series.HarvardSeries，才能组成在版本控制规则内容自变量中使用的名称。例如，如果序列名为 "myListSeries"，则要包括的自变量为 "wt.series.HarvardSeries.myListSeries"。
有关其他信息，请参见objrules/ObjRuleObjectVersioning.html。
加载 XML 文件时，会根据定义的 XSD 验证输入架构。在 <value> 元素中包含的值可以是受以下条件限制的任意唯一值的集合：
• 值不能为空；其至少应包含一个非空白字符。
• 不能在值中使用句点 (.)。
• 值前后的任何空白会在使用该值前被移除。
• 为修订版本标签指定的值必须在整个系列中保持唯一，不允许多次指定相同的值；不过，可以将某个系列中的值用于另一系列中。
 |
建议尽可能减少值中使用的字符数，这样完整的对象标识符不会显得过于冗长。
|
文件中值的顺序决定当修订对象时，值作为版本指定符使用的顺序。
|
|
如果修订方案，请确保不要移除任何已使用的值。另外，在系列已使用后从中移除系列名称或值会导致任何使用该系列或系列值的现有对象出现问题。例如，这些对象无法修订并且对象小版本历史记录也无法显示。有关如何允许已不存在于版本控制方案中的字符出现在现有对象的修订版本标签中的信息，请参阅容纳修订版本标签中的继承值。
|
要加载的 XML 文件中只能包含一个方案。该方案可能包含多个系列。当文件中含有多个序列时，每个序列名称必须是唯一的。例如，下面的 XML 文件定义了两个序列:
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name="name1">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
<series name="name2">
<value>A_1</value>
<value>A_3</value>
<value>A_5</value>
<value>A_7</value>
</series>
</scheme>
<scheme>
<series name="name1">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
<series name="name2">
<value>A_1</value>
<value>A_3</value>
<value>A_5</value>
<value>A_7</value>
</series>
</scheme>
没有加载将版本控制设置为基于列表的版本控制 (在本节中定义) 的预设对象初始化规则，也没有使用基于列表的版本控制的预设生命周期模板。