共用方式為


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

您可以使用追蹤工作項目的外掛程式,定義 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 項目的集合,其中每個項目都會指定一個要上傳的定義檔。

回到頁首

請參閱

概念

自訂流程範本

逐步自訂流程

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

使用流程範本檔案

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