使用工作項目追蹤外掛程式定義用於追蹤工作項目的物件
您可以使用工作項目追蹤的外掛程式,定義 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 |
|
WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。 指定檔案的路徑和名稱,這個檔案中包含要在處理 WorkItemTracking 外掛程式工作時上傳的分類定義。 |
FIELD |
|
WI 的必要子項目。 定義工作項目執行個體中的欄位值。 |
HYPERLINK |
|
WI 的選擇性子項目。 定義工作項目執行個體的超連結。 |
LINKTYPE |
|
LINKTYPES 的必要子項目。 指定檔案的路徑和名稱,這個檔案中包含要上傳的連結類型定義。 |
LINKTYPES |
|
WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。 包含 LINKTYPE 項目的集合,其中每個項目都會指定一個要上傳的定義檔。 |
Permission |
|
Query 的選擇性子項目。 指定指派給小組查詢的預設權限。 如需詳細資訊,請參閱指派工作項目查詢的權限。 |
Query |
|
QUERIES 的必要子項目。 指定 .wiq 檔案的名稱和路徑,這個檔案會定義要上傳的查詢。 |
QueryFolder |
|
QUERIES 的選擇性子項目。 指定查詢資料夾的名稱。 |
QUERIES |
|
WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。 指定要用來建立預設查詢的查詢定義檔。 |
WI |
|
WORKITEMS 的必要子項目。 定義要建立之工作項目的類型,以及要指派給特定欄位的值。 |
WORKITEMS |
|
WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。 包含 WI 項目的集合,其中每個項目各定義一個工作項目執行個體。 |
WORKITEMTYPE |
|
WORKITEMTYPES 的必要子項目。 指定檔案的路徑和名稱,這個檔案中包含要上傳的類型定義。 |
WORKITEMTYPES |
|
WorkItemTracking 外掛程式的必要子項目。 包含 WORKITEMTYPE 項目的集合,其中每個項目都會指定一個要上傳的定義檔。 |