將工作項目的類型定義加入至流程範本

發行項
08/12/2011

更新：2011 年 4 月

您針對流程範本所定義的工作項目類型會為開發產品及其功能的所有追蹤、監視和報告提供基礎。工作項目類型會針對 Team 專案中追蹤的工作項目，定義資料欄位、工作流程以及工作項目表單。工作項目的類型包括錯誤 (bug)、使用者本文和工作。您可以先自訂類型定義以新增欄位、變更工作流程，或修改工作項目表單。此外，您也可以從流程範本新增或移除工作項目的類型。

您可以針對數個工作項目，將流程範本的類型定義指定為 WorkItemTracking 外掛程式中的工作。此工作是必要的，因為工作項目類型支援追蹤和報告工作。您要指定每個類型定義在 taskXml 項目中上傳。 Test Management、Reports 以及 Portal 的外掛程式相依於是否成功上傳工作項目的類型定義。

重要事項
Microsoft Solutions Framework (MSF) v5.0 的流程範本會定義六種以上的工作項目類型。在其中定義的類型和欄位是在分類、工作項目查詢與報表的定義中參考的。因此，上傳工作項目類型之類型定義的工作必須在上傳分類、工作項目查詢與報表的工作之前成功完成。此外，上傳連結類型之定義檔的工作必須在上傳工作項目之類型定義的工作之前完成。如需詳細資訊，請參閱在外掛程式檔案中定義工作群組和工作的相依性。

Microsoft Solutions Framework (MSF) v5.0 的流程範本會定義六種以上的工作項目類型。在其中定義的類型和欄位是在分類、工作項目查詢與報表的定義中參考的。因此，上傳工作項目類型之類型定義的工作必須在上傳分類、工作項目查詢與報表的工作之前成功完成。

此外，上傳連結類型之定義檔的工作必須在上傳工作項目之類型定義的工作之前完成。如需詳細資訊，請參閱在外掛程式檔案中定義工作群組和工作的相依性。

本主題內容

定義工作項目的類型
指定要上傳之工作項目的類型定義
WORKITEMTYPES 項目參考

使用流程範本建立 Team 專案之後，您可以使用 witadmin 命令列工具新增、移除、重新命名以及變更工作項目的類型定義。如需詳細資訊，請參閱自訂和管理工作項目類型 [witadmin]。

定義工作項目的類型

每個類型定義都必須在自己檔案的 WITD 容器項目中指定。每個定義也必須符合在 workitemtypedefinition-02.xsd 及 workitemtypedefinition-02.xsd 檔案中定義之工作項目類型的結構描述定義。您可以從 Microsoft 網站的下列頁面下載用於追蹤工作項目的結構描述檔案：Visual Studio Team Foundation 的流程範本和工作項目結構描述 (英文)。

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

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

您可以在 TypeDefinitions 資料夾中自訂或建立類型定義檔。如需如何定義工作項目類型的詳細資訊，請參閱所有 WITD XML 項目參考和自訂專案追蹤資料、表單、工作流程和其他物件。

回到頁首

指定要上傳之工作項目的類型定義

若要上傳流程範本中的工作項目類型定義，您可以指定 WORKITEMTYPE 項目。 filename 屬性是指類型定義檔的相對路徑。例如，下列語法會指定即將上傳 Bug.xml 檔案。

<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\filename.xml"/>

以下範示範明如何指定工作，以建立 Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 的流程範本中的全部六種工作項目類型。這些類型會對應至下列類型的工作項目：錯誤 (bug)、問題、共用步驟、工作、測試案例以及使用者本文。由於數個工作項目的類型定義包含適用於 TestedBy 連結類型的篩選，因此 LinkTypes 工作必須在可以完成 WITs 工作之前完成。

<task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
   <dependencies>
      <dependency taskId="LinkTypes" />
   </dependencies>
   <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
      </WORKITEMTYPES>
   </taskXml>
</task>

回到頁首

WORKITEMTYPES 項目參考

下表描述您用來上傳工作項目之類型定義的項目。您可以在 WorkItemTracking 外掛程式檔案的 taskXml 容器項目中指定這些項目。

注意事項
您可以使用 WORKITEMTYPE (WorkItemTracking) 項目指定要上傳的類型定義檔。您可以使用 WORKITEMTYPE (WITD) 項目指定要定義之類型的名稱。如需詳細資訊，請參閱所有 WITD XML 項目參考。

項目	語法	描述
WORKITEMTYPE	`<WORKITEMTYPE fileName="WITFilePathName" />`	WORKITEMTYPES 的必要子項目。指定檔案的路徑和名稱，這個檔案中包含要上傳的類型定義。
WORKITEMTYPES	`<WORKITEMTYPES> <WORKITEMTYPE /> . . . </WORKITEMTYPES>`	WorkItemTracking 外掛程式的必要子項目。包含 WORKITEMTYPE 項目的集合，其中每個項目都會指定一個要上傳的定義檔。

項目

語法

描述

WORKITEMTYPE

<WORKITEMTYPE fileName="WITFilePathName" />

WORKITEMTYPES 的必要子項目。

指定檔案的路徑和名稱，這個檔案中包含要上傳的類型定義。

WORKITEMTYPES

<WORKITEMTYPES> 
    <WORKITEMTYPE />
 . . .
</WORKITEMTYPES>

WorkItemTracking 外掛程式的必要子項目。

包含 WORKITEMTYPE 項目的集合，其中每個項目都會指定一個要上傳的定義檔。

回到頁首

請參閱

變更記錄

日期	記錄	原因
2011 年 4 月	已加入每個 WORKITEMTYPES 項目的描述。已移除指向已刪除之主題的連結。	資訊加強。

2011 年 4 月

已加入每個 WORKITEMTYPES 項目的描述。已移除指向已刪除之主題的連結。

資訊加強。

共用方式為

將工作項目的類型定義加入至流程範本

定義工作項目的類型

指定要上傳之工作項目的類型定義

WORKITEMTYPES 項目參考

請參閱

參考

概念

其他資源

變更記錄

其他資源