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

项目
03/12/2013

通过使用用于跟踪工作项的插件，可以定义用于跟踪工作的团队项目的初始对象。这些对象包括工作项、工作项查询、类别、工作项链接类型和实例的类型。创建团队项目后，可使用 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 的必需子元素。为工作项实例中的字段定义值。
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 的可选子元素。指定分配给团队查询的默认权限。有关更多信息，请参见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 插件的元素参考

请参见

概念

其他资源