Guía de referencia para los tipos de vínculo usados en Azure DevOps y Azure Boards

En la tabla siguiente se describen los tipos de vínculo externos que puede elegir al agregar un tipo de vínculo desde un elemento de trabajo o un caso de prueba.

En la tabla siguiente se describen los tipos de vínculo externos que puede elegir al agregar un tipo de vínculo desde un elemento de trabajo o un caso de prueba. Además, puede especificar uno de estos tipos de vínculo para establecer el ámbito de un control de vínculos mediante el elemento XML ExternalLinksFilter.

En la tabla siguiente se describen los tipos de vínculo externos que puede elegir al agregar un tipo de vínculo desde un elemento de trabajo o un caso de prueba. Además, puede especificar uno de estos tipos de vínculo para establecer el ámbito de un control de vínculos mediante el elemento XML ExternalLinksFilter.

GitHub tipos de vínculo

GitHub tipos de vínculo son tipos de vínculo definidos por el sistema. Admiten la vinculación de elementos de trabajo GitHub objetos como se muestra en la siguiente imagen.

En la tabla siguiente se describen los GitHub de vínculo que puede elegir al agregar un tipo de vínculo desde un elemento de trabajo.

Tipos de vínculos de trabajo remoto

Los tipos de vínculos de trabajo remotos son tipos de vínculos definidos por el sistema que admiten la vinculación de elementos de trabajo definidos en distintas organizaciones. Las organizaciones deben estar administradas por el mismo Azure Active Directory como se describe en Conectar su organización para Azure Active Directory.

El recuento de vínculos remotos de un elemento de trabajo corresponde a la suma de todos los vínculos definidos con un tipo de vínculo de trabajo remoto.

Tipos de vínculo personalizados

Puede crear tipos de vínculos personalizados, exportar e importar definiciones de tipos de vínculos y eliminar, activar, desactivar y reactivar tipos de vínculos. Vea los artículos siguientes:

• Referencia del elemento de tipo de vínculo
• Administrar tipos de vínculos (witadmin)

az boards work-item relation list-type

Puede enumerar los tipos de vínculo admitidos por su organización con el comando az boards work-item relationlist-type o el comando Work Item Relation Types - List REST API. Para empezar, consulte Introducción a la CLI Azure DevOps.

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

Parámetros opcionales

• org:dirección URL Azure DevOps organización. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL . Obligatorio si no está configurado como predeterminado o se selecciona mediante git config . Ejemplo: --org https://dev.azure.com/MyOrganizationName/.

Ejemplo

El siguiente comando enumera los tipos de vínculo de elemento de trabajo en formato de tabla definidos para la organización fabrikam. Para otros formatos, consulte Formatos de salida para CLI de Azure comandos.

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

El formato JSON predeterminado proporciona información adicional sobre los atributos definidos para los tipos de vínculo. Por ejemplo, la información de los tipos de vínculo Produce Para y Consume From se muestra a continuación.

  {
    "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"
  },

witadmin listlinktypes

Puede enumerar los tipos de vínculos admitidos para la colección de proyectos mediante la herramienta de línea de comandos witadmin listlinktypes o el comando de la API REST Tipos de relación de elementos de trabajo: lista.

Aquí se enumeran los tipos de vínculo para la colección predeterminada fabrikam-sever:

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection

Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True

• Tipos de vínculos de trabajo:vincula elementos de trabajo, incluidos los elementos de trabajo de administración de casos de prueba seleccionados
• Hipervínculo:conecta un elemento de trabajo a cualquier dirección URL o recurso compartido de red
• Tipos de vínculo externos:conecta un elemento de trabajo a un objeto externo, como un objeto de código, una compilación o una página wiki.
• Tipos de vínculos de trabajoremotos: conecta elementos de trabajo definidos en distintas organizaciones
• GitHub de vínculo:conecta un elemento de trabajo a una confirmación, un problema o una solicitud de extracción GitHub repositorio.

Un campo específico mantiene un recuento de vínculos para los cuatro primeros tipos de vínculos, como Recuentode vínculos relacionados,Recuento de hipervínculos, Recuento de vínculos externos y Recuento de vínculos remotos.

• Tipos de vínculos de trabajo:vincula elementos de trabajo, incluidos los elementos de trabajo de administración de casos de prueba seleccionados
• Hipervínculo:conecta un elemento de trabajo a cualquier dirección URL o recurso compartido de red
• Tipos de vínculo externos:conecta un elemento de trabajo a un objeto externo, como un objeto de código, una compilación o una página wiki.
• GitHub tipos de vínculo:conecta un elemento de trabajo a una confirmación GitHub o solicitud de extracción del repositorio.

Un campo específico mantiene un recuento de vínculos para los tres primeros tipos de vínculos, como Recuentode vínculos relacionados,Recuento de hipervínculos y Recuento de vínculos externos.

• Tipos de vínculos de trabajo:vincula elementos de trabajo, incluidos los elementos de trabajo de administración de casos de prueba seleccionados
• Hipervínculo:conecta un elemento de trabajo a cualquier dirección URL o recurso compartido de red
• Tipos de vínculo externos:conecta un elemento de trabajo a un objeto externo, como un objeto de código, una compilación o un guión gráfico.

Un campo específico mantiene un recuento de vínculos para cada uno de estos tipos de vínculos, como Recuentode vínculos relacionados,Recuento de hipervínculos y Recuento de vínculos externos.

En la tabla siguiente se describen los tipos de vínculos de elementos de trabajo que puede especificar para establecer el ámbito de un control de vínculos mediante el elemento XML WorkItemLinksFilter.

En la tabla siguiente se describen los tipos de vínculos de elementos de trabajo que puede especificar para establecer el ámbito de un control de vínculos mediante el elemento XML WorkItemLinksFilter.