doc-locale/fr-fr/integration/jira/issues.md
{{< details >}}
{{< /details >}}
Vous pouvez gérer les tickets Jira directement dans GitLab. Vous pouvez ensuite référencer les tickets Jira par ID dans les commits et les merge requests GitLab. Les ID de tickets Jira doivent être en majuscules.
Grâce à cette intégration, vous pouvez créer des références croisées vers des tickets Jira lorsque vous travaillez dans des tickets GitLab, des merge requests et Git. Lorsque vous mentionnez un ticket Jira dans un ticket GitLab, une merge request, un commentaire ou un commit :
Par exemple, lorsque ce commit fait référence au ticket Jira GIT-1 :
git commit -m "GIT-1 this is a test commit"
GitLab ajoute à ce ticket Jira :
Une référence dans la section liens Web.
Un commentaire dans la section Activité au format suivant :
USER mentioned this issue in RESOURCE_NAME of [PROJECT_NAME|COMMENTLINK]:
ENTITY_TITLE
USER : nom de l'utilisateur ou de l'utilisatrice qui a mentionné le ticket Jira, avec un lien vers son profil GitLab.RESOURCE_NAME : Type de ressource (par exemple, un commit GitLab, un ticket ou une merge request) qui a référencé le ticket Jira.PROJECT_NAME : nom du projet GitLab.COMMENTLINK : lien vers l'endroit où le ticket Jira est mentionné.ENTITY_TITLE : titre du commit GitLab (première ligne), du ticket ou de la merge request.Une seule référence croisée apparaît dans Jira par ticket GitLab, merge request ou commit. Par exemple, plusieurs commentaires sur une merge request GitLab faisant référence à un ticket Jira ne créent qu'une seule référence croisée vers cette merge request dans Jira.
Vous pouvez désactiver les commentaires sur les tickets.
{{< details >}}
{{< /details >}}
Grâce à cette intégration, vous pouvez empêcher la fusion des merge requests si elles ne font pas référence à un ticket Jira. Pour activer cette fonctionnalité :
Après avoir activé cette fonctionnalité, une merge request qui ne fait pas référence à un ticket Jira associé ne peut pas être fusionnée. La merge request affiche le message To merge, a Jira issue key must be mentioned in the title or description.
{{< history >}}
{{< /history >}}
Vous pouvez configurer des règles personnalisées pour la façon dont GitLab fait correspondre les clés de tickets Jira en définissant :
Lorsque vous ne configurez pas de règles personnalisées, le comportement par défaut est utilisé.
{{< history >}}
{{< /history >}}
Vous pouvez utiliser une expression régulière (regex) pour faire correspondre les clés de tickets Jira. Le modèle regex doit suivre la syntaxe RE2.
Pour définir un modèle regex pour les clés de tickets Jira :
Pour plus d'informations, consultez la documentation Atlassian.
{{< history >}}
{{< /history >}}
Vous pouvez utiliser un préfixe pour faire correspondre les clés de tickets Jira. Par exemple, si votre clé de ticket Jira est ALPHA-1 et que vous définissez un préfixe JIRA#, GitLab fait correspondre JIRA#ALPHA-1 plutôt que ALPHA-1.
Pour définir un préfixe pour les clés de tickets Jira :
Si vous avez configuré des ID de transition GitLab, vous pouvez fermer un ticket Jira directement depuis GitLab. Utilisez un mot déclencheur suivi d'un ID de ticket Jira dans un commit ou une merge request. Lorsque vous poussez un commit contenant un mot déclencheur et un ID de ticket Jira, GitLab :
Par exemple, utilisez l'un de ces mots déclencheurs pour fermer le ticket Jira PROJECT-1 :
Resolves PROJECT-1Closes PROJECT-1Fixes PROJECT-1Le commit ou la merge request doit cibler la branche par défaut de votre projet. Vous pouvez modifier la branche par défaut de votre projet dans les paramètres du projet.
Lorsque le nom de votre branche correspond à l'ID du ticket Jira, Closes <JIRA-ID> est automatiquement ajouté à votre modèle de merge request existant. Si vous ne souhaitez pas fermer le ticket, désactivez la fermeture automatique des tickets.
Considérez cet exemple :
PROJECT-7 pour demander une nouvelle fonctionnalité.Closes PROJECT-7.Lorsque vous configurez les transitions automatiques de tickets, vous pouvez faire passer un ticket Jira référencé au prochain statut disponible avec la catégorie Terminé. Pour configurer ce paramètre :
Pour les workflows avancés, vous pouvez spécifier des ID de transition Jira personnalisés :
Utilisez la méthode correspondant à votre abonnement Jira :
https://yourcompany.atlassian.net/rest/api/2/issue/ISSUE-123/transitions, en utilisant un ticket dans l'état « ouvert » approprié.L'ID de transition peut varier selon les workflows (par exemple, un bug plutôt qu'une story), même si le statut vers lequel vous effectuez la transition est identique.
Consultez les instructions de configuration de GitLab.
Sélectionnez le paramètre Activer les transitions Jira.
Sélectionnez l'option Transitions personnalisées.
Saisissez vos ID de transition dans le champ de texte. Si vous insérez plusieurs ID de transition (séparés par , ou ;), le ticket passe à chaque état, l'un après l'autre, dans l'ordre que vous spécifiez. Si une transition échoue, la séquence est interrompue.
GitLab peut créer des références croisées entre les commits sources ou les merge requests et les tickets Jira sans ajouter de commentaire au ticket Jira :