所有 WITD XML 項目參考

發行項
08/12/2011

更新：2011 年 1 月

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

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

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

本主題內容

WITD 語法結構
WITD 子項目
流程範本工作項目類型

WITD 語法結構

下列範例示範工作項目類型的高階結構。

<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 項目會在工作項目類型定義的最高層級上出現在 WORKITEMTYPE 標記之間。您要經由提供名稱與描述來開始定義工作項目類型，此外，還要使用某些標準 XML 標記來包裝工作項目類型定義。

WITD 子項目

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

項目	說明
WITD	完整的工作項目類型定義是由 WITD 標記所包裝。您可以使用任何名稱做為應用程式名稱； version 會識別工作項目類型從某一版本變更為下一版本的結構描述，請使用 "1.0"。 `<WITD application="Work item type editor" version="1.0 [1]"> <WORKITEMTYPE> . . .</WORKITEMTYPE> </WITD>`
WORKITEMTYPE	工作項目類型名稱在特定 Team 專案中必須是唯一的名稱。在執行階段，您會使用這個項目所指定的名稱。例如，此名稱可能會顯示為功能表選項。在本案例中，使用者可以按一下 [新增工作項目] 功能表上的 [Bug]。 `<WORKITEMTYPE name="WorkItemTypeName"> <DESCRIPTION>Text</DESCRIPTION> <GLOBALLISTS> . . .</</GLOBALLISTS> <FIELDS> . . . </FIELDS> <WORKFLOW> . . . </WORKFLOW> <FORM> . . .</</FORM> </WORKITEMTYPE>`
DESCRIPTION	指定字串，其中描述您要定義的工作項目類型。描述應該能協助任何自訂工作項目類型的使用者。注意事項您只能在 XML 定義中檢視這項描述，而無法在使用者介面的任何位置看到這項描述，它和 System.Definition 欄位沒有任何關係。 `<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>` 您可以指定文字字串，其中描述要定義的工作項目類型。
GLOBALLISTS	包含工作項目類型所使用的全域清單定義。您可以使用全域清單，讓 Team 專案集合中的多個工作項目類型共用清單項目。使用全域清單可以讓維護工作和跨群組共同作業變得更輕鬆。 `<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>` 如需詳細資訊，請參閱定義全域清單。
FIELDS	包含工作項目類型所使用的一組欄位定義。在 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>` 如需詳細資訊，請參閱設計和自訂工作項目表單。

流程範本工作項目類型

有兩組流程範本工作項目類型定義可供您使用，這兩組定義分別對應至針對 Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 和 MSF for Capability Maturity Model Integration (CMMI) Software Development v5.0 所定義的工作項目類型定義。這些檔案分別位於下列位置的安裝目錄中：

Drive:\Program Files\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfAgile\Template.zip
Drive:\Program Files\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfFormal\Template.zip

您可以在 Template.zip 檔的 WorkItem Tracking\TypeDefinitions 資料夾中找到工作項目類型定義。例如，MSF for Agile Software Development v5.0 定義下列每種工作項目類型的 XML 檔：Bug、問題、共用步驟、工作、測試案例和使用者本文。如需其中每種工作項目類型的詳細資訊，請參閱 MSF for Agile Software Development v5.0。

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