Compartir a través de


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.

En este artículo, descubrirá cómo realizar las tareas siguientes:

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.
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.
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.
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.
Miembro colaborador o Permitir permisos en Para ver o modificar los elementos de trabajo, debe tener los permisos de Ver los elementos de trabajo en este nodo y Editar 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.
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.

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.

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.

  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.

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.

    Captura de pantalla del cuadro de diálogo Agregar vínculo, en el portal web, a un elemento de trabajo existente.

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

    Para vincular a varios elementos de trabajo, escriba sus identificadores separados por comas o espacios. Si no conoce los identificadores o desea vincular a un elemento de un proyecto diferente, seleccione Más acciones.

  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.

    Captura de pantalla de la página Resultados de la consulta, elementos modificados en bloque para guardar.

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

    Captura de pantalla del menú contextual del trabajo pendiente, selección múltiple de elementos en el trabajo pendiente, abrir menú contextual, elegir Agregar vínculo a un elemento de trabajo 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.

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

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

    Captura de pantalla de la pestaña Vínculos, abrir Más acciones, elegir la opción Editar vínculo.

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

    Captura de pantalla del cuadro de diálogo Editar vínculo.

  4. Guarde el elemento 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.

    Captura de pantalla del cuadro de diálogo Agregar vínculo, Vínculo al nuevo elemento de trabajo.

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

    Captura de pantalla del nuevo elemento de trabajo Incidencia agregado.

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

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.

Captura de pantalla del formulario Caso de usuario, pestaña Vínculo, donde se ven dos vínculos externos.

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 .

    Captura de pantalla de la acción de eliminar el vínculo de un elemento de trabajo.

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.

Captura de pantalla del formulario de caso de usuario, pestaña Vínculo, que muestra dos vínculos externos.

  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.

    Captura de pantalla de la lista de elementos de trabajo generada al escribir el símbolo # en la descripción de la solicitud de incorporación de cambios.

  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.

    Captura de pantalla de la especificación de la palabra clave después del símbolo # y el elemento de trabajo resultante en la búsqueda.

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

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.

Al conectar Azure Boards con repositorios de GitHub, puede vincular elementos de trabajo a confirmación de GitHub y solicitud de incorporación de cambios 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.

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.

Captura de pantalla del trabajo pendiente, menú contextual, elegir Vincular varios elementos de trabajo pendiente a una rama de Git.

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.

Nota:

Esta característica requiere la instalación de la Actualización 2020.1 de Azure DevOps Server. Para más información, consulte notas de la versión de Azure DevOps Server 2020 Update 1 RC1, Boards.

  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.

    Captura de pantalla del cuadro de diálogo Agregar vínculo con el tipo de vínculo de compilación seleccionado.

  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.

    Captura de pantalla del cuadro de diálogo Buscar compilaciones con el proyecto seleccionado y la lista de compilaciones.

  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.

    Captura de pantalla del cuadro de diálogo Agregar vínculo con el número de compilación introducido.

Puede vincular elementos de trabajo a compilaciones existentes desde el cuadro de diálogo Agregar vínculo.

  1. En la pestaña Vínculos de un elemento de trabajo, elija 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.

    Captura de pantalla del cuadro de diálogo Agregar vínculo con el tipo de vínculo de compilación seleccionado.

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

    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.

    Captura de pantalla del cuadro de diálogo Buscar compilaciones, vínculo a una compilación dentro del proyecto.

  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, elija Aceptar para completar la operación.

    Captura de pantalla del cuadro de diálogo Agregar vínculo con el número de compilación introducido.

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.

Imagen conceptual de los tipos de vínculo de DevOps.

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:

    Captura de pantalla de Agregar identificador de elemento de trabajo o arrastrar elementos antes de confirmar los cambios.

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

Captura de pantalla de varios entornos a los que va destinada la versión.

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.

Captura de pantalla del formulario Elemento de trabajo, Control de implementación.

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.

Captura de pantalla donde se ven varios entornos a los que va destinada la versión.

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

Captura de pantalla de las fases de configuración de versión, incluidas las pruebas, el almacenamiento provisional, la producción y el desarrollo.

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:

  4. Ejecución de la canalización

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.

Captura de pantalla de Team Explorer, Mi trabajo, Cambios pendientes y la acción de insertar.

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.

Captura de pantalla de los tipos de vínculo utilizados para vincular objetos de prueba.

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.

Captura de pantalla del formulario de elemento de trabajo de prueba en el que se muestran los pasos.

Captura de pantalla del cuadro de diálogo Insertar pasos compartidos.

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.

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.

Captura de pantalla del tipo de vínculo Hipervínculo o Guion gráfico para vincular un elemento de trabajo a una dirección URL.

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.

    Captura de pantalla de la pestaña Vínculos con el recuento de objetos vinculados.

  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.

Captura de pantalla de la pestaña Vínculos con muchos objetos vinculados.

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.

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.

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.

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.

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.

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.

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.