Vinculación de confirmaciones, solicitudes de incorporación de cambios e incidencias de GitHub con elementos de trabajo en Azure Boards

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

Una vez que conecte el proyecto de Azure Boards con un repositorio de GitHub, podrá vincular elementos de trabajo a las confirmaciones y solicitudes de cambios de GitHub. Puede agregar vínculos mediante la sintaxis #mention que conocen los usuarios de GitHub o puede agregar un tipo de vínculo confirmación de GitHub o solicitud de cambios de GitHub desde el elemento de trabajo de Azure Boards.

Nota:

Con la aplicación Azure Boards para GitHub, Azure Boards y Azure DevOps Services admiten la integración con repositorios de GitHub.com y GitHub Enterprise Server. Azure DevOps Servers 2019 y versiones posteriores solo admiten la integración con repositorios de GitHub Enterprise Server. No se admite la integración con otros repositorios de Git.

Requisitos previos

• El proyecto de Azure Boards debe estar conectado al repositorio de GitHub donde se encuentren las confirmaciones y las solicitudes de incorporación de cambios objeto de la vinculación. Para obtener más información, consulte Integración de Azure Boards y GitHub.
• Debe ser colaborador en el proyecto de Azure Boards y en el repositorio de GitHub.

Nota:

Los proyectos que usan el modelo de proceso XML hospedado requieren que se actualicen los tipos de elementos de trabajo para ver la sección Desarrollo y los tipos de vínculo de GitHub. Para obtener más información, consulte Actualización de las definiciones XML para tipos de elementos de trabajo elegidos.

Uso de AB# para vincular desde GitHub a elementos de trabajo de Azure Boards

Desde una confirmación, solicitud de incorporación de cambios o problema de GitHub, use la siguiente sintaxis para crear un vínculo al elemento de trabajo de Azure Boards. Escriba AB#ID dentro del texto de un mensaje de confirmación. O bien, para una solicitud de incorporación de cambios o un problema, escriba AB#ID dentro del título o la descripción (no un comentario).

AB#{ID}

Por ejemplo, AB#125 se vinculará al id. de elemento de trabajo 125.

También puede escribir un mensaje de confirmación o solicitud de incorporación de cambios para realizar la transición del elemento de trabajo. El sistema reconoce fix, fixes, fixed y lo aplica al elemento #-mention siguiente. Los elementos de trabajo mencionados pasan al primer estado asociado al estado de categoría y flujo de trabajo Resuelto. Si no hay ningún estado asociado a Resuelto, pasa al estado asociado al estado de categoría y flujo de trabajo Completado. Para comprender cómo se asignan los estados de flujo de trabajo y los estados de categoría, consulte Uso de los estados de categoría y flujo de trabajo en los trabajos pendientes y paneles de Azure Boards.

Consulte la tabla siguiente de ejemplos.

Mensaje de confirmación o solicitud de incorporación de cambios	Acción
Fixed AB#123	Vincula y realiza la transición del elemento de trabajo al estado de categoría y flujo de trabajo Resuelto o, si no se define ninguno, al estado de categoría y flujo de trabajo Completado.
Adds a new feature, fixes AB#123.	Vincula y realiza la transición del elemento de trabajo al estado de categoría y flujo de trabajo Resuelto o, si no se define ninguno, al estado de categoría y flujo de trabajo Completado.
Fixes AB#123, AB#124, and AB#126	Vínculos a los elementos de trabajo 123, 124 y 126 de Azure Boards. Solo realiza la transición del primer elemento, 123, al estado de categoría y flujo de trabajo Resuelto o, si no se define ninguno, al estado de categoría y flujo de trabajo Completado.
Fixes AB#123, Fixes AB#124, Fixes AB#125	Vínculos a los elementos de trabajo 123, 124 y 126 de Azure Boards. Realiza la transición de todos los elementos al estado de categoría y flujo de trabajo Resuelto o, si no se define ninguno, al estado de categoría y flujo de trabajo Completado.
Fixing multiple bugs: issue #123 and user story AB#234	Vínculos al problema 123 de GitHub y al elemento de trabajo 234 de Azure Boards. No se realiza ninguna transición.

Nota:

Si ha conectado el mismo repositorio de GitHub a proyectos definidos en dos o más organizaciones de Azure DevOps, puede causar una vinculación de menciones AB# inesperada. Para obtener más información, consulte Resolución de problemas de conexión. Por este motivo, se recomienda conectar solo un repositorio de GitHub a los proyectos definidos en una sola organización de Azure DevOps.

Incorporación de un vínculo desde un elemento de trabajo a una confirmación, solicitud de incorporación de cambios o problema de GitHub

1. Para vincular a una confirmación o solicitud de incorporación de cambios, abra el elemento de trabajo y elija Agregar vínculo en la sección Desarrollo.

   

   Para vincular a un problema, elija la pestaña Vínculos y elija Agregar vínculo>Elemento existente.

   

2. En el cuadro de diálogo Agregar vínculo, seleccione uno de los tipos de vínculo de GitHub , escriba la dirección URL para la confirmación, la solicitud de incorporación de cambios o el problema y elija Aceptar.
   Aquí, agregamos un vínculo a una solicitud de incorporación de cambios de GitHub.

   

   Azure Boards completa una comprobación para asegurarse de que ha escrito un vínculo válido. El repositorio vinculado a GitHub debe estar conectado al proyecto de Azure Boards o se producirá un error en la validación.

   Aquí, agregamos un vínculo a un problema de GitHub.

   

Visualización o apertura de vínculos desde la sección Desarrollo

En la sección Desarrollo del formulario del elemento de trabajo se enumeran los vínculos creados a confirmaciones de GitHub y solicitudes de incorporación de cambios con el icono de GitHub .

Elija el vínculo proporcionado para abrir la confirmación o solicitud de incorporación de cambios en GitHub.

Visualización de objetos de GitHub en el panel Kanban

Con las anotaciones de GitHub habilitadas en el panel Kanban, puede abrir rápidamente las confirmaciones de GitHub, las solicitudes de incorporación de cambios o los problemas vinculados para más detalles. Para obtener más información, consulte Personalización de tarjetas.

Pasos siguientes

Configuración de notificaciones de estado

Artículos relacionados

• Adición o eliminación de repositorios
• Cambio del acceso a repositorios de GitHub
• Integración de Azure Boards y GitHub
• Cómo se usan los estados de categoría y flujo de trabajo en los trabajos pendientes y los paneles de Azure Boards
• Vincular elementos de trabajo a objetos
• Solución de problemas de la integración entre GitHub y Azure Boards