Compléter automatiquement les éléments de travail avec des demandes de tirage

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Lorsque vous liez un élément de travail à une demande de tirage, vous pouvez achever automatiquement ces éléments de travail lorsque vous terminez la demande de tirage. Vous pouvez également spécifier l’état du flux de travail pour faire passer l’élément de travail lors de la fusion de la pull request.

Cette automatisation simplifie votre flux de travail de développement en garantissant que les éléments de travail reflètent l’état actuel de vos modifications de code sans intervention manuelle.

Pour plus d’informations, consultez Créer, afficher et gérer les pull requests.

Prerequisites

Catégorie	Exigences
Permissions	- Pour afficher, suivre et modifier les éléments de travail : Afficher les éléments de travail dans ce nœud et Modifier les éléments de travail dans ce nœud autorisations définies sur Autoriser. Par défaut, le groupe des contributeurs dispose de ces permissions. Pour plus d’informations, consultez Définir les autorisations de suivi du travail. - Pour ajouter des balises aux éléments de travail : au niveau du projet, l’autorisation Créer une définition de balise est définie sur Autoriser. Par défaut, ce jeu d’autorisations est défini sur le groupe Contributeurs.
Niveaux d’accès	- Membre du projet. - Pour ajouter de nouvelles balises aux éléments de travail ou afficher ou suivre les demandes de tirage : au moins un accès de base (Basic). - Pour visualiser ou suivre des éléments de travail : au moins un accès de partie prenante (Stakeholder). Pour plus d’informations, consultez À propos des niveaux d’accès. - Tous les membres du projet, y compris ceux du groupe lecteurs , peuvent envoyer des e-mails contenant des éléments de travail.
Autorisations GitHub	Contributeur au dépôt GitHub.

Éléments de travail de saisie semi-automatique

Pour activer l’achèvement automatique des éléments de travail liés lorsque vous fusionnez une demande de tirage, cochez la case Terminer les éléments de travail liés après la fusion, comme illustré dans l’image suivante. Le système enregistre votre sélection comme valeur par défaut pour les demandes de tirage ultérieures.

Lorsque l'achèvement automatique ne se produit pas

Le système ne met pas automatiquement à jour l’état de l’élément de travail en catégories Terminé, Fermé ou Terminé pour le type d’élément de travail (WIT) dans les circonstances suivantes :

• Élément de travail déjà dans l’état résolu : l’élément de travail, dont WIT utilise le modèle de processus d’héritage, est déjà dans l’état résolu. Dans cette instance, le système ne met pas à jour l’état. Par exemple, si un bogue issu du processus Agile est dans un état Résolu, le système ne le fait pas passer à Fermé.
• Élément de travail déjà terminé : l’élément de travail est déjà dans la catégorie État Terminé . Aucune transition supplémentaire n’est requise.
• Les règles de flux de travail empêchent la transition : le WIT inclut des règles de champ de flux de travail qui empêchent l’élément de travail de passer à l’état suivant. Par exemple, une règle peut exiger que vous définissiez un autre champ lors de la fermeture de l’élément de travail.
• Configuration de flux de travail locale : pour les déploiements locaux et le modèle de processus hébergé Azure Boards, vous devez modifier le flux de travail pour spécifier des actions (élément ACTION ) à effectuer lors de la transition du flux de travail. Pour plus d’informations, consultez Modifier le workflow pour un WIT, spécifier des actions.

Pour plus d’informations sur la personnalisation des flux de travail, consultez Personnaliser votre expérience de suivi de travail.

Spécifier l’état du workflow des éléments de travail liés

Vous pouvez transitionner un élément de travail vers un état spécifique du flux de travail en saisissant les informations nécessaires dans la description du pull request. Précédez l’#ID d’un état de workflow valide pour l’élément de travail mentionné. Cette approche vous donne un contrôle précis sur la transition des éléments de travail lorsque vous fusionnez des modifications de code.

L’exemple suivant montre les récits utilisateur qui passent de l’un à l’état résolu et l’autre à l’état De révision . Le système marque également deux tâches comme Terminé.

Syntaxe des transitions d’état

Utilisez les modèles de syntaxe suivants dans votre description de demande de tirage pour spécifier les transitions d’état :

• Resolves #123 - Transitions de l’élément de travail 123 vers l’état résolu
• Fixes #456 - Fait passer l'élément de travail 456 vers l'état de finalisation approprié
• Closes #789 - Transitions de l’élément de travail 789 vers l’état Fermé
• Review #101 - Transitions de l’élément de travail 101 vers l’état de révision

Le système reconnaît les mots clés courants et applique la transition d’état appropriée en fonction de la configuration du flux de travail de votre type d’élément de travail.

Désactiver la finalisation automatique des éléments de travail associés

Pour désactiver la finalisation automatique des éléments de travail associés lorsque les utilisateurs terminent une pull request, procédez comme suit :

1. Accédez aux paramètres du projet>référentiels> pour sélectionner votre référentiel.
2. Sous l’onglet Paramètres, désactivez le bouton bascule pour la résolution des éléments de travail mentionnés lors des validations de commit.

Lorsque vous désactivez ce paramètre, le système n’autorise pas les mentions dans les commentaires de validation pour fermer les éléments de travail (par exemple, « Correctifs #123 »). Ce paramètre affecte à la fois l'achèvement des demandes de tirage et les mentions de commits directs.

Meilleures pratiques

Tenez compte de ces bonnes pratiques lors de l’utilisation de la saisie semi-automatique des éléments de travail :

• Passez en revue les états des éléments de travail : avant d’activer l’achèvement automatique, vérifiez que vos états d’élément de travail s’alignent sur les attentes du processus de travail de votre équipe.
• Utilisez des transitions d’état spécifiques : lorsque vous avez besoin d’un contrôle précis, utilisez la syntaxe de transition d’état dans les descriptions de pull request au lieu de compter sur le comportement par défaut.
• Tester les règles de flux de travail : vérifiez que les règles de flux de travail personnalisées n’empêchent pas les transitions automatiques d’état.
• Communiquez avec votre équipe : assurez-vous que tous les membres de l’équipe comprennent comment l'accomplissement automatique impacte le suivi des tâches.

Résolution des problèmes

Si les éléments de travail ne se complètent pas automatiquement comme prévu :

1. Vérifier les autorisations : vérifiez que vous disposez des autorisations nécessaires pour modifier les éléments de travail.
2. Passer en revue les règles de flux de travail : vérifiez qu’aucune règle de champ de flux de travail n’empêche la transition d’état.
3. Valider les liens des éléments de travail : vérifiez que les éléments de travail sont correctement liés à la pull request.
4. Vérifier l’état actuel : vérifiez que l’élément de travail n’est pas déjà dans un état terminé.
5. Passer en revue les paramètres du référentiel : vérifiez que la saisie semi-automatique est activée dans les paramètres du référentiel.

Contenu connexe

• Créer, afficher et gérer des demandes de tirage (pull requests)
• Personnaliser le workflow (processus d’héritage)
• Personnaliser votre expérience de suivi du travail
• Utilisation des états et des catégories d’état des workflows dans les backlogs et les tableaux
• Lier des éléments de travail à d’autres objets