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

项目
06/09/2015

通过使用用于跟踪工作项的插件，可定义用于跟踪工作的团队项目初始对象。这些对象包括工作项的类型、工作项查询、类别、链接类型和工作项的实例。创建团队项目之后，可以使用 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	`<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 的可选子元素。指定分配给团队查询的默认权限。有关详细信息，请参阅为工作项查询分配权限。
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 元素的集合，其中的每个元素各指定一个要上载的定义文件。

请参见

概念

自定义过程模板

自定义工作跟踪对象以支持团队的进程

过程模板文件概述

通过

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

插件名和位置

工作项跟踪插件语法结构

元素参考

请参见

概念

其他资源