Vincular elementos de trabajo a objetos

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Los vínculos de elementos de trabajo son asociaciones entre dos elementos de trabajo o un elemento de trabajo y otro objeto. Los vínculos describen la relación entre objetos. Puede usar vínculos de elementos de trabajo para realizar un seguimiento de las dependencias y el trabajo relacionado con la rastreabilidad, compartir información, administrar proyectos complejos que implican varios equipos o productos, realizar un seguimiento de los cambios de código, las pruebas y mucho más.

• Vincular elementos de trabajo a varios objetos
• Vincular elementos de trabajo a otros elementos de trabajo
• Vincular varios elementos de trabajo
• Cambiar el tipo de vínculo de un vínculo existente
• Vincular elementos de trabajo a nuevos elementos de trabajo
• Vincular elementos de trabajo a elementos de trabajo en diferentes proyectos (organización cruzada)
• Vinculación de elementos de trabajo a una PR
• Vincular elementos de trabajo a objetos de GitHub
• Vincular varios elementos a nuevas ramas de Git
• Vincular elementos de trabajo a compilaciones
• Vinculación de elementos de trabajo a implementaciones
• Vincular elementos de trabajo al desarrollo de código TFVC
• Vincular elementos de trabajo a pruebas
• Vincular elementos de trabajo a un sitio web, un recurso compartido de red, un guion gráfico o un documento
• Ver dependencias y realizar un seguimiento del trabajo relacionado
• Consulta de elementos de trabajo vinculados
• Uso de la CLI de Azure para agregar, quitar o mostrar vínculos
• Eliminar vínculos de elementos de trabajo

Requisitos previos

Requisito previo	Descripción
Administrador de proyectos o miembro colaborador	Debe agregarse a un proyecto como miembro del grupo de seguridad Colaboradores o Administradores de proyectos.
Acceso de Parte interesada	Para agregar o modificar elementos de trabajo, se le debe conceder acceso de parte interesada o superior. Los usuarios con acceso de parte interesada para proyectos públicos tienen acceso total a las características del trabajo pendiente y del panel, al igual que los usuarios con acceso básico. Para obtener más información, consulte Referencia rápida sobre el acceso de parte interesada.
Miembro colaborador o Permitir permisos en	- Para ver o modificar elementos de trabajo, debe tener los elementos de trabajo Ver elementos de trabajo en este nodo y Editar elementos de trabajo en este nodo permisos establecidos en Permitir. De forma predeterminada, el grupo Colaboradores tiene este permiso establecido en Permitir. Para obtener más información, consulte Establecer permisos y acceso para el seguimiento del trabajo. : para configurar las opciones de integración de una canalización de versión clásica, debe tener permisos para editar la versión. : para vincular elementos de trabajo a confirmaciones y solicitudes de incorporación de cambios, debe tener los Editar elementos de trabajo en este nodo permisos establecidos en Permitir para la ruta de acceso del área asignada al elemento de trabajo. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. : para ver los elementos de trabajo, debe tener los Ver elementos de trabajo en este nodo permisos establecidos en Permitir para la ruta de acceso del área asignada al elemento de trabajo.
Iteraciones definidas	Para usar el panel Planeamiento, el administrador del equipo debe definir rutas de acceso de iteración (sprint) y configurar las iteraciones del equipo.

¿Qué tipos de vínculos hay?

Los siguientes tipos de vínculos le ayudan a administrar las distintas relaciones entre los elementos de trabajo y otros objetos.

Tipo de vínculo	Descripción
Hipervínculo	Conecta un elemento de trabajo a cualquier dirección URL o recurso compartido de red
tipo de vínculo externo	Conecta un elemento de trabajo a un objeto externo, como un objeto de código, una compilación o una página wiki.
tipo de vínculo Trabajo remoto	Conecta elementos de trabajo definidos en diferentes organizaciones
tipo de vínculo de GitHub	Conecta un elemento de trabajo a una confirmación, un problema o una solicitud de incorporación de cambios de un repositorio de GitHub
Tipo de vínculo de trabajo	Conecta elementos de trabajo, incluidos seleccionar elementos de trabajo de administración de casos de prueba

Para obtener más información sobre los tipos de vínculo, incluidos los tipos de vínculo primarios o secundarios, relacionados y sucesores predecesores, consulte Tipos de vínculo de trabajo.

Vincular elementos de trabajo a varios objetos

Para vincular elementos de trabajo a varios objetos, siga estos pasos.

1. En el portal web, abra el elemento de trabajo desde el que desea vincular o cree uno nuevo.

2. Seleccione la pestaña Vínculos y, a continuación, seleccione Vínculo a.

3. En la lista desplegable Tipo de vínculo, seleccione el tipo de vínculo que desea crear.

4. En el campo Vincular a , escriba o seleccione el objeto al que desea vincular. Según el tipo de vínculo, puede escribir o seleccionar los siguientes objetos.

   • otro identificador de elemento de trabajo o de título
   • dirección URL de un elemento de trabajo remoto
   • una dirección URL de solicitud de incorporación de cambios de Git externa
   • un número de compilación o un nombre de definición
   • un nombre de fase de implementación o un nombre de entorno
   • página web o dirección URL del documento

5. (Opcional) Escriba un comentario para describir el vínculo.

6. Seleccione Aceptar para crear el vínculo.

Sugerencia

Hay otras características que puede usar para vincular o cambiar vínculos que usan el tipo de vínculo Parent/Child . Algunas características dependen de la versión. Para obtener más información, consulte los artículos vinculados.

• Tanto para vincular elementos de trabajo pendiente a elementos de trabajo pendiente en cartera como para cambiar la estructura de vínculos entre estos elementos, use el panel de asignación para organizar el trabajo pendiente. O bien, puede elegir Mostrar primarios y elementos de arrastrar y colocar dentro de la jerarquía de árboles.
• Para crear y vincular tareas a elementos de trabajo pendiente, use la página de trabajo pendiente del sprint. En el portal web, también puede arrastrar y colocar elementos para cambiar la estructura del vínculo.
• Para sangr ( ), outdent ( ) y cambiar la estructura de vínculo de una jerarquía de árbol, reparentar y reordenar elementos de un trabajo pendiente en el portal web o usar una consulta de árbol en Team Explorer.
• Para agregar o eliminar elementos de trabajo o cambiar la estructura de vínculos, también puede utilizar Excel. Consulte Agregar o modificar en bloque elementos de trabajo con Excel.

Vincular elementos de trabajo a otros elementos de trabajo

Realice los pasos siguientes para agregar un vínculo a otro artículo de usuario, epopeya, característica, error, problema o tarea desde el portal web.

1. Abra el elemento de trabajo que desea vincular a otro elemento de trabajo.

2. En el formulario de elemento de trabajo, seleccione la sección trabajo relacionado.

3. Seleccione Agregar vínculo y luego Elemento existente.

4. En la lista desplegable Tipo de vínculo, seleccione el tipo de vínculo que desea crear, por ejemplo, Primario, Secundario o Relacionado.

5. En el campo Elemento de trabajo, escriba el identificador del elemento de trabajo al que desea vincular y, a continuación, seleccione Aceptar.

   En el ejemplo siguiente se usa el tipo de vínculo Relacionado para vincular tres elementos al error con el identificador 400.

   

   Los vínculos solo se pueden agregar de uno a uno No puede escribir sus identificadores separados por comas o espacios.

6. (Opcional) Si está trabajando desde la página Resultados de la consulta , guarde de forma masiva los elementos de trabajo que modificó. Al trabajar desde un trabajo pendiente, los elementos de trabajo se guardan automáticamente.

   

Vincular varios elementos de trabajo

1. En el portal web, abra una trabajo pendiente o una página de resultados de consultas y seleccione varios elementos de trabajo a los que desea agregar un vínculo.

2. Abra el menú contextual ... de uno de los elementos de trabajo seleccionados, elija Agregar vínculo y, a continuación, elija Elemento existente... o Nuevo elemento....

   En el ejemplo siguiente, seleccione varias opciones en el trabajo pendiente del producto y elija Elemento existente....

   

3. En la lista desplegable Tipo de vínculo, seleccione el tipo de vínculo que desea crear, por ejemplo, Primario, Secundario o Relacionado.

4. En el campo Elemento de trabajo, escriba el identificador del elemento de trabajo al que desea vincular y, a continuación, seleccione Aceptar.

Cambiar el tipo de vínculo de un vínculo existente

1. En el portal web, abra el elemento de trabajo y seleccione Vínculos.

2. Seleccione Más acciones>Editar vínculo.

   

3. Elija el tipo de vínculo al que desea cambiar y, después, elija Guardar.

   

4. Guarde el elemento de trabajo.

Vinculación de elementos de trabajo a nuevos elementos de trabajo

Realice los pasos siguientes para vincular un elemento de trabajo a un nuevo elemento de trabajo.

1. Especifique el tipo de vínculo, el tipo de elemento de trabajo y el título del nuevo elemento de trabajo. Seleccione Aceptar. Se abre un elemento de trabajo del tipo seleccionado.

   

2. Escriba información adicional y guarde el elemento de trabajo.

   

3. (Opcional) Si trabaja desde la página Resultados de la consulta, guarde de forma masiva los elementos de trabajo que modificó.

Vincular elementos de trabajo a elementos de trabajo remotos (organización cruzada)

Las organizaciones que usan el identificador de Entra de Microsoft pueden vincularse a elementos de trabajo que existen en proyectos diferentes entre organizaciones. Use los siguientes tipos de vínculo como se indica:

• Use los tipos de vínculo Consumes From o Produces For cuando quiera realizar un seguimiento de las dependencias de los elementos de trabajo definidos en diferentes organizaciones y administrados por diferentes equipos.
• Use el tipo de vínculo relacionado con el remoto cuando los elementos de trabajo que se vinculan se definen en diferentes organizaciones y los administran diferentes equipos, pero no tienen interdependencias sólidas.

Siga estos pasos para vincular elementos de trabajo a objetos definidos en otras organizaciones de Azure DevOps. Solo puede hacerlo si ambas organizaciones usan el mismo identificador de Entra de Microsoft para administrar usuarios.

1. Elija uno de los siguientes tipos de vínculo remoto:

   • Consume Desde o genera para: cuando desea realizar un seguimiento de las dependencias de los elementos de trabajo definidos en diferentes organizaciones y administrados por diferentes equipos.
   • Relacionado con remoto: cuando los elementos de trabajo que se vinculan se definen en diferentes organizaciones y los administran diferentes equipos, pero no tienen interdependencias sólidas.

2. En el cuadro de diálogo Agregar vínculo , seleccione el tipo de vínculo, escriba la dirección URL del elemento de trabajo remoto y, a continuación, seleccione Aceptar.

   En el ejemplo siguiente se usa el tipo de vínculo Remote Related para vincular al identificador de elemento de trabajo 350 que existe en la organización remotelinkingtest2 , proyecto RemoteLinking .

   

La pestaña de vínculo mantiene un recuento de todos los vínculos al elemento de trabajo. El campo Recuento de vínculos remotos mantiene un recuento del número de vínculos agregados a un elemento de trabajo que se vincula a un elemento de trabajo definido en otro proyecto u organización.

En el siguiente ejemplo se muestran dos vínculos remotos, indicados por el icono de nube , agregados a un caso de usuario.

Vinculación de elementos de trabajo a una PR

1. En la descripción de la solicitud de cambios, escriba # para desencadenar el selector de elementos de trabajo #ID. Una lista muestra 50 elementos de trabajo que ha modificado recientemente o que se le han asignado.

   

2. Para restringir la lista de elementos de trabajo sugeridos, escriba hasta cinco palabras clave que coincidan con el tipo de elemento de trabajo, el identificador o el título.

   

Para obtener más información, vea Vínculo a elementos de trabajo de solicitudes de incorporación de cambios, confirmaciones y comentarios.

Vinculación de elementos de trabajo a objetos de GitHub

Al conectar Azure Boards con repositorios de GitHub, puede vincular elementos de trabajo a un confirmación de GitHub, una solicitud de incorporación de cambios de GitHub, una rama de GitHub y una incidencia de GitHub. Puede usar GitHub para el desarrollo de software mientras usa Azure Boards para planear y realizar un seguimiento del trabajo.

Importante

Solo puede vincular elementos de trabajo a objetos de GitHub que tengan repositorios conectados a Azure Boards. Para obtener más información, consulte Conexión de Azure Boards a GitHub y Vínculo a elementos de trabajo desde solicitudes de incorporación de cambios, confirmaciones y comentarios.

Para obtener más información, consulte Vinculación de confirmaciones, solicitudes de incorporación de cambios, ramas e incidencias de GitHub con elementos de trabajo y Autocompletar elementos de trabajo con solicitudes de incorporación de cambios.

Vinculación de varios elementos de trabajo a nuevas ramas de Git

En una página de resultados de trabajos pendientes o de consulta, seleccionar varios elementos de trabajo que desea vincular a una nueva rama git, elija el icono de acciones de y, a continuación, Nueva rama.... Para más información, consulte Vinculación de elementos de trabajo a objetos de desarrollo de Git.

Vinculación de elementos de trabajo a compilaciones

Siga estos pasos para vincular elementos de trabajo a compilaciones existentes. Estas compilaciones pueden estar en el proyecto o en otros proyectos de la organización o colección.

1. En la pestaña Vínculos de un elemento de trabajo, seleccione Agregar vínculo>Elemento existente.

2. En el cuadro de diálogo Agregar vínculo , elija uno de los tipos de vínculo de compilación: Compilación, Encontrado en compilación, Integrado en compilación. Especifique el número de compilación.

   El número de compilación es una combinación de la canalización y el nombre de compilación. Si no conoce el número de compilación, búselo eligiendo el icono.

   

3. En el cuadro de diálogo Vincular compilaciones, elija los parámetros para filtrar la búsqueda de compilaciones.

   Para vincular a una compilación en un proyecto diferente, elija primero el Project cuya compilación desea vincular.

   Por ejemplo, puede especificar un número de compilación, seleccionar una canalización de compilación o un resultado de compilación, como Todos, correctos, parcialmente correctos, con errores o cancelados. O bien, con Todos seleccionados para Resultado, elija Buscar para enumerar las compilaciones disponibles con las que puede vincular.

   

4. Elija la compilación de la lista a la que desea vincular y, a continuación, seleccione Aceptar.

5. En el cuadro de diálogo Agregar vínculo , seleccione Aceptar para completar la operación.

   

Vinculación de elementos de trabajo a implementaciones

A medida que desarrolla el software, puede capturar qué cambios de código y compilaciones admiten la finalización de un elemento de trabajo. El equipo puede comprender qué trabajo se realizó o cómo se corrigió un error a través de la pista de auditoría de los cambios en la base de código.

Los tipos de vínculo que se usan para construir estos vínculos son: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item y Integrated in release environment. Estos tipos aparecen en la imagen siguiente.

Sugerencia

Se recomienda impulsar el desarrollo desde el elemento de trabajo en el momento de crearlo. También puede agregar el identificador del elemento de trabajo al crear ramas, confirmaciones y solicitudes de incorporación de cambios. Git permite vincular los elementos de trabajo a confirmaciones mediante el tipo de vínculo Commit. Puede hacerlo de las siguientes maneras.

• Antes de confirmar los cambios, agregue identificadores de elemento de trabajo en Cambios de Git para Visual Studio 2022 o Team Explorer para versiones anteriores de Visual Studio:

  

• Use el comando git-commit e incluya el identificador del elemento de trabajo en el comentario. Por ejemplo, aplique este comentario #35 Catch null exception a la confirmación. Al insertar la confirmación, el sistema crea un vínculo Confirmación entre la confirmación y el elemento de trabajo 35.

• Use el control Desarrollo para el desarrollo de Git desde el elemento de trabajo. Para más información, consulte Controlar el desarrollo de Git desde un elemento de trabajo en Azure Boards.

Como se muestra en la siguiente imagen, el control Implementación muestra información de versión para dos fases de versión. Incluye los elementos de trabajo vinculados a una solicitud de confirmación o incorporación de cambios de Git para una canalización de versión configurada para integrarse con Azure Boards.

Control de implementación

Los formularios de elementos de trabajo proporcionan dos controles para mostrar y ir a objetos de desarrollo. En este artículo se describe el control Implementación. Para obtener información sobre el control Desarrollo, consulte Controlar el desarrollo de Git desde un elemento de trabajo.

De forma predeterminada, el control de Implementación aparece en los formularios de elementos de trabajo para los tipos de elementos de trabajo Caso de usuario (Agile), Elemento de trabajo pendiente (Scrum), Problema (Basic), Requisito (CMMI), Característica, Épica, Error, Tarea y Caso de prueba.

Los tipos de elementos de trabajo personalizados que usan el proceso heredado se habilitan automáticamente. El control Implementación muestra la información de versión de dos fases de la canalización de versión integrada con Azure Boards.

Este control solo muestra los elementos de trabajo vinculados a una solicitud de confirmación o incorporación de cambios de Git para esta canalización. También puede obtener información visual sobre el estado de un elemento de trabajo cuando se implementa en diferentes entornos de versión. Puede ir a cada fase de versión y ejecutar.

Pero solo los elementos de trabajo del mismo proyecto se vinculan a dónde se define la canalización de versión. Solo los elementos de trabajo del mismo proyecto se vinculan a donde se define la canalización de versión.

Al abrir un elemento de trabajo, puede ver las fases en tiempo real.

Para rellenar el control implementación, siga estos pasos:

Nota:

El control Implementación requiere la configuración de una canalización de versión clásica. No admite la vinculación a las fases de versión definidas para una canalización YAML.

1. Defina una canalización de versión clásica y configure las fases de versión. Para obtener más información, consulte Definición de la canalización de implementación continua (CD) de varias fases.

2. Configure la canalización. Para obtener más información, consulte Configuración de canalizaciones para admitir el seguimiento del trabajo, Informe del estado de implementación en Paneles.

3. Vincule elementos de trabajo a una confirmación o a una solicitud de incorporación de cambios en el repositorio Git de Azure Repos. Para más información, vea:

   • Impulsar el desarrollo de Git desde un elemento de trabajo
   • Vinculación a elementos de trabajo de otros objetos

4. Ejecución de la canalización

Vinculación de elementos de trabajo al desarrollo de código TFVC

Control de versiones de Team Foundation (TFVC) permite vincular elementos de trabajo a los conjuntos de cambios de control de versiones o archivos de código fuente con control de versiones mediante los tipos de vínculo Conjunto de cambios y Elemento con versión. Al proteger los cambios pendientes o usar Mi trabajo para proteger los cambios, elementos de trabajo se vinculan automáticamente a los cambios. Para obtener más información, consulte Comprobación del trabajo.

Vinculación de elementos de trabajo a pruebas

Los tipos de vínculo relacionados con pruebas vinculan elementos de trabajo de administración de casos de prueba entre sí u otros elementos de trabajo. En el portal web o Microsoft Test Manager, puede ver qué casos de prueba están definidos para un conjunto de pruebas y qué conjuntos de pruebas están definidos para un plan de pruebas. Estos objetos no están vinculados entre sí a través de tipos de vínculo.

Puede vincular elementos de trabajo a casos de prueba mediante los tipos de vínculo Probado/Probado por. Use los mismos controles de vínculo que usa para vincular elementos de trabajo a otros elementos de trabajo. Consulte Vincular elementos de trabajo.

En la imagen siguiente se muestra el conjunto completo de tipos de vínculo que puede usar con los tipos de elemento de trabajo de administración de pruebas. La mayoría de los vínculos entre los objetos de administración de pruebas se producen mediante la ejecución de una tarea desde las páginas De prueba o Microsoft Test Manager.

Por ejemplo, al agregar pasos compartidos a un caso de prueba, se vinculan automáticamente mediante los tipos de vínculo caso de prueba o pasos compartidos . Para más información, vea Uso compartido de pasos entre casos de prueba.

En Prueba, puede agregar planes de prueba, conjuntos de pruebas y casos de prueba, que están vinculados. No se pueden agregar a través de un tipo de vínculo específico. El sistema de pruebas crea y administra las asociaciones de resultados de pruebas para los casos de prueba y los planes de prueba.

Vincular elementos de trabajo a un sitio web, un recurso compartido de red, un guion gráfico o un documento

Puede usar un hipervínculo o un tipo de vínculo storyboard para vincular un elemento de trabajo a un sitio web, un recurso compartido de red o un documento ubicado en un recurso compartido de red. Ambos tipos de vínculo son unidireccionales. Para agregar estos tipos de vínculo, use los mismos controles descritos anteriormente. Consulte Vincular elementos de trabajo.

Al usar el tipo de vínculo storyboard, diferencie el vínculo para especificar un guión gráfico o un documento que proporcione especificaciones de elementos de trabajo. Use este tipo de vínculo para proporcionar a su equipo acceso al archivo compartido y pueda agregar comentarios.

Visualización de dependencias y seguimiento del trabajo relacionado

Azure DevOps proporciona varias maneras de ver las dependencias y realizar un seguimiento del trabajo relacionado:

• Editor de Power Query: puede usar el Editor de Power Query para crear consultas personalizadas que muestren todos los elementos de trabajo vinculados a un elemento de trabajo específico.
• Trabajos pendientes y paneles: las vistas Trabajos pendientes y Paneles muestran relaciones entre elementos de trabajo primarios y secundarios, lo que le permite ver las dependencias de un vistazo.
• Seguimiento de dependencias: El rastreador de dependencias es un informe de Power BI que proporciona una representación visual de las dependencias entre los elementos de trabajo.

Para ver la lista de todos los objetos vinculados a un elemento de trabajo, siga estos pasos.

1. Abra el elemento de trabajo y seleccione Vínculos. La pestaña vínculos indica el recuento de todos los objetos vinculados. Los objetos vinculados se agrupan en su tipo de vínculo, con un recuento dentro de cada grupo.

   

2. (Opcional) Expanda o contraiga cada grupo y ordene dentro de cada grupo por Estado, Última actualización o Comentario eligiendo el título de columna correspondiente.

Por ejemplo, la siguiente pestaña Vínculos muestra una parte de los 64 objetos vinculados para un elemento de trabajo.

Los vínculos precedidos de la signo de exclamación indican que se elimina la compilación, la versión u otro objeto. Debido a las directivas de retención, estos objetos se eliminan automáticamente después de un período de tiempo determinado.

Consulta de elementos de trabajo vinculados

Para filtrar elementos de acuerdo con vínculos jerárquicos, utilice el tipo de consulta Árbol de elementos de trabajo. Para filtrar elementos en función de todos los tipos de vínculos, utilice Elementos de trabajo y vínculos directos.

Para buscar elementos de trabajo vinculados a otros elementos de trabajo con tipos de vínculo específicos, use una consulta que muestre un conjunto principal y secundario de elementos de trabajo. El conjunto principal cumple los criterios de campo y el conjunto secundario está vinculado al conjunto principal. No se pueden consultar elementos de trabajo en versiones. Puede consultar elementos de trabajo con vínculos externos. Para refinar la búsqueda, agregue más filtros de consulta.

Para ver ejemplos de consultas, consulte Consulta de elementos de trabajo por vínculo o recuento de datos adjuntos.

No se puede construir una consulta que muestre una vista jerárquica de planes de pruebas, conjuntos de pruebas y casos de prueba. Estos elementos no están vinculados juntos mediante el tipo de vínculo Principal/secundario o cualquier otro tipo de vínculo. Solo puede ver la jerarquía a través de la página Planes de prueba>. Para obtener más información, consulte Creación de planes de prueba y conjuntos de pruebas.

Uso de la CLI de Azure para agregar, quitar o mostrar vínculos

Puede agregar, quitar y mostrar detalles de vínculos a un elemento de trabajo con el comando az boards work-item relation . Para más información, consulte Introducción a la CLI de Azure DevOps.

Los tipos de vínculo incluyen tipos de vínculo de trabajo, tipos de vínculos remotos, hipervínculos y archivos adjuntos. Para obtener una lista de todos los tipos de vínculo que puede especificar, ejecute el comando az boards work-item relation list-type.

az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show

En los ejemplos siguientes, la organización es fabrikam y el identificador del proyecto corresponde a aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb. El formato de tabla se usa para mostrar la salida. Para ver otros formatos, consulte Formatos de salida para comandos de la CLI de Azure.

Vincular elementos de trabajo

Para vincular uno o varios elementos de trabajo a un único elemento de trabajo, escriba el comando az boards work-item relation add .

Los parámetros necesarios incluyen el identificador del elemento de trabajo al que vincular y el tipo de vínculo. Los tipos de vínculo admitidos incluyen Parent, Child, Related y Remote Related. Para obtener una lista de todos los tipos de vínculo, ejecute el comando az boards work-item relation list-type .

En el caso de los elementos de trabajo definidos en la misma organización, debe especificar el identificador de elemento de trabajo o la dirección URL de destino. Para los elementos de trabajo definidos en una organización remota, especifique la dirección URL de destino. Puede especificar varios valores separando los identificadores o las URL mediante comas.

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org]
                                 [--target-id]
                                 [--target-url]

El siguiente comando vincula el id. de elemento de trabajo =2807 al id. de elemento de trabajo =2794con el tipo de vínculo secundario. El comando devuelve una lista de todos los vínculos definidos actualmente para el elemento de trabajo.

az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2807

Para ver la información de los elementos de trabajo vinculados, escriba una de las direcciones URL enumeradas en el explorador.

Quitar vínculos de elemento de trabajo

Para quitar uno o varios elementos de trabajo vinculados de un solo elemento de trabajo, escriba el comando az boards work-item relation remove.

Los parámetros necesarios incluyen el identificador del elemento de trabajo al que vincular y el tipo de vínculo. Solo puede quitar vínculos a elementos de trabajo definidos en la misma organización. Puede especificar cualquiera de los tipos de vínculo admitidos excepto los tipos de vínculo remotos.

Debe especificar el identificador del elemento de trabajo de destino. Puede especificar varios valores separando los identificadores o las URL mediante comas.

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org]
                                    [--yes]

El siguiente comando quita el vínculo al elemento de trabajo id.=2794 del elemento de trabajo id.=2856 al elemento de trabajo con el tipo de vínculo secundario. El comando devuelve una lista de todos los vínculos definidos actualmente para el elemento de trabajo.

az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805 

Para ver la información de los elementos de trabajo vinculados, escriba una de las direcciones URL enumeradas en el explorador.

Mostrar detalles de los vínculos realizados para un solo elemento de trabajo

Para ver los elementos de trabajo vinculados a un solo elemento de trabajo, escriba el comando az boards work-item relation show. Para obtener una lista de todos los tipos de vínculo que se pueden devolver, ejecute el comando az boards work-item relation list-type.

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org]

En el siguiente comando se enumeran los detalles de los vínculos definidos para el elemento de trabajo id.=2931 en la organización fabrikam en formato de tabla.

az boards work-item relation show --id 2931 --output table
Relation Type    Url
---------------  -----------------------------------------------------------------------------------------------------------------------------------
Related          https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

Para ver la información de los elementos de trabajo vinculados, escriba una de las direcciones URL enumeradas en el explorador. Elija la dirección URL de un archivo adjunto para descargar los datos adjuntos.

Eliminar vínculos de elementos de trabajo

Realice los pasos siguientes para eliminar un vínculo de elemento de trabajo.

1. Abra el elemento de trabajo que tiene vínculos o selecciónelo en un resultado de consulta.
2. Seleccione la pestaña Vínculos para ver la lista de vínculos.
3. Seleccione el vínculo que desea eliminar y, a continuación, seleccione el vínculo Quitar.
4. Confirme que desea eliminar el vínculo.

Una vez que un elemento de trabajo se vincula a una solicitud de confirmación o incorporación de cambios, sigue apareciendo como parte de las fases de lanzamiento. Por ejemplo, si tiene un elemento de trabajo que no supere los criterios de prueba, es posible que quiera quitarlo de las compilaciones y versiones.

Para que el elemento de trabajo no participe en futuras compilaciones y versiones, elimine el vínculo a la confirmación y a la PR más recientes.

Artículos relacionados

Visualizar el trabajo relacionado y otros objetos. Descargue la extensión de visualización de elementos de trabajo, disponible en la pestaña Visual Studio Marketplace, Azure DevOps.

• Revise la guía de referencia de los tipos de vínculo.
• Descripción de Azure Boards y Azure Repos
• Impulsar el desarrollo de Git desde un elemento de trabajo
• Seguimiento de dependencias mediante planes de entrega
• Organización del trabajo pendiente y asignación de elementos de trabajo secundarios
• Agregar o modificar elementos de trabajo de forma masiva con Microsoft Excel