共用方式為

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

  • 發行項

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

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

Team Foundation Server (TFS) 流程範本 可定義六個以上的工作項目類型。 在其中定義的類型和欄位是在分類、工作項目查詢與報表的定義中參考的。 因此，上傳 WIT 定義的工作必須在上傳分類、工作項目查詢與報表的工作之前成功完成。

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

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

定義 WIT

每個類型定義都必須在自己檔案的 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 項目參考和自訂工作追蹤物件以支援小組的流程。

指定要上傳的 WIT 定義

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

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

下列範例顯示如何指定建立下列 WIT 的工作：Bug、問題、共用步驟、工作、測試案例和使用者劇本。 由於數個 WIT 定義包含適用於 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\CodeReviewRequest.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\CodeReviewResponse.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Feature.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\FeedbackRequest.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\FeedbackResponse.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 項目的集合，其中每個項目都會指定一個要上傳的定義檔。

請參閱

參考

匯入、匯出和管理工作項目類型 [witadmin]

概念

所有 WITD XML 項目參考

使用工作項目追蹤外掛程式定義用於追蹤工作項目的物件

其他資源

修改或加入欄位以支援查詢、報表和工作流程