檔案型版本化 XML 檔案的格式
所載入供檔案型版本化使用的 XML 檔案必須具有下列格式:
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "name1">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
</scheme>
|
您的 XML 檔案中必須至少具有兩個 value 元素。
|
在 XML 檔案中,序列名稱可以包含句點 (.) 或 at 符號 (@) 以外的任何英數字元。您在 XML 檔案中指定的序列名稱是您也必須附加到 wt.series.HarvardSeries 的名稱,以構成供版本化規則內容的引數使用的名稱。例如,如果序列名稱是 "name1",則要包含的引數就是 "wt.series.HarvardSeries.name1"。有關其他資訊,請參閱
物件版本化。
<value> 元素中包含的值可以是符合下列資格的任何一組具唯一性值:
• 每個值可以指定的字元數目沒有上限;不過,如果您的值過長,完整物件名稱可能會超過顯示它的使用者介面欄位。
• 值不能為空;值至少必須含有一個非空格的字元。
• 值不可以包括 wt.properties wt.series.HarvardSeries.delimiter 屬性中定義的序列分隔符。預設序列分隔符為英文句點 (.)。
• 使用值前,必須移除值前後的所有空格。
• 您為版本修訂標籤指定的值在整個序列裡必須具唯一性,不允許您多次指定相同的值;不過,您可以使用其他序列中的值。
這些值在檔案中的順序決定修訂物件版本時,這些值作為版本指示符的順序。
|
若您要修訂配置,確保請勿移除使用中的任何值。此外,若在序列使用中的情況下將序列名稱或值從序列中移除,會導致使用該序列或序列值的所有現有物件發生問題。例如,無法修訂這些物件,或是無法顯示物件版序記錄。有關如何在現有物件的版本修訂標籤中使用已不再存在於版本化配置中的字元的資訊,請參閱 在版本修訂標籤中包含繼承值。
|
您只能載入一個 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>
並未載入現成的物件初始化規則將版本化設為本節所定義的檔案型版本化,此外也沒有使用檔案型版本化的現成生命週期範本。