清單型版本化 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>
並未載入現成的物件初始化規則將版本化設為本節所定義的清單型版本化，此外也沒有使用清單型版本化的現成生命週期範本。