Jira peut automatiquement mettre à jour un ticket Zendesk Support lié à un problème Jira quand le statut du problème change dans le workflow Jira.
Un workflow Jira est le jeu de statuts et de transitions d’un problème au cours de son cycle de vie. Vous pouvez configurer un workflow pour automatiquement mettre à jour un ticket lié lorsqu’un problème Jira passe d’un statut à un autre dans le workflow.
Par exemple, quand un ingénieur change le statut d’un problème Jira de « En cours » à « Terminé », Jira peut ajouter une note interne au ticket Zendesk lié afin d’avertir l’agent. L’agent peut ensuite avertir l’utilisateur.
Jira peut aussi automatiquement avertir l’agent qu’un développeur travaille sur un problème en ajoutant une note interne au ticket une fois que l’ingénieur change le statut du problème de « À faire » à « En cours ».
Cet article aborde les sujets suivants :
Fonctionnement des mises à jour des tickets
Les tickets Zendesk sont mis à jour à partir des workflows Jira à l’aide des post-fonctions. Les post-fonctions sont une fonctionnalité du workflow Jira utilisée pour effectuer un traitement supplémentaire après l’exécution d’une transition de workflow. Par exemple, une post-fonction peut mettre à jour les champs du problème après une transition.
Les post-fonctions sont ajoutées aux transitions du workflow, pas aux statuts. Elles s’exécutent une fois une transition terminée. Certaines post-fonctions sont essentielles et ne peuvent pas être supprimées d’une transition ni réagencées. Cependant, vous pouvez insérer des post-fonctions facultatives entre celles qui sont obligatoires. L’intégration Zendesk ajoute « Notify Zendesk Ticket » à la liste des post-fonctions facultatives dans Jira.
Consultez la documentation Atlassian pour en savoir plus sur les post-fonctions.
Configuration d’un workflow pour mettre les tickets à jour
- Dans Jira, cliquez sur l’icône Paramètres (engrenage) dans la barre latérale sur la gauche et sélectionnez Issues.
- À la page Issues, sélectionnez Workflows dans la barre latérale sur la gauche.
- Cherchez le workflow utilisé pour gérer les problèmes liés à des tickets Zendesk et cliquez sur Edit sur la droite du workflow.Remarque – Jira ne vous permet pas de modifier un workflow live. Vous devez le modifier en mode brouillon.
- Dans la colonne Transitions, cliquez sur le nom de la transition que vous voulez utiliser pour déclencher les mises à jour de tickets.
- Cliquez sur l’onglet Post Functions, puis sur le lien Add post function sur la droite.
- Sélectionnez la post-fonction Notify Zendesk Support dans la liste et cliquez sur Add.
- Configurez les paramètres de mise à jour de tickets, puis cliquez sur Add.
Vous pouvez modifier le statut du ticket, ajouter un commentaire public ou interne, ajouter des marqueurs et inclure des balises de commentaires dans le texte du commentaire.
Remarque – La suppression des marqueurs n’est pas prise en charge.
- En regard de la post-fonction Zendesk Support, sélectionnez l’icône de déplacement vers le bas pour la placer sous la post-fonction « Add a comment to an issue if one is entered during a transition ».
- En haut de la page, cliquez sur Publish Draft, puis sur Publish.
Nous vous conseillons d’enregistrer une copie de sauvegarde à l’invite.
Important : vos modifications entreront en vigueur uniquement quand vous publierez le brouillon.
Modification des paramètres de mise à jour de tickets
Vous pouvez modifier ces paramètres à tout moment.
- Dans Jira, cliquez sur l’icône Paramètres (engrenage) dans le volet de gauche et sélectionnez Issues.
- À la page Issues, sélectionnez Workflows dans la barre latérale sur la gauche.
- Cliquez sur Edit sur la droite du workflow qui contient la transition que vous souhaitez modifier.
- Sélectionnez la transition et cliquez sur l’onglet Post Functions.
- Cliquez sur l’icône de modification (crayon) sur la droite de la post-fonction qui met le ticket à jour.Remarque – Vous pouvez aussi supprimer la post-fonction en cliquant sur l’icône de suppression (X).
- Apportez vos modifications, puis cliquez sur Mettre à jour.
- Cliquez sur Publish Draft, puis sur Publish.
Balises de commentaires prises en charge
Vous pouvez saisir des balises de contenu dynamique dans le champ de commentaires de la post-fonction. Par exemple, vous pouvez saisir la balise suivante dans le champ commentaire d’une fonction de transition Terminé :
Issue {{issue.key}} has been resolved.
Issue QA-4 has been resolved.Pour en savoir plus, consultez Utilisation des balises.
L’intégration JIRA prend en charge les balises spécifiques aux problèmes, aux transitions et aux utilisateurs. Les balises sont répertoriées dans les tableaux ci-dessous. Si les balises pour les champs du profil d’utilisateur ne sont pas rendues, vérifiez les paramètres de visibilité du profil dans Jira, car la visibilité de nombreux champs est restreinte par défaut.
| Balise | Description |
|---|---|
| issue.id | ID interne du problème. |
| issue.key | Clé du problème. Exemple : QA-4. |
| issue.fields.summary | Résumé du problème. |
| issue.fields.description | Description du problème. |
| issue.fields.issuetype.name | Type de problème. |
| issue.fields.issuetype.description | Description du type de problème. |
| issue.fields.creator.name | Nom d’utilisateur de la personne qui a créé le problème. |
| issue.fields.creator.emailAddress | Adresse e-mail de la personne qui a créé le problème. |
| issue.fields.creator.displayName | Nom d’affichage de la personne qui a créé le problème. |
| issue.fields.creator.timeZone | Fuseau horaire de la personne qui a créé le problème. |
| issue.fields.reporter.name | Nom de la personne qui a signalé le problème. |
| issue.fields.reporter.emailAddress | Adresse e-mail de la personne qui a signalé le problème. |
| issue.fields.reporter.displayName | Nom d’affichage de la personne qui a signalé le problème. |
| issue.fields.reporter.timeZone | Fuseau horaire de la personne qui a signalé le problème. |
| issue.fields.assignee.name | Nom d’utilisateur de la personne affectée au problème. |
| issue.fields.assignee.emailAddress | Adresse e-mail de la personne affectée au problème. |
| issue.fields.assignee.displayName | Nom d’affichage de la personne affectée au problème. |
| issue.fields.assignee.timeZone | Fuseau horaire de la personne affectée au problème. |
| issue.fields.user.name | Nom d’utilisateur de l’utilisateur. |
| issue.fields.user.emailAddress | Adresse e-mail de l’utilisateur. |
| issue.fields.user.displayName | Nom d’affichage de l’utilisateur. |
| issue.fields.user.timeZone | Fuseau horaire de l’utilisateur. |
| issue.fields.created | Date et heure auxquelles le problème a été créé. |
| issue.fields.updated | Date et heure auxquelles le problème a été mis à jour. |
| issue.fields.priority.name | Nom de la priorité du problème. |
| issue.fields.project.name | Nom du projet du problème. |
| issue.fields.project.key | Clé du projet du problème. Par exemple : AQ |
| issue.fields.lastViewed | Date et heure de la dernière consultation du problème. |
| issue.fields.fixVersions.name | Nom de la ou des versions corrigées.* |
| issue.fields.fixVersions.description | Description de la ou des versions corrigées.* |
| issue.fields.fixVersions.releaseDate | Date de sortie de la ou des versions corrigées.* |
| issue.fields.versions.name | Nom de la ou des versions concernées.* |
| issue.fields.versions.description | Description de la ou des versions concernées.* |
| issue.fields.versions.releaseDate | Date de sortie de la ou des versions concernées.* |
| issue.fields.components.name | Nom du ou des composants.* |
| issue.fields.components.description | Description du ou des composants.* |
| issue.fields.duedate | Date d’échéance. |
| issue.fields.timespent | Temps passé. |
| issue.fields.timeoriginalestimate | Estimation initiale du temps nécessaire pour résoudre le problème. |
| issue.fields.resolution.name | Nom de la résolution du problème. |
| issue.fields.resolution.description | Description complète de la résolution du problème. |
| issue.fields.resolutiondate | Date de la résolution du problème. |
| issue.fields.watches.watchcount | Nombre de personnes suivant le problème. |
| issue.fields.labels | Libellé avec lequel le problème a un rapport. |
| issue.fields.environment | Environnement matériel ou logiciel du problème. |
| issue.fields.votes.votes | Nombre de votes du problème. |
| issue.last_comment | Dernier commentaire au sujet du problème. |
*Liste séparée par des virgules si plusieurs éléments sont sélectionnés.
| Balise | Description |
|---|---|
| transition.to_status | Statut auquel est passé un problème. Par exemple : Terminé |
| transition.from_status | Statut d’un problème avant la transition. Par exemple : En cours |
| transition.transitionName | Nom de la transition qui a eu lieu. |
| transition.workflowName | Nom du workflow. |
| Balise | Description |
|---|---|
| user.key | Nom d’utilisateur de la personne qui a provoqué la transition. Cela s’applique uniquement aux utilisateurs de Jira Server. |
| user.displayName | Nom d’affichage de l’utilisateur. Cela s’applique uniquement aux utilisateurs de Jira Cloud. |