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

發行項
06/09/2015

您可以使用工作項目追蹤的外掛程式，定義 Team 專案中要追蹤工作的初始物件。這些物件包括工作項目類型、工作項目查詢、分類、連結類型和工作項目執行個體。建立 Team 專案之後，您可以使用 witadmin 命令列工具來修改這些物件。

在外掛程式檔案中，您可以指定一個或多個工作及其相依性。一般而言，您可以為每個主要上傳活動指定一個工作，例如連結類型、工作項目類型、查詢和分類。

重要

您必須依特定順序指定上傳檔案及定義查詢的工作：首先是連結類型，然後是工作項目類型，再來是查詢。這些物件的每個定義檔會相依於前一個工作中所指定的定義。一般而言，您應該維護在所要自訂之流程範本中定義的工作順序。如需詳細資訊，請參閱在外掛程式檔案中定義工作群組和工作的相依性。

外掛程式名稱和位置

下表摘要說明 Microsoft Solutions Framework (MSF) 之流程範本檔案的名稱和位置，以及外掛程式的名稱。

檔案名稱：	WorkItems.xml
檔案位置：	WorkItem Tracking 資料夾
外掛程式名稱：	Microsoft.ProjectCreationWizard.WorkItemTracking

注意事項
您可以變更 XML 檔的名稱和位置，但無法變更外掛程式的名稱。Visual Studio Team Foundation Server 並未包含部署用戶端外掛程式、原則或其他修改的機制。如果您想要部署這種功能，就必須使用您自己的散發與安裝程式。

如需可定義之每個物件類型的特定資訊，請參閱下列主題：

工作項目追蹤外掛程式語法結構

工作項目追蹤的外掛程式檔案必須符合 WorkItemMethodology.xsd 檔案中定義的結構描述定義，而且外掛程式必須在自己的檔案中指定。您可以從 Microsoft 網站的下列頁面下載流程範本的結構描述檔案：Visual Studio Team Foundation 的流程範本和工作項目結構描述。

下列語法顯示 WorkItemTracking 外掛程式的高階結構。共指定四個工作，分別上傳連結類型、工作項目類型、查詢和分類的定義。如果您要加入定義工作項目執行個體，您可以為每個工作指定一個額外的工作。

如需每個項目的描述，請參閱本主題稍後的項目參考。

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE />
   . . . 
      </LINKTYPES>
    </taskXml>
  </task>
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE />
   . . . 
      </WORKITEMTYPES>
    </taskXml>
  </task>
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission />
   . . . 
        <QueryFolder >
          <Query />
   . . . 
        </QueryFolder>
   . . . 
      </QUERIES>
    </taskXml>
  </task>
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
    </taskXml>
  </task>
</tasks>

項目參考

下表說明您用來上傳工作項目追蹤物件的項目。您可以在 WorkItemTracking 外掛程式檔案的 taskXml 容器項目中指定這些項目。如需工作、相依性和 taskXml 項目的相關資訊，請參閱定義要處理外掛程式的工作。

項目	語法	描述
CATEGORIES	`<CATEGORIES fileName="CategoriesFilePathName" />`	WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。指定檔案的路徑和名稱，這個檔案中包含要在處理 WorkItemTracking 外掛程式工作時上傳的分類定義。
FIELD	`<FIELD refname="FieldReferenceName" value="Value" />`	WI 的必要子項目。定義工作項目執行個體中的欄位值。
HYPERLINK	`<HYPERLINK URL="URL" relativePath="false" />`	WI 的選擇性子項目。定義工作項目執行個體的超連結。
LINKTYPE	`<LINKTYPE fileName="LinkTypeFilePathName" />`	LINKTYPES 的必要子項目。指定檔案的路徑和名稱，這個檔案中包含要上傳的連結類型定義。
LINKTYPES	`<LINKTYPES> <LINKTYPE /> . . . </LINKTYPES>`	WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。包含 LINKTYPE 項目的集合，其中每個項目都會指定一個要上傳的定義檔。
Permission	`<permission allow="ListOfPermissions" identity="GroupName" />`	Query 的選擇性子項目。指定指派給小組查詢的預設權限。如需詳細資訊，請參閱指派工作項目查詢的權限。
Query	`<Query name="QueryName" fileName="QueryFilePathName" />`	QUERIES 的必要子項目。指定 .wiq 檔案的名稱和路徑，這個檔案會定義要上傳的查詢。
QueryFolder	`<QueryFolder name=" FolderName ">`	QUERIES 的選擇性子項目。指定查詢資料夾的名稱。
QUERIES	`<QUERIES> . . . </QUERIES>`	WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。指定要用來建立預設查詢的查詢定義檔。
WI	`<WI type="WorkItemType"> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI>`	WORKITEMS 的必要子項目。定義要建立之工作項目的類型，以及要指派給特定欄位的值。
WORKITEMS	`WORKITEMS> <WI> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI> </WORKITEMS >`	WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。包含 WI 項目的集合，其中每個項目各定義一個工作項目執行個體。
WORKITEMTYPE	`<WORKITEMTYPE fileName="WITFilePathName" />`	WORKITEMTYPES 的必要子項目。指定檔案的路徑和名稱，這個檔案中包含要上傳的類型定義。
WORKITEMTYPES	`<WORKITEMTYPES> <WORKITEMTYPE /> . . . </WORKITEMTYPES>`	WorkItemTracking 外掛程式的必要子項目。包含 WORKITEMTYPE 項目的集合，其中每個項目都會指定一個要上傳的定義檔。

請參閱

概念

自訂流程範本

自訂工作追蹤物件以支援小組的流程

流程範本檔概觀

共用方式為

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

外掛程式名稱和位置

工作項目追蹤外掛程式語法結構

項目參考

請參閱

概念

其他資源