所有 WITD XML 項目參考

發行項
06/09/2015

您可以自訂現有的工作項目類型 (WIT) 或建立 WIT 以符合專案追蹤需求。 WIT 會定義將追蹤之 Team 專案工作項目 (例如 Bug、需求或風險) 的規則、欄位、狀態和轉換。

WIT 不能是空的。每一個 WIT 定義中的根項目都是 WITD 項目，該項目只能定義一個 WORKITEMTYPE 項目。每個 WIT 的名稱在 Team 專案內都必須是唯一的，而且每個類型名稱的長度不得超過 254 個 Unicode 字元。如需詳細資訊，請參閱工作項目追蹤物件的命名慣例。

要自訂或建立 WIT 定義檔，您可以修正類型定義 XML 檔。您可以維護及管理每個 Team 專案的工作項目類型定義。

WITD 語法結構

下列範例顯示 WIT 定義的高階結構。

<WITD application="work item type editor" version="1.0">
    <WORKITEMTYPE name="bug">
        <DESCRIPTION>Bug work item types are used to track defects in the code.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</WITD>

有少數 XML 項目會在 WIT 定義的最高層級出現在 WORKITEMTYPE 標記之間。您可藉由提供名稱與描述開始定義 WIT，也可使用某些標準 XML 標記來包裝 WIT 定義。

WITD 子項目

下表說明上述範例所使用的結構項目：

項目

描述

WITD

完整的 WIT 定義是由 WITD 標記所包裝。您可以使用任何名稱做為應用程式名稱； version 會識別工作項目類型從某一版本變更為下一版本的結構描述，請使用 "1.0"。

<WITD application="Work item type editor" version="1.0 [1]">
   <WORKITEMTYPE> . . .</WORKITEMTYPE>
</WITD>

WORKITEMTYPE

WIT 的名稱在特定 Team 專案中必須是唯一的名稱。在執行階段，您會使用這個項目所指定的名稱。例如，此名稱可能會顯示為功能表選項。在本案例中，使用者可以選擇 [新增工作項目] 功能表的 [Bug]。

<WORKITEMTYPE name="WorkItemTypeName">
    <DESCRIPTION>Text</DESCRIPTION>
    <GLOBALLISTS> . . .</</GLOBALLISTS>
    <FIELDS> . . . </FIELDS>
    <WORKFLOW> . . . </WORKFLOW>
    <FORM> . . .</</FORM>
</WORKITEMTYPE>

DESCRIPTION

指定字串，其中描述您要定義的工作項目類型。描述應該能協助任何自訂 WIT 使用者。

注意事項
您只能在 XML 定義中檢視這項描述，而無法在使用者介面的任何位置看到這項描述，它和 System.Definition 欄位沒有任何關係。

<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>

您可以指定文字字串，其中描述要定義的工作項目類型。

GLOBALLISTS

包含工作項目類型所使用的全域清單定義。您可以使用全域清單，讓 Team 專案集合中的多個工作項目類型共用清單項目。使用全域清單可以讓維護工作和跨群組共同作業變得更輕鬆。

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

如需詳細資訊，請參閱定義全域清單。

FIELDS

包含 WIT 所使用的一組欄位定義。在 FIELDS 項目內，您可以定義要用於追蹤工作項目類型之資料的所有欄位。這包括您要用於執行查詢和產生報表的欄位。

<FIELDS>
   <FIELD> . . . </FIELD>
</FIELDS>

如需詳細資訊，請參閱定義和修改工作項目欄位。

WORKFLOW

包含定義工作流程的一組 STATE 和 TRANSITION 項目。工作流程是狀態之間的一組有效轉換以及與每一個轉換有關的特定條件。

<WORKFLOW>
   <STATES> . . . </STATES>
   <TRANSITIONS> . . . </TRANSITIONS>
</WORKFLOW>

如需詳細資訊，請參閱變更工作項目類型的工作流程。

FORM

包含 LAYOUT、CONTROL、GROUP、TAB、TABGROUP、SPLITTER 和其他項目，其作用為定義表單上出現的欄位和控制項，以及這些項目在表單的顯示方式。

<FORM>
   <Layout> . . . </Layout>
</FORM>

如需詳細資訊，請參閱設計工作項目表單。

流程範本工作項目類型

TFS 提供三個預設流程範本。這些檔案位於下列目錄：

%programfiles%/Microsoft Team Foundation Server 12.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

您可以在 WorkItem Tracking\TypeDefinitions 資料夾中找到工作項目類型定義。如需詳細資訊，請參閱使用 Team 專案成品，選擇流程範本。

您可以在 TypeDefinitions 資料夾中自訂或建立類型定義檔。然後，您可以將新的工作項目類型匯入至單一專案，也可以將它加入至流程範本並將修改的範本上載至 Team Foundation Server。如需詳細資訊，請參閱將工作項目的類型定義加入至流程範本。

共用方式為

所有 WITD XML 項目參考

WITD 語法結構

WITD 子項目

流程範本工作項目類型

請參閱

概念

其他資源

其他資源