Lier des commits, des demandes de tirage et des problèmes GitHub à des éléments de travail dans Azure Boards

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

Après avoir connecté votre projet Azure Boards à un référentiel GitHub, vous pouvez lier des éléments de travail à vos commits et demandes de tirage GitHub. Vous pouvez ajouter des liens à l’aide de la syntaxe #mention que connaissent bien les utilisateurs de GitHub, ou vous pouvez ajouter un type de lien Commit GitHub ou Demande de tirage GitHub à partir de l’élément de travail Azure Boards.

Remarque

Avec l’application Azure Boards pour GitHub, Azure Boards et Azure DevOps Services prennent en charge l’intégration aux dépôts GitHub.com et GitHub Enterprise Server. Azure DevOps Server 2019 et versions ultérieures prennent en charge l’intégration aux référentiels GitHub Enterprise Server uniquement. L’intégration à d’autres référentiels Git n’est pas prise en charge.

Prérequis

• Votre projet Azure Boards doit être connecté au dépôt GitHub où existent les validations et les demandes de tirage vers lesquelles vous souhaitez créer un lien. Pour plus d’informations, consultez Intégration Azure Boards-GitHub.
• Vous devez être contributeur au projet Azure Boards et au dépôt GitHub.

Notes

Les projets qui utilisent le modèle de processus XML hébergé nécessitent des mises à jour des types d’éléments de travail pour afficher les types de liens Développement et GitHub. Pour plus d’informations, consultez Mettre à jour les définitions XML pour certains types d’éléments de travail.

Utiliser AB# pour lier des éléments de travail GitHub à Azure Boards

À partir d’une validation, d’une demande de tirage ou d’un problème GitHub, utilisez la syntaxe suivante pour créer un lien vers votre élément de travail Azure Boards. Entrez le AB#ID dans le texte d’un message de validation. Ou, pour une demande de tirage ou un problème, entrez le AB#ID dans le titre ou la description (pas un commentaire).

AB#{ID}

Par exemple, AB#125 établit un lien à l’ID d’élément de travail 125.

Vous pouvez également entrer un message de validation ou de demande de tirage pour effectuer la transition de l’élément de travail. Le système reconnaît fix, fixes, fixed et l’applique à l’élément #-mention qui suit. Les éléments de travail mentionnés passent au premier État associé à l’état de catégorie de workflow Résolu. Si aucun État n’est associé à Résolu, il passe à l’État associé à l’état associé de catégorie de workflow terminé. Pour comprendre comment les états de workflow et les états de catégorie sont mappés, consultez Utilisation des états de catégorie de workflow dans les backlogs et tableaux Azure Boards.

Consultez le tableau suivant pour obtenir des exemples.

Message de validation ou de demande de tirage	Action
Fixed AB#123	Lie et fait transitionner l’élément de travail vers la catégorie d’état de workflow Résolu ou, si aucun n’est défini, la catégorie d’état de workflow Terminé.
Adds a new feature, fixes AB#123.	Lie et fait transitionner l’élément de travail vers la catégorie d’état de workflow Résolu ou, si aucun n’est défini, la catégorie d’état de workflow Terminé.
Fixes AB#123, AB#124, and AB#126	Lie les éléments de travail Azure Boards 123, 124 et 126. Fait transitionner uniquement le premier élément, 123, vers la catégorie d’état de workflow Résolu ou, si aucun n’est défini, la catégorie d’état de workflow Terminé.
Fixes AB#123, Fixes AB#124, Fixes AB#125	Lie les éléments de travail Azure Boards 123, 124 et 126. Fait transitionner tous les éléments vers la catégorie d’état de workflow Résolu ou, si aucun n’est défini, la catégorie d’état de workflow Terminé.
Fixing multiple bugs: issue #123 and user story AB#234	Lie le problème GitHub 123 et l’élément de travail Azure Boards 234. Aucune transition n’est effectuée.

Remarque

Si vous avez connecté le même référentiel GitHub à des projets définis dans au moins deux organisations Azure DevOps, vous pouvez voir un lien de mention AB# inattendue. Pour plus d’informations, consultez Résoudre les problèmes de connexion. Pour cette raison, nous vous recommandons de connecter un dépôt GitHub uniquement aux projets définis dans une même organisation Azure DevOps.

Ajouter un lien à partir d’un élément de travail vers une validation, une demande de tirage ou un problème GitHub

1. Pour créer un lien vers un commit ou une demande de tirage, ouvrez l’élément de travail et choisissez Ajouter un lien sous la section Développement.

   

   Pour créer un lien vers un problème, choisissez l’onglet Liens, puis Ajouter un lien>Élément existant.

   

2. Dans la boîte de dialogue Ajouter un lien, sélectionnez l’un des types de liens GitHub, entrez l’URL de validation, de la demande de tirage ou du problème, puis choisissez OK.
   Ici, nous ajoutons un lien vers une demande de tirage GitHub.

   

   Azure Boards effectue une vérification pour vous assurer que vous avez entré un lien valide. Le référentiel GitHub lié doit être connecté au projet Azure Boards ; sinon, la validation échoue.

   Ici, nous ajoutons un lien vers un problème GitHub.

   

Afficher ou ouvrir des liens à partir de la section Développement

La section Développement du formulaire d’élément de travail répertorie les liens créés vers les validations et les demandes de tirage GitHub avec l’icône GitHub .

Choisissez le lien fourni pour ouvrir la validation ou la demande de tirage dans GitHub.

Afficher les objets GitHub sur le tableau Kanban

Une fois les annotations GitHub activées sur le tableau Kanban, vous pouvez ouvrir rapidement les validations, les demandes de tirage ou les problèmes GitHub liés pour plus de détails. Pour plus d’informations, consultez Personnaliser des cartes.

Étapes suivantes

Configurer les badges d’état

Articles connexes

• Ajouter ou supprimer des référentiels
• Modifier l’accès au référentiel GitHub
• Intégration d’Azure Boards-GitHub
• Utilisation des états de catégorie de workflow dans les backlogs et tableaux Azure Boards
• Lier des éléments de travail à des objets
• Résoudre les problèmes d’intégration de GitHub et Azure Boards