使用 WorkItemTracking 插件来定义和自定义用于跟踪工作项的对象

项目
08/12/2011

更新：2011 年 4 月

通过使用用于跟踪工作项的插件，可以定义用于跟踪工作的团队项目的初始对象。这些对象包括工作项类型、工作项查询、类别、链接类型、全局列表和工作项的实例。创建团队项目后，可使用 witadmin 命令行工具修改这些对象。

在插件文件中，指定一个或多个任务以及它们的依赖项。一般情况下，为每个主要上载活动指定一个任务，例如，链接类型、工作项类型、查询和类别。

重要事项
您必须按特定顺序指定上载文件和定义查询的任务：先是链接类型，再是工作项类型，最后是查询。这些对象的每个定义文件都依赖于其前面的任务中指定的定义。一般情况下，您应保留在您所自定义的过程模板中定义的任务顺序。有关更多信息，请参见在插件文件中定义任务组和任务的依赖项。

主题内容

工作项跟踪插件的名称和位置
工作项跟踪插件的语法结构
WorkItemTracking 插件的元素参考

有关可定义的每个对象类型的特定信息，请参见以下主题之一：

工作项跟踪插件的名称和位置

下表概述了 Microsoft Solutions Framework (MSF) 过程模板的文件的名称和位置以及插件名称。

文件名：	WorkItems.xml
文件位置：	“工作项跟踪”文件夹
插件名称：	Microsoft.ProjectCreationWizard.WorkItemTracking

提示

可以更改 XML 文件的名称和位置，但不能更改插件名称。 Visual Studio Team Foundation Server 并不包括用于部署客户端插件、策略或其他修改的机制。如果您希望部署此类功能，则必须使用您自己的分发和安装程序。

返回页首

工作项跟踪插件的语法结构

工作项跟踪的插件文件必须遵循 WorkItemMethodology.xsd 文件中定义的架构定义，并且必须在其自己的文件中指定插件。您可以从 Microsoft 网站上的以下页面下载过程模板的架构文件：Process Template and Work Item Schemas for Visual Studio Team Foundation（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 的必需子元素。为工作项实例中的字段定义值。
GLOBALLISTS	`<GLOBALLISTS fileName="GlobalListFilePathName" />`	WorkItemTracking 插件的 taskXml 元素的可选子元素。指定包含在处理 WorkItemTracking 插件任务时要上载的全局列表定义的文件的路径和名称。
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 元素的集合，其中的每个元素各指定一个要上载的定义文件。

返回页首

请参见

修订记录

日期	修订记录	原因
2011 年 4 月	添加了元素参考部分以及指向处理每个类型的跟踪对象的各个主题的链接。移除了指向已删除主题的链接。	信息补充。

2011 年 4 月

添加了元素参考部分以及指向处理每个类型的跟踪对象的各个主题的链接。移除了指向已删除主题的链接。

信息补充。

通过

使用 WorkItemTracking 插件来定义和自定义用于跟踪工作项的对象

工作项跟踪插件的名称和位置

工作项跟踪插件的语法结构

WorkItemTracking 插件的元素参考

请参见

任务

概念

其他资源

修订记录

其他资源