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

發行項
03/12/2013

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

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

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

本主題內容

WorkItemTracking 外掛程式名稱和位置
WorkItemTracking 外掛程式語法結構
WorkItemTracking 外掛程式的項目參考

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

WorkItemTracking 外掛程式名稱和位置

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

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

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

回到頁首

WorkItemTracking 外掛程式語法結構

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

下列語法顯示 WorkItemTracking 外掛程式的高階結構。系統會指定四個工作，分別是上傳連結類型的定義、工作項目類型、查詢以及分類。如果您要將定義工作項目執行個體，則為每個會指定額外的工作。

如需每個項目的描述，請參閱本主體稍後的 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 外掛程式的項目參考

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

元素	語法	描述
CATEGORIES	`<CATEGORIES fileName="CategoriesFilePathName" />`	用於 WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。指定檔案的路徑和名稱，這個檔案中包含要在處理 WorkItemTracking 外掛程式工作時上傳的分類定義。
FIELD	`<FIELD refname="FieldReferenceName" value="Value" />`	WI 的必要子項目。為工作項目執行個體中的欄位定義值。
HYPERLINK	`<HYPERLINK URL="URL" relativePath="false" />`	WI 的選擇性子項目。定義工作項目執行個體的超連結 (Hyperlink)。
LINKTYPE	`<LINKTYPE fileName="LinkTypeFilePathName" />`	LINKTYPES 的必要子項目。指定檔案的路徑和名稱，這個檔案中包含要上傳的連結類型定義。
LINKTYPES	`<LINKTYPES> <LINKTYPE /> . . . </LINKTYPES>`	用於 WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。包含 LINKTYPE 項目的集合，其中每個項目都會指定一個要上傳的定義檔。
Permission	`<permission allow="ListOfPermissions" identity="GroupName" />`	Query 的選擇性子項目。指定指派給小組查詢的預設權限。如需詳細資訊，請參閱Assigning Permissions for Work Item Queries。
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 項目的集合，其中每個項目都會指定一個要上傳的定義檔。

回到頁首

請參閱

概念

自訂流程範本

逐步自訂流程

自訂專案追蹤資料、表單、工作流程和其他物件

使用流程範本檔案

在流程範本中自訂功能區域

共用方式為

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

WorkItemTracking 外掛程式名稱和位置

WorkItemTracking 外掛程式語法結構

WorkItemTracking 外掛程式的項目參考

請參閱

概念

其他資源