FIELD (定義) 項目參考

發行項
07/08/2015

您可以使用 FIELD (定義) 項目來定義工作項目欄位，以及指定套用至該欄位的規則和條件。您指派給欄位的屬性會決定其資料類型，以及是否可以加入報表中。

注意事項
如需 FIELD (工作流程) 項目 (在狀態變更或工作流程轉換期間用於指定欄位的規則和條件) 的詳細資訊，請參閱 FIELD (工作流程) 項目。

結構描述階層架構

WITD

WORKITEMTYPE

FIELDS

FIELD

<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、Integer、String 或 TreePath 類型的欄位指定。這個欄位中的資料會進入關聯式倉儲資料庫以及 Analysis Services Cube 成為工作項目維度的屬性，以便讓資料可用來篩選報表。請對具有有效值清單的欄位使用這個類型。 Work Item Type 和 State 是 dimension 的良好範例。
Measure	只有 Integer 和 Double 欄位才使用 measure 類型。 Measure 是報表中的數值。在處理 Analysis Services Cube 時，會在 reportable 屬性設定為 measure 的欄位上預先計算資料。例如，工作項目和目前的工作項目量值群組包含下列欄位的累積資料：[原始評估]、[剩餘時數] 和 [已完成的時數]。當您指定 measure 時，也必須指定 formula 屬性。
None	當您不想使用要加入報表中的欄位時，請指定 None。這是預設的指派。

formula

選擇項。 measure 可報告類型的彙總類型。唯一有效的值是 sum，它會傳回整個集合中所有值的總和。

reportingname

選擇項。指定顯示在報表中的名稱。如果您未指定值，則會使用指派給 name 屬性的值。

注意事項
具有相同 reportingrefname 的不同專案集合中的欄位，必須指派為相同的 reportingname 值。如果值不同，則可能在處理資料倉儲時發生資料衝突。如需詳細資訊，請參閱解決資料倉儲中發生的結構描述衝突。

屬性類型為 typelib:FieldName。最小長度：1；最大長度：128。

模式值：^[^\. \[\]]+$

模式值範例：指派給

reportingrefname

選擇項。指定在處理可報告欄位時使用的參考名稱。如果您未指定值，則會使用指派給 refname 屬性的值。

您可以使用這個屬性，合併或分離在資料倉儲中處理的欄位。若要合併具有不同參考名稱且在不同的專案集合中定義的兩個欄位，您可以指派相同的 reportingrefname 給這兩個欄位。若要分離有相同的參考名稱但定義於不同的專案集合中的兩個欄位，您可以指派不同的 reportingrefname 給每個欄位。

您應該盡可能合併欄位，將倉儲中的欄位數目減到最少，並保持不超過 1024 個可報告欄位數上限。您可以使用合併欄位產生跨群組報表。