向过程模板添加链接类型定义

Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018

可以定义团队成员可以在项目的工作项之间创建的其他链接类型。 链接类型定义控制该类型工作项之间的关系或链接的标签和规则。 您指定的链接类型是对分层链接、依赖链接和相关链接的默认类型的补充。

可以在单独的文件中为每个链接类型指定定义文件,也可以将它们全部指定在一个文件中。 然后将条目添加到 WorkItemTracking 插件 的 taskxml 元素,以便上传每个定义文件。

默认进程模板定义工作项类型 (WIT) 定义引用的多个链接类型。 除了系统定义的链接类型之外,这些链接类型也存在。 有关详细信息,请参阅 LinkTypes

链接的类型定义必须在工作项的类型定义之前上载。 有关详细信息,请参阅 定义任务组和任务的依赖项

创建项目后,可以使用 witadmin 命令行工具添加、删除、重命名和更改项目集合的链接类型。 有关详细信息,请参阅 “管理链接类型”。

使用 LinkType 元素指定链接类型。

以下示例显示了定义 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" />  

以下示例演示如何指定一个任务,该任务创建在敏捷流程模板中定义的两种类型的链接。 这些类型对应于 SharedStepTestedBy 链接类型。

<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 LINKTYPES 的必需子元素。指定要上传的链接类型定义的文件的路径和名称。
<LINKTYPE fileName="LinkTypeFilePathName" />
LINKTYPES WorkItemTracking 插件的可选子元素。 包含 一个 LINKTYPE 元素的集合,每个元素指定要上传的定义文件。
<LINKTYPES>
<LINKTYPE /> . . .
</LINKTYPES>