FIELD (定義) 項目
您可以使用 FIELD (定義) 項目來定義工作項目欄位，以及指定套用至該欄位的規則和條件。 您指派給欄位的屬性會決定該欄位出現在工作項目表單的方式，以及是否可以加入報表中。 您可以管理 Team 專案集合的欄位指派集合。 因此，您指派給定義於一個工作項目類型之欄位的屬性必須符合在集合中所有 Team 專案的所有工作項目類型。 此外，所有集合中的所有可列印欄位都可匯出到資料倉儲資料庫。
.gif "注意事項") 注意事項 |
|---|
如需 FIELD (工作流程) 項目 (在狀態變更或工作流程轉換期間用於指定欄位的規則和條件) 的詳細資訊，請參閱 FIELD (工作流程) 項目。 |
您可以使用 witadmin 命令工具，變更您對集合現有欄位所進行的屬性指派。 如需詳細資訊，請參閱管理工作項目欄位 [witadmin]。
結構描述階層架構
FIELD
<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>
<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" >
<ALLOWEDVALUES> . . . </ALLOWEDVALUES>
<ALLOWEXISTINGVALUE />
<CANNOTLOSEVALUE />
<COPY />
<DEFAULT />
<EMPTY />
<FROZEN />
<HELPTEXT> . . . </HELPTEXT>
<MATCH />
<NOTSAMEAS />
<PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
<READONLY />
<REQUIRED />
<SERVERDEFAULT />
<SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
<VALIDUSER />
<WHEN>> . . . </WHEN>
<WHENNOT> . . . </WHENNOT>
<WHENCHANGED> . . . </WHENCHANGED>
<WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>
屬性和項目
下列章節會說明屬性、子項目和父項目。
屬性
屬性 |
描述 |
|---|---|
name |
必要項。 出現在工作項目查詢下拉式功能表中的欄位易記名稱。 在定義於 Team 專案的所有欄位中，易記名稱必須是唯一的。 此外，易記名稱可能不同於工作項目表單上的欄位旁出現的標籤。 如需詳細資訊，請參閱Control XML 項目參考。 屬性型別為 typelib:FieldName。 最小長度：1；最大長度：128。 模式值： ^[^\ \[\]]+$ 模式值範例：指派給 |
refname |
必要項。 可將某個欄位從定義於 Team 專案集合的所有其他欄位中區別出來的唯一標籤。 如需了解其他需求和易記名稱與參考名稱的限制，請參閱工作項目追蹤物件的命名慣例。 屬性型別為 typelib:ReferenceFieldName。 最小長度：1；最大長度：70。 模式值：^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ 模式值範例：Company.IssueType |
type |
必要項。 指定此欄位所接受資料的型別。 注意事項
具有相同 reportingrefname 的不同專案集合中的欄位必須指派為相同的 type 值。如果值有差異，則可能在處理資料倉儲時發生資料衝突。如需詳細資訊，請參閱解決資料倉儲中發生的結構描述衝突。
下表列出這個屬性的有效值：
值使用方式
DateTime 根據國際標準時間 (UTC) 時間點來指定日期。
Double 指定浮點值。
GUID 指定要用來包含唯一識別項的欄位。
History
支援討論執行緒並會追蹤其他歷程資訊。
注意事項
System.History 欄位是唯一使用此資料型別的欄位。您無法使用這個資料型別來定義自訂欄位。
HTML 支援 RTF 資料的擷取，而且會在較長的文字說明使用，例如工作項目說明。
Integer 指定 32 位元帶正負號的整數值。
PlainText 支援輸入可以包含超過 255 個 Unicode 字元的文字字串。
String 支援輸入可以包含最多 255 個 Unicode 字元的文字字串。String 欄位適用於標籤，或其他最長只有一行的簡短文字字串。
TreePath
指定欄位，顯示在階層或樹狀目錄結構中的項目，例如需要什麼才能顯示產品的區域和反覆項目路徑。若要定義子節點，請參閱 建立和修改區域和反覆項目。
注意事項
System.AreaPath 和 System.IterationPath 欄位是唯一使用這個資料型別的欄位。您無法使用這個資料型別來定義自訂欄位。
|
syncnamechanges |
選擇項。 指定是否使用工作項目欄位，來儲存想要隨著 Active Directory 或某個工作群組中的變更而更新的名稱。 只有當 type="String" 時，此選項才有效。 屬性型別為 xs:boolean。 指定 true 可啟用資料欄位的同步處理，指定 false 可停用資料欄位的同步處理。 |
reportable |
選擇項。 指定欄位的資料是否可以加入報表中。 具有預設值 None 的欄位既不會被匯出至關聯式資料倉儲，也不會由 SQL Server Analysis Services Cube 處理。 如需可報告欄位的詳細資訊，請參閱加入和修改工作項目欄位以支援報告。 注意事項
具有相同 reportingrefname 值的不同專案集合中的欄位必須指派為相同的 reportable 值。如果值有差異，則可能在處理資料倉儲時發生資料衝突。如需詳細資訊，請參閱解決資料倉儲中發生的結構描述衝突。
下表列出這個屬性的有效值：
Value 使用方式
Detail 可以對屬於 DateTime、Double、Integer 或 String 型別的欄位指定。這個欄位中的資料會移入工作項目和目前工作項目資料表中的關聯式倉儲資料庫，但不會移入 Analysis Services Cube。這個型別是不受限制文字欄位的良好選擇，因為您可以在報表中使用它們，而且又能避免讓 Cube 變得過大。
Dimension 可以對屬於 DateTime、Double、Integer 或 String 型別的欄位指定。這個欄位中的資料會進入關聯式倉儲資料庫以及 Analysis Services Cube 成為工作項目維度的屬性，以便讓資料可用來篩選報表。請對具有有效值清單的欄位使用這個型別。Work Item Type 和 State 是 dimension 的良好範例。
Measure 只有在 Integer 和 Double 欄位時才使用 measure 型別。Measure 是報表中的數值。在處理 Analysis Services Cube 時，會在 reportable 屬性設定為 measure 的欄位上預先計算資料。例如，工作項目和目前的工作項目量值群組包含下列欄位的累積資料：[原始評估]、[剩餘時數] 和 [已完成的時數]。當您指定測量時，必須指定 formula 屬性。
None 當您不想使用要包含在報表中的欄位時，請指定 None。這是預設的指派。
|
formula |
選擇項。 measure 可報告型別的彙總 (Aggregation) 類型。 唯一有效的值是 sum，它會傳回整個集合中所有值的總和。 |
reportingname |
選擇項。 指定顯示在報表中的名稱。 如果您未指定值，則會使用指派給 name 屬性的值。 注意事項
具有相同 reportingrefname 的不同專案集合中的欄位必須指派為相同的 reportingname 值。如果值有差異，則可能在處理資料倉儲時發生資料衝突。如需詳細資訊，請參閱解決資料倉儲中發生的結構描述衝突。
屬性型別為 typelib:FieldName。 最小長度：1；最大長度：128。 模式值： ^[^\ \[\]]+$ 模式值範例：指派給 |
reportingrefname |
選擇項。 指定在處理可列印欄位時，會使用的參考名稱。 如果您未指定值，則會使用指派給 refname 屬性的值。 您可以使用這個屬性，合併或分離處理至資料倉儲的欄位。 若要合併兩個具有不相同參考名稱且定義於不同專案集合中的欄位，您可以將相同的 reportingrefname 指定給這兩個欄位。 若要分離有相同的參考名稱但定義於不同的專案集合中的兩個欄位，您可以指派不同的 reportingrefname 給每個欄位。 您應該盡可能合併欄位，將倉儲中的欄位數目減到最少，並保持不超過 1024 個可報告欄位數上限。 您可以使用合併欄位產生跨群組報表。 屬性型別為 typelib:ReferenceFieldName。 最小長度：1；最大長度：70。 模式值：^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ 模式值範例：Company.IssueType |
子項目
元素 |
描述 |
|---|---|
選擇項。 定義欄位的允許值清單。 允許的值是在工作項目表單和查詢產生器之欄位清單中可供選取的值。 您必須選取這些值的其中一個。 |
|
選擇項。 定義允許現有值的欄位。 這個項目允許使用已存在的欄位值，即使這些值無效也依然如此。 所有新的欄位值都必須有效。 |
|
選擇項。 將欄位定義成不能遺失值。 這個項目會保存目前的欄位值，並無法清除或設為空白。 |
|
選擇項。 指定另一個欄位，其中包含要複製到目前欄位中的值。 |
|
選擇項。 定義欄位的預設值。 |
|
選擇項。 將欄位定義成空白。 |
|
選擇項。 將欄位定義為凍結。 在認可變更之後，已凍結的欄位就不能變更為任何非空白的值。 不過，您可以手動清除欄位、儲存工作項目，然後指定不同的值。 |
|
選擇項。 定義顯示於欄位工具提示中的文字。 |
|
選擇項。 定義欄位值必須符合之欄位的模式。 |
|
選擇項。 指定另一個欄位，其值不能與目前欄位的值相同。 |
|
選擇項。 定義欄位的禁用值清單。 |
|
選擇項。 將欄位定義成唯讀。 |
|
選擇項。 將欄位定義成必要項。 |
|
選擇項。 指定將提供值給欄位的伺服器元件。 |
|
選擇項。 定義欄位的建議值清單。 建議的值是在工作項目表單和查詢產生器之欄位清單中可供選取的值。 除了清單中的值之外，您也可以輸入其他值。 |
|
選擇項。 指定允許值的清單只能包含系統的有效使用者。 |
|
選擇項。 當其他欄位擁有特定值時，指定要套用到目前欄位的一個或多個規則。 |
|
選擇項。 當特定欄位的值變更時，將一個或多個規則套用到目前欄位。 |
|
選擇項。 當其他欄位沒有特定值時，將一個或多個規則套用到目前欄位。 |
|
選擇項。 當特定欄位的值沒有變更時，將一個或多個規則套用到目前欄位。 |
父項目
元素 |
描述 |
|---|---|
必要項。 包含工作項目類型欄位的定義。 |
備註
FIELD (定義) 是 FIELDS (定義) 的必要子項目。
minOccurs="1"
您可以在相同的 Team 專案集合定義不超過 1024 個的工作項目欄位，並且可以在所有 Team 專案集合中將不超過 1024 個的欄位設定為可報告的。 如需詳細資訊，請參閱加入和修改工作項目欄位以支援報告。
| 注意事項 |
|---|
將現有欄位加入至不同工作項目類型時，會使用 reportable 屬性目前的值。 |
如需了解其他需求和欄位易記名稱與參考名稱的限制，請參閱工作項目追蹤物件的命名慣例。 如需如何將欄位標示為報告用途的詳細資訊，請參閱加入和修改工作項目欄位以支援報告。
您不能定義以 System. 前置詞開頭的自訂欄位。 您可以使用 Microsoft. 前置詞來定義欄位，不過，這種不建議使用這種作法，因為它可能會阻礙 Team Foundation Server 功能。
如需欄位工作項目追蹤物件的概觀，請參閱使用工作項目欄位。
如需為 Microsoft Solutions Framework (MSF) 和 Agile Software Development 5.0 版處理範本定義之所有系統和預先定義欄位的概觀，請參閱 Visual Studio ALM 的工作項目欄位參考。
欄位參考名稱無法重新命名。 您可以使用 witadmin 命令列工具列出欄位、 重新為欄位取一個易記名稱，以及變更欄位屬性。 如需詳細資訊，請參閱管理工作項目欄位 [witadmin]。
如需如何跨 Team 專案集合使用欄位的詳細資訊，請參閱解決資料倉儲中發生的結構描述衝突和加入和修改工作項目欄位以支援報告。
範例
<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
<HELPTEXT>Type of work involved</HELPTEXT>
<SUGGESTEDVALUES>
<LISTITEM value="Development"/>
<LISTITEM value="Testing"/>
<LISTITEM value="Requirements"/>
<LISTITEM value="Design"/>
<LISTITEM value="Deployment"/>
<LISTITEM value="Documentation"/>
</SUGGESTEDVALUES>
</FIELD>