共用方式為


FIELD 項目 (WORKITEMTYPE 項目)

更新:2007 年 11 月

定義工作項目欄位,並指定套用至此欄位的規則和條件。

結構描述階層架構

WITD 項目 (工作項目類型定義結構描述)

    WORKITEMTYPE 項目 (工作項目類型定義結構描述)

        FIELDS 項目 (WORKITEMTYPE 項目)

            FIELD 項目 (WORKITEMTYPE 項目)

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

屬性和項目

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

屬性

描述

name

必要 FieldDefinition 屬性。

套用這些規則和條件之欄位的顯示名稱。如需詳細資訊,請參閱欄位名稱

refname

必要 FieldDefinition 屬性。

套用這些規則和條件之欄位的參考名稱。此參考名稱必須符合欄位定義之 FIELD 項目中定義的參考名稱。如需詳細資訊,請參閱欄位參考名稱

type

必要 FieldDefinition 屬性。

欄位接受的值型別。如需詳細資訊,請參閱欄位類型

reportable

選擇性的 FieldDefinition 屬性。

欄位的資料將匯出至資料倉儲,而且可以包含在報告中。如需詳細資訊,請參閱將欄位用於報告

formula

選擇性的 FieldDefinition 屬性。

measure 可報告型別的彙總 (Aggregation) 類型。目前,sum 是唯一支援 measure 的彙總類型。如需詳細資訊,請參閱 witfields

子項目

項目

說明

HELPTEXT 項目 (工作項目類型定義結構描述)

選擇性項目

定義顯示於欄位工具提示中的文字。

REQUIRED 項目 (工作項目類型定義結構描述)

選擇性項目

將欄位定義成必要項。

READONLY 項目 (工作項目類型定義結構描述)

選擇性項目

將欄位定義成唯讀。

EMPTY 項目 (工作項目類型定義結構描述)

選擇性項目

將欄位定義成空白。

FROZEN 項目 (工作項目類型定義結構描述)

選擇性項目。

將欄位定義為凍結。在認可變更之後,已凍結的欄位就不能變更為任何非空白的值。不過,您可以手動清除欄位、儲存工作項目,然後指定不同的值。

CANNOTLOSEVALUE 項目 (工作項目類型定義結構描述)

選擇性項目。

將欄位定義成不能遺失值。這表示在目前的欄位取得值之後,就不能清除它或讓它變成空白。

NOTSAMEAS 項目 (工作項目類型定義結構描述)

選擇性項目

將另一個欄位指定成值,而且此值不能與目前欄位的值相同。

VALIDUSER 項目 (工作項目類型定義結構描述)

選擇性項目。

指定允許值的清單只能包含系統的有效使用者。

ALLOWEXISTINGVALUE 項目 (工作項目類型定義結構描述)

選擇性項目。

將欄位定義成允許現有的值。這表示可以接受已經存在的欄位值,即使這些值無效也一樣。所有新的欄位值都必須有效。

MATCH 項目 (工作項目類型定義結構描述)

選擇性項目

定義欄位值必須符合之欄位的模式。

ALLOWEDVALUES 項目 (工作項目類型定義結構描述)

選擇性項目

定義欄位的允許值清單。允許的值是在工作項目表單和查詢產生器之欄位清單中可供選取的值。您必須選取這些值的其中一個。

SUGGESTEDVALUES 項目 (工作項目類型定義結構描述)

選擇性項目

定義欄位的建議值清單。建議的值是在工作項目表單和查詢產生器之欄位清單中可供選取的值。除了清單中的值之外,您也可以輸入其他值。

PROHIBITEDVALUES 項目 (工作項目類型定義結構描述)

選擇性項目

定義欄位的禁用值清單。

DEFAULT 項目 (工作項目類型定義結構描述)

選擇性項目

定義欄位的預設值。

COPY 項目 (工作項目類型定義結構描述)

選擇性項目

指定另一個欄位,其中包含要複製到目前欄位中的值。

SERVERDEFAULT 項目 (工作項目類型定義結構描述)

選擇性項目

指定將提供值給欄位的伺服器元件。

WHEN 項目 (工作項目類型定義結構描述)

選擇性項目

當其他欄位擁有特定值時,指定要套用到目前欄位的一個或多個規則。

WHENNOT 項目 (工作項目類型定義結構描述)

選擇性項目

當其他欄位沒有特定值時,將一個或多個規則套用到目前欄位。

WHENCHANGED 項目 (工作項目類型定義結構描述)

選擇性項目

當特定欄位的值變更時,將一個或多個規則套用到目前欄位。

WHENNOTCHANGED 項目 (工作項目類型定義結構描述)

選擇性項目

當特定欄位的值沒有變更時,將一個或多個規則套用到目前欄位。

父項目

項目

說明

FIELDS 項目 (WORKITEMTYPE 項目)

必要項目。

包含工作項目類型欄位定義。

備註

FIELD 是 FIELDS 的必要子項目。

minOccurs="1"

maxOccurs="unbounded"

範例

<FIELD name="field display name" refname="field reference name" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath" reportable="Dimension | Detail | Measure" formula="sum">
    <HELPTEXT>…</HELPTEXT>
    <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>…</WHEN>
    <WHENNOT>…</WHENNOT>
    <WHENCHANGED>…</WHENCHANGED>
    <WHENNOTCHANGED>…</WHENNOTCHANGED>
</FIELD>

項目資訊

命名空間

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

結構描述名稱

工作項目類型定義

驗證檔

WorkItemTypeDefinition.xsd

項目型別

FieldDefinition 複雜型別 (WORKITEMTYPE 項目)

可以是空白

請參閱

參考

HELPTEXT 項目 (工作項目類型定義結構描述)

其他資源

工作項目類型定義結構描述

定義工作項目類型欄位