WHEN 項目 (工作項目類型定義結構描述)
更新：2007 年 11 月
指定在什麼條件下要將一或多項規則套用到目前的欄位。當其他欄位包含特定值時，此規則會套用到目前欄位。父項目定義了目前的欄位。
<xs:element name="WHEN" type="FieldValueCondition"/>
屬性和項目
下列章節將說明定義 WHEN 項目的屬性和子項目。它們也將說明用來定義如何套用 WHEN 項目的父項目。您至少必須定義一個子項目。
屬性
屬性 |
描述 |
|---|---|
field |
必要屬性。 識別必須有指定值的欄位，以使此項目中的規則套用到目前欄位。 您可以依照欄位參考名稱指定這個屬性。如需參考名稱的詳細資訊，請參閱 FIELD 項目 (WORKITEMTYPE 項目)。 |
value |
必要屬性。 指定 field 屬性所識別之欄位必須具備的值，以使此項目中的規則套用到目前欄位。 |
子項目
項目 |
說明 |
|---|---|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，目前欄位 (包含 WHEN 項目的欄位) 必須包含值。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，目前欄位是唯讀的。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，目前欄位不能包含值。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，會凍結目前欄位。在認可變更之後，已凍結的欄位就不能變更為任何非空白的值。不過，您可以手動清除欄位、儲存工作項目，然後指定不同的值。 |
|
選擇性項目。 指定當 field 屬性識別之欄位的值沒有變更時，在目前的欄位取得值之後，就不能清除它或讓它變成空白。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位有指定值時，目前欄位的值不能與第三個欄位的值相符。您可以在 NOTSAMEAS 項目中指定第三個欄位。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，允許值的清單只能包含系統的有效使用者。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，即使目前欄位已存在的值違反其他規則，也允許使用該值。如果目前欄位的值已變更，這個項目就不適用。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，目前欄位的值必須符合指定模式。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，目前欄位的值必須來自指定的值清單。允許的值是在工作項目表單和查詢產生器之欄位清單中可供選取的值。您必須選取這些值的其中一個。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，指定的清單包含目前欄位的建議值。建議的值是在工作項目表單和查詢產生器之欄位清單中可供選取的值。除了清單中的值之外，您也可以輸入其他值。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，目前欄位不能包含此清單內的任何值。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，這個項目會指定目前欄位的預設值。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，會自動將第三個欄位的值複製到目前欄位。您可以在 COPY 項目中指定第三個欄位。 |
|
選擇性項目。 指定當 field 屬性所識別的欄位具有指定值時，目前欄位使用來自指定的伺服器元件的值。伺服器元件為 [clock] 和 [currentuser]，前者是工作項目更新的時間，而後者則是更新工作項目的識別。 |
父項目
項目 |
說明 |
|---|---|
必要項目。 參考工作項目欄位定義，以及套用至此欄位的規則和條件。此參考是以父 FIELDS 項目屬於其子系的 STATE、TRANSITION、DEFAULTREASON 或 REASON 項目為基礎。 |
|
必要項目。 定義工作項目欄位，並指定套用至此欄位的規則和條件。 |
備註
WHEN 是 FIELD (工作項目類型定義結構描述) 和 FIELD (WORKITEMTYPE 項目) 的選擇性子項目。
範例
<WHEN field="field reference name" value="value">
<REQUIRED>…</REQUIRED>
<READONLY>…</READONLY>
<EMPTY>…</EMPTY>
<FROZEN>…</FROZEN>
<CANNOTLOSEVALUE>…</CANNOTLOSEVALUE>
<NOTSAMEAS>…</NOTSAMEAS>
<VALIDUSER>…</VALIDUSER>
<ALLOWEXISTINGVALUE>…<ALLOWEXISTINGVALUE>
<MATCH>…</MATCH>
<ALLOWEDVALUES>…</ALLOWEDVALUES>
<SUGGESTEDVALUES>…</SUGGESTEDVALUES>
<PROHIBITEDVALUES>…</PROHIBITEDVALUES>
<DEFAULT>…</DEFAULT>
<COPY>…</COPY>
<SERVERDEFAULT>…</SERVERDEFAULT>
</WHEN>
項目資訊
命名空間 |
https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef |
結構描述名稱 |
工作項目類型定義 |
驗證檔 |
WorkItemTypeDefinition.xsd |
項目型別 |
|
可以是空白 |
否 |