VarDef 標籤語法

適用於某規則的 XML 文件可含有一個或多個 VarDef 標籤。請一律將 VarDef 標籤置於 AttributeValues 標籤內。

每個 VarDef 標籤都會定義稍後可以使用 VarRef 標籤在規則中參考的變數名稱及其值。在您參考變數 (使用 VarRef 標籤) 時可用的變數定義由適當的物件類型及前後關聯階層決定。如需規則如何使用這些階層的詳細資訊，請參閱合併規則以建立複合規則。

例如，假設您在網站前後關聯中定義了變數，該網站前後關聯可以在針對 wt.doc.WTDocument 物件類型定義的規則中使用。然後，此定義可以用於針對 wt.doc.WTDocument 物件類型及其所有子類型定義的規則的所有前後關聯。如果要將規則套用至其中的物件在子前後關聯或與子類型相關聯，則網站的子前後關聯中或與 wt.doc.WTDocument 的子類型相關聯的相同變數的定義通常會優先於網站前後關聯中的定義。

在處理參考變數的規則元素之前，不會計算變數的值。欲參考透過 VarDef 標籤定義的特定變數，請於 VarRef 標籤的 id 屬性中使用在 VarDef 標籤的 id 屬性中所指定的值。當套用具有特定變數參考的規則時，處理的第一個元素會導致計算及快取變數的值。然後快取值會用於在規則套用期間處理的變數的每個參考。

VarDef 標籤語法如下所示：

其中 variable_name 是參考 VarRef 標籤中的變數時使用的變數名稱。名稱可以由對您有意義的任何有效 XML 名稱組成。

下列範例定義了 GeneratedNumber 變數，此變數可以用來生成文件的編號，以便您可以將文件的名稱設定為生成編號。您可以透過將 XML 嵌入 wt.doc.WTDocument 物件類型的 AttributeValues 標籤內，來定義此變數以在建立文件時使用：

<VarDef id="GeneratedNumber"
algorithm=”com.ptc.windchill.enterprise.revisionControlled.server.impl.NumberGenerator">
<Arg>{GEN:wt.enterprise.SequenceGenerator:WTDOCUMENTID_seq:10:0}</Arg>
</VarDef>

在 VarDef 標籤中定義的變數值不能從以相同規則對其他值進行的計算中衍生而來。例如，您無法從 AttrValue 標籤以相同規則設定的編號屬性值中定義 WTPart 的 GeneratedNumber 變數。如需詳細資訊，請參閱變數。