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.

Requisitos previos

Categoría	Requisitos
Acceso al proyecto	Miembro del proyecto.
Permisos	- Miembro del grupo de seguridad Colaboradores o del grupo de seguridad Administradores de proyectos. - Para ver o modificar los elementos de trabajo: los permisos Ver los elementos de trabajo de este nodo y Editar los elementos de trabajo de este nodo establecidos en Permitir. De forma predeterminada, el grupo Colaboradores tiene este permiso establecido en Permitir. Para más información, consulte Establecimiento de permisos y acceso para el seguimiento del trabajo. - Para configurar las opciones de integración para una canalización de liberación clásica: Editar permisos para la liberación. - Para vincular elementos de trabajo a commits y pull requests: Editar elementos de trabajo en este nodo permisos establecidos en Permitir para la ruta de área asignada al elemento de trabajo. De forma predeterminada, el grupo Colaboradores tiene este permiso. - Para ver elementos de trabajo: Ver elementos de trabajo en este nodo permisos establecidos en Permitir para la Ruta de área asignada al elemento de trabajo.
Niveles de acceso	Para añadir o modificar elementos de trabajo: Al menos Acceso de Parte interesada. Los usuarios con acceso de Parte interesada para proyectos públicos tienen acceso completo a las funciones de backlog y board, como los usuarios con acceso Básico. Para obtener más información, consulte Referencia rápida sobre el acceso de parte interesada.
Iteraciones definidas	Para usar el panel de planificación , el administrador del equipo definió las rutas de iteración (sprint) y configuró las iteraciones del equipo.

Tipos de vínculos

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

Categoría de tipo de vínculo	Descripción
Compilación	Conecta un elemento de trabajo a un número de compilación, ya que está presente en la compilación o integrado en ella.
Código	Conecta un elemento de trabajo a una rama, conjunto de cambios, confirmación, solicitud de incorporación de cambios, etiqueta o elemento con versiones.
GitHub	Conecta un elemento de trabajo a una rama, commit, issue o pull request del repositorio de GitHub.
Trabajo remoto	Conecta un elemento de trabajo definido en una organización diferente que consume de, produce para, o está relacionado remotamente mediante la dirección URL.
Requisito	Conecta un elemento de trabajo a un guion gráfico a través de una URL.
Prueba	Conecta un elemento de trabajo a un resultado o datos adjuntos de prueba.
Wiki	Conecta un elemento de trabajo a una página wiki.
Trabajo	Conecta un elemento de trabajo a varios aspectos de su trabajo, incluyendo: - Afectado por - Afecta a - Secundario - Duplicado - Duplicado de - Hipervínculo - Integrado en la fase de lanzamiento - Primario: - Predecesor - Se hace referencia en - Referencia - Relacionados - Etapas compartidas - Sucesor - Caso de prueba - Probado por - Pruebas

Para obtener más información sobre los tipos de vínculo de trabajo, incluidos los tipos de vínculo padre/hijo, relacionados y predecesor-sucesor, 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 generales:

1. Inicie sesión en su organización (https://dev.azure.com/{Your_Organization}).

2. Abra el elemento de trabajo existente desde el que desea establecer el vínculo o cree uno nuevo.

3. Seleccione Vínculos>Añadir vínculo y, a continuación, seleccione Elemento existente o Elemento nuevo.

   

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

5. En el campo siguiente, introduzca o seleccione el objeto que desea vincular.

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

7. Seleccione Añadir vínculo para crear el vínculo.

Para obtener instrucciones más específicas sobre cómo vincular distintos tipos de elementos de trabajo, consulte las secciones siguientes.

Sugerencia

Puede usar otras funciones para vincular o cambiar vínculos que utilizan el tipo de vínculo Parent/Child. Algunas características dependen de la versión. Vea los siguientes artículos para más información:

• Para vincular elementos pendientes a elementos pendientes de cartera o cambiar la estructura de vínculos, use el panel de mapeo para organizar su lista de tareas pendientes. También puede elegir Mostrar primarios y arrastrar y colocar elementos 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. También puede arrastrar y soltar elementos para cambiar la estructura de vínculos desde el portal Web.
• Para aplicar sangría, sangría negativa y cambiar la estructura de vínculo de una jerarquía de árbol, aplique la reorganización dinámica de relación jerárquica y reordene los elementos de un trabajo pendiente en el portal web o use una consulta de árbol en Team Explorer.
• Para añadir o eliminar elementos de trabajo o cambiar la estructura de vínculos, utilice Excel. Consulte Agregar o modificar en bloque elementos de trabajo con Excel.

Vincular un elemento de trabajo a otro elemento de trabajo

Para añadir un vínculo a otro elemento de trabajo en el portal web, siga estos pasos:

1. Abra el elemento de trabajo desde el que desea establecer el vínculo.

2. En el formulario del elemento de trabajo, puede elegir entre dos formas de realizar esta tarea:

   • Vaya a la sección Trabajo relacionado y seleccione Agregar vínculo>Elemento existente.
   • Seleccione Vínculos>Agregar vínculo>Elemento existente.

   

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

4. En el campo Elementos de trabajo a vincular, introduzca el ID del elemento de trabajo al que desea vincular o selecciónelo en el menú desplegable y, a continuación, seleccione Añadir vínculo.

   En el ejemplo siguiente se usa el tipo de vínculo Relacionado en un caso de prueba con el identificador 280.

   

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

Vincular varios elementos de trabajo

1. En el portal web, abra un trabajo pendiente o una página de resultados de la consulta.

2. Realice una selección múltiple (resalte) de los elementos de trabajo para agregarles un vínculo.

3. Seleccione Más acciones para los elementos de trabajo seleccionados, seleccione Añadir vínculo y, a continuación, elija Vincular a un elemento existente... o Vincular a un nuevo elemento de trabajo....

   En el ejemplo siguiente, seleccionamos varios elementos del backlog de producto y elegimos Vínculo a un elemento existente....

   

4. Seleccione en el menú desplegable tipo de vínculo, por ejemplo, Padre, Hijoo Relacionado.

5. En el campo Artículo de trabajo, introduzca el ID del artículo de trabajo que desea vincular y, a continuación, seleccione Añadir vínculo.

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.

   

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. En tu elemento de trabajo, selecciona Vínculos>Agregar vínculo>Nuevo elemento.

   

2. Especifique el tipo de vínculo y el tipo de elemento de trabajo , y escriba un título para el nuevo elemento de trabajo y un comentario opcional. Seleccione Agregar vínculo.

   

   Se abre el nuevo elemento de trabajo.

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

   

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

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. En el elemento de trabajo, seleccione Vínculos>Agregar vínculo>Elemento existente.

   

2. Elija uno de los siguientes tipos de vínculos remotos en el menú desplegable Tipo de vínculo:

   • 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.

3. Introduzca la URL del elemento de trabajo remoto y seleccione Añadir vínculo.

   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ínculosremotos 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 una rama de GitHub, un commit de GitHub, un problema de GitHub, y un pull request 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

1. En una página de resultados de consulta o en un trabajo pendiente, realice una selección múltiple de los elementos de trabajo que desea vincular a una nueva rama de Git.

2. Seleccione el icono de acciones y, a continuación, Nueva rama.... Para obtener más información, consulte Vincular elementos de trabajo a objetos de desarrollo 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 el elemento de trabajo, seleccione Vínculos>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, seleccione Buscar compilación.

   

3. Seleccione 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 la opción Correcto correctamente seleccionado en Resultado, seleccione Encontrar compilaciones para enumerar las compilaciones disponibles a las que puede vincular.

   

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

5. Seleccione Añadir vínculo 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

Impulse el desarrollo desde el elemento de trabajo al 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 Confirmar. Estas son las formas de hacerlo:

• 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.

• Usa el control Desarrollo para el desarrollo de Git a partir del 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

El control de Despliegue proporciona varias características que le ayudarán a controlar y realizar un seguimiento del estado de lanzamiento de los elementos de trabajo. La siguiente lista describe estas funciones:

• Apariencia predeterminada: El control de implementación aparece en los formularios de elementos de trabajo para los tipos Historia de usuario (Ágil), Elemento del backlog del producto (Scrum), Incidencia (Básico), Requisito (CMMI), Característica, Épica, Error, Tarea y Caso de prueba de forma predeterminada.

• Tipos de elementos de trabajo personalizados: Tipos de elementos de trabajo personalizados que usan el proceso heredado están habilitados automáticamente.

• Información de versión: El control de implementación muestra la información de la versión para las dos etapas del pipeline de lanzamiento integrado con Azure Boards.

• elementos de trabajo vinculados: Este control solo muestra los elementos de trabajo vinculados a un commit o pull request de Git para este flujo de trabajo.

• Información visual: Obtén información visual sobre el estado de un elemento de trabajo a medida que se despliega en diferentes entornos de lanzamiento, y navega rápidamente a cada fase de lanzamiento y ejecución.

  

• Confirmar asociaciones: los elementos de trabajo asociados a confirmaciones en la compilación muestran el estado de la versión.

• Ámbito de proyecto: solo los elementos de trabajo del mismo proyecto se vinculan a dónde se define la canalización de versión.

  

• Visibilidad de la etapa: cuando abre un elemento de trabajo, puede ver las etapas en tiempo real.

  

Para rellenar el control de Implementación, siga estos pasos:

Nota:

El control de implementación requiere la configuración de una tubería de lanzamiento 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 lanzamiento, como se describe en Definición de una canalización de implementación continua (CD) de varias fases.

2. Configure la canalización.

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

El Control de Versiones de Team Foundation (TFVC) permite vincular elementos de trabajo a conjuntos de cambios o archivos de código fuente versionados utilizando los tipos de vínculo Conjunto de Cambios y Elemento Versionado. Al registrar los cambios pendientes o usar Mi Trabajo para registrar los cambios, los elementos de trabajo se vinculan automáticamente a tus 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 las pruebas vinculan elementos de trabajo de administración de casos de prueba entre sí o con otros elementos de trabajo. Desde 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 la sección Prueba, puede agregar planes de prueba, conjuntos de pruebas y casos de prueba, que se vinculan automáticamente. No puede añadir estos elementos 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 utilizar un hipervínculo o un tipo de vínculo de guion gráfico para vincular un elemento de trabajo a un sitio web, un recurso compartido de red o un documento 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.

Cuando utilice el tipo de vínculo de guion gráfico, especifique un guion gráfico o un documento que proporcione las especificaciones del elemento de trabajo. Este tipo de vínculo permite a su equipo acceder al archivo compartido y añadir sus 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 consultas: Puede utilizar el Editor de consultas 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.
• Rastreador de dependencias: el informe de Power BI denominado Rastreador de dependencias 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, realice los siguientes 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, utilice una consulta que muestre un conjunto primario y otro secundario de elementos de trabajo:

• El conjunto primario cumple los criterios de campo.
• El conjunto secundario está vinculado al conjunto primario.

No puede consultar elementos de trabajo en versiones, pero puede consultar elementos de trabajo con vínculos externos. Agregue más filtros de consulta para refinar la búsqueda.

Para obtener más información, consulte Consulta de elementos de trabajo por vínculo o recuento de 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.
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

• Revise la guía de referencia de los tipos de vínculo.
• 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
• Descargue la extensión de visualización de elementos de trabajo