向过程模板添加工作项链接的类型定义

项目
08/12/2011

您可以定义团队成员可在团队项目的工作项之间创建的其他类型的链接。链接类型将定义标签和规则，以便控制该类型的工作项之间的关系或链接。您指定的链接类型是对分层链接、依赖链接和相关链接的默认类型的补充。您可以在单独文件中为每种类型的链接指定定义文件，或者也可以在一个文件中指定所有这些链接。然后，您可以指定要在 WorkItemTracking 插件的 taskxml 元素中上载的定义文件。

重要事项
Microsoft Solutions Framework (MSF) v5.0 的过程模板定义了两种类型的链接，这些链接在多种类型的工作项的定义中引用。链接的类型定义必须在工作项的类型定义之前上载。有关更多信息，请参见在插件文件中定义任务组和任务的依赖项。

主题内容

定义链接类型
指定要上载的链接类型定义
LINKTYPES 元素参考

创建团队项目后，您可以使用 witadmin 命令行工具添加、移除、重命名和更改团队项目集合的链接类型。有关更多信息，请参见自定义和管理链接类型 [witadmin]。

定义链接类型

必须使用 LinkType 元素指定每个链接类型定义。此外，每个定义还必须符合 workitemlinktypedefinition-01.xsd 文件中所定义的链接类型的架构定义。您可以从 Microsoft 网站上的以下页面下载用于跟踪工作的架构文件：Process Template and Work Item Schemas for Visual Studio Team Foundation（Visual Studio Team Foundation 的过程模板和工作项架构）。

下面的示例演示了定义 TestedBy 链接类型的语法结构。

<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
  <LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>

可在 LinkTypes 文件夹中自定义或创建链接类型的定义文件。有关如何定义链接类型的更多信息，请参见自定义如何通过链接类型关联工作项。

返回页首

指定要上载的链接类型定义

若要在过程模板中上载链接类型，请在 taskxml 元素中指定 LINKTYPE 元素。 filename 特性是链接类型的定义文件的相对路径。例如，以下语法指定将上载的 TestedBy.xml 文件。

<LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />

下面的示例演示了如何指定一个任务，以便创建在 MSF for Agile Software Development v5.0 的过程模板中定义的两种链接类型。这些类型与 SharedStep 和 TestedBy 链接类型对应。

<task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
   <taskXml>
      <LINKTYPES>
         <LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedStep.xml" />
         <LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
      </LINKTYPES>
   </taskXml>
</task>

返回页首

LINKTYPES 元素参考

下表介绍用于上载链接类型的元素。在 WorkItemTracking 插件文件中的 taskXml 容器元素内指定这些元素。

提示

可以使用 LINKTYPE (WorkItemTracking) 元素指定用于定义要上载的链接类型的文件。可以使用 LinkType (Definition) 元素指定要定义的链接类型的名称。有关更多信息，请参见使用链接类型。

元素	语法	说明
LINKTYPE	`<LINKTYPE fileName="LinkTypeFilePathName" />`	LINKTYPES 的必需子元素。指定包含要上载的链接类型定义的文件的路径和名称。
LINKTYPES	`<LINKTYPES> <LINKTYPE /> . . . </LINKTYPES>`	WorkItemTracking 插件的可选子元素。包含 LINKTYPE 元素的集合，其中的每个元素各指定一个要上载的定义文件。

元素

语法

说明

LINKTYPE

<LINKTYPE fileName="LinkTypeFilePathName" />

LINKTYPES 的必需子元素。

指定包含要上载的链接类型定义的文件的路径和名称。

LINKTYPES

<LINKTYPES>
     <LINKTYPE />
 . . .
</LINKTYPES>

WorkItemTracking 插件的可选子元素。

包含 LINKTYPE 元素的集合，其中的每个元素各指定一个要上载的定义文件。

返回页首

请参见

参考

自定义和管理链接类型 [witadmin]

其他资源

自定义如何通过链接类型关联工作项

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