链接类型的参考指南

• 工作链接类型：链接工作项，包括选择测试用例管理工作项
• 超链接：将工作项连接到任何 URL 或网络共享
• 外部链接类型：将工作项连接到外部对象，例如代码对象、生成或 Wiki 页面
• 远程工作链接类型：连接在不同组织中定义的工作项
• GitHub 链接类型：将工作项关联到 GitHub 仓库提交、问题或拉取请求。

特定字段维护前四个链接类型的链接计数，例如 相关链接计数、 超链接计数、 外部链接计数和 远程链接计数。

• 工作链接类型：链接工作项，包括某些测试用例管理工作项
• 超链接：将工作项连接到任何 URL 或网络共享
• 外部链接类型：将工作项连接到外部对象，例如代码对象、生成或 Wiki 页面
• GitHub 链接类型：将工作项连接到 GitHub 存储库提交或拉取请求。

特定字段维护前三个链接类型的链接计数，例如 相关链接计数、 超链接计数和 外部链接计数。

下表描述了可以使用 WorkItemLinksFilter XML 元素指定的工作项链接类型来限定链接控件的范围。

下表描述了从工作项或测试用例添加链接时可以选择的外部链接类型。

下表描述了从工作项或测试用例添加链接时可以选择的外部链接类型。 还可以指定以下链接类型之一，以使用 ExternalLinksFilter XML 元素限定链接控件的范围。

GitHub 链接类型

GitHub 链接类型是系统定义的，并将工作项链接到 GitHub 对象，如下所示。

下表描述了从工作项添加链接时可以选择的 GitHub 链接类型。

远程工作链接类型

远程工作链接类型支持链接不同组织中定义的工作项，只要相同的Microsoft Entra ID 管理这些组织（请参阅“ 将组织连接到Microsoft Entra ID”。

工作项的 远程链接计数 等于使用远程工作链接类型定义的所有链接的总和。

自定义链接类型

创建自定义链接类型、导出和导入链接类型定义，以及删除、激活、停用或重新激活自定义链接类型。 请参阅：

• 链接类型元素引用
• 管理链接类型 （witadmin） 。

az boards 工作项关系 列表类型

使用 az boards work-item relation list-type 命令或 工作项关系类型 - 列表 REST API 列出组织支持的链接类型。 有关详细信息，请参阅 Azure DevOps CLI 入门。

az boards work-item relation list-type [--org]

可选参数

• org：Azure DevOps 组织 URL。 可以使用az devops configure -d organization=ORG_URL配置默认组织。 如果未配置为默认或使用 选取 git config，则为必需。 示例：--org https://dev.azure.com/MyOrganizationName/。

示例：

以下命令以表格形式列出为 fabrikam 组织定义的工作项链接类型。

az boards work-item relation list-type --org fabrikam --output table
Name                  ReferenceName                                                Enabled    Usage
--------------------  -----------------------------------------------------------  ---------  ------------
Produces For          System.LinkTypes.Remote.Dependency-Forward                   True       workItemLink
Consumes From         System.LinkTypes.Remote.Dependency-Reverse                   True       workItemLink
Duplicate             System.LinkTypes.Duplicate-Forward                           True       workItemLink
Duplicate Of          System.LinkTypes.Duplicate-Reverse                           True       workItemLink
Referenced By         Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward  True       workItemLink
References            Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse  True       workItemLink
Tested By             Microsoft.VSTS.Common.TestedBy-Forward                       True       workItemLink
Tests                 Microsoft.VSTS.Common.TestedBy-Reverse                       True       workItemLink
Test Case             Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward       True       workItemLink
Shared Steps          Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse       True       workItemLink
Successor             System.LinkTypes.Dependency-Forward                          True       workItemLink
Predecessor           System.LinkTypes.Dependency-Reverse                          True       workItemLink
Child                 System.LinkTypes.Hierarchy-Forward                           True       workItemLink
Parent                System.LinkTypes.Hierarchy-Reverse                           True       workItemLink
Related               System.LinkTypes.Related                                     True       workItemLink
Remote Related        System.LinkTypes.Remote.Related                              True       workItemLink
Attached File         AttachedFile                                                 True       resourceLink
Hyperlink             Hyperlink                                                    True       resourceLink
Artifact Link         ArtifactLink                                                 True       resourceLink

默认 json 格式提供有关为链接类型定义的属性的其他信息。 例如，链接类型“生产目的”和“使用来源”的信息按如下方式列出。

  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": true,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Produces For",
    "referenceName": "System.LinkTypes.Remote.Dependency-Forward",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
  },
  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": false,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Consumes From",
    "referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
  },