Créer des tickets Jira depuis les workflows
Ouvrez un ticket Jira depuis un workflow — pour un score faible, un commentaire ou une action — et laissez l’action Polzy se fermer d’elle-même quand le ticket est terminé. Connectez Jira Cloud une fois avec un jeton d’API.
Sur cette page
Quand un retour demande l’intervention d’une équipe — un score qui baisse, une plainte sur un produit, une action dont quelqu’un est responsable — un workflow peut ouvrir un ticket Jira à ce sujet, rempli avec ce que Polzy sait. Si le workflow a aussi créé une action Polzy, l’action suit le ticket et se ferme d’elle-même une fois le ticket terminé. À la fin de ce guide, Jira sera connecté et un workflow ouvrira des tickets dans le projet de votre choix.
Jira est inclus dans l’offre Business et s’utilise depuis les workflows. Seul un Administrateur peut le connecter et créer des workflows.
Avant de commencer
Il vous faut :
- Un espace de travail sur l’offre Business, avec le rôle Administrateur.
- Intégrations et Flux de travail activés pour l’espace de travail, dans Paramètres → Général → Ce que fait cet espace de travail.
- Jira Cloud — un site que vous ouvrez à une adresse comme
https://acme.atlassian.net. Jira Data Center et Jira Server ne peuvent pas être connectés. - Le compte Atlassian au nom duquel les tickets seront créés. Un compte dédié, comme
automation@acme.com, évite que les tickets soient liés à une seule personne. Il doit pouvoir consulter et créer des tickets dans les projets que vous utiliserez — les écrans récents de Jira appellent les projets des espaces (spaces), et les tickets des work items. - Un jeton d’API pour ce compte (ci-dessous).
Créer un jeton d’API
- Connecté à Atlassian avec le compte qu’utilisera Polzy, ouvrez sa page de jetons d’API :
id.atlassian.com/manage-profile/security/api-tokens. - Choisissez Create API token — et non Create API token with scopes. Polzy se connecte à l’adresse même de votre site Jira, qu’un jeton avec des scopes ne peut pas ouvrir.
- Nommez-le Polzy, choisissez sa date d’expiration — un an au plus — et choisissez Create.
- Copiez le jeton. Atlassian ne l’affiche plus ensuite.
Atlassian explique les jetons dans Atlassian: Manage API tokens for your Atlassian account. À son expiration, Jira le refuse : créez-en un nouveau et collez-le dans Polzy avant cette date.
Connecter Jira à Polzy
- Dans la barre latérale, sous Automatiser, ouvrez Intégrations et choisissez l’onglet Disponibles.
- Trouvez Jira et choisissez Connecter.
- Dans Site Jira, saisissez l’adresse à laquelle vous ouvrez Jira, en commençant par
https://. - Dans E-mail du compte, saisissez l’adresse e-mail du compte Atlassian auquel appartient le jeton.
- Collez le jeton dans Jeton d’API.
- Choisissez Tester la connexion. Polzy répond Connected as suivi du nom du compte.
- Choisissez Connecter.
Le jeton est stocké chiffré. Une fois connecté, la ligne de Jira dans Intégrations propose Configurer la portée pour changer de compte ou de jeton, et Gérer pour sa page.
Ouvrir un ticket depuis un workflow
- Ouvrez Workflows et le workflow, ou créez-en un — par exemple à partir d’un déclencheur Réponse à une enquête ou Seuil de score.
- Sous Connecteurs dans Étapes installées, faites glisser Créer un ticket Jira · Jira sur le canevas, après l’étape qu’il doit suivre. Une ligne avec un cadenas signifie que Jira n’est pas encore connecté, ou nécessite une action : la choisir ouvre la page de Jira.
- Sous Projet, choisissez le projet. La liste affiche tous les projets que le compte peut voir, avec leur nom et leur clé.
- Sous Type de ticket, choisissez le type. La liste affiche les types propres à ce projet, hors sous-tâches ; Task est choisi au départ.
- Rédigez le Résumé : une ligne, jusqu’à 255 caractères. Tapez
{{pour insérer une valeur de l’exécution, comme le titre de l’enquête ou le score global. - Si vous le souhaitez, rédigez une Description. Une ligne vide commence un nouveau paragraphe.
- Si vous le souhaitez, ajoutez des Libellés, séparés par des virgules. Les libellés Jira ne peuvent pas contenir d’espaces : une espace devient un tiret.
L’étape transmet la clé du ticket, par exemple CS-142, sous la forme {{connector.issueKey}} et son adresse sous la forme {{connector.url}}, pour qu’une étape suivante — un message Slack, par exemple — puisse y renvoyer. Une Exécution d'essai parcourt le workflow sans ouvrir le ticket : l’étape indique ce qu’elle ferait. Seule une vraie exécution en crée un. Workflows explique les déclencheurs et les étapes.
Fermer l’action quand le ticket est terminé
Quand Créer un ticket Jira s’exécute après Créer une action dans la même exécution du workflow, le ticket est lié à cette action :
- Suivi dans. Le panneau de l’action affiche la clé du ticket, avec un lien vers Jira, et le dernier statut signalé par Jira.
- Fermée par Jira. Polzy interroge Jira sur le ticket au plus toutes les 10 minutes. Quand il atteint un statut de la catégorie « terminé » de Jira — quel que soit le nom que lui donne votre équipe — l’action passe à Terminé.
- Le statut seulement. Les commentaires et autres changements restent dans Jira. Une action fermée d’abord dans Polzy n’est plus interrogée.
Voir Actions pour le tableau où vit l’action.
Ce que Polzy envoie à Jira
Seulement ce que dit l’étape : le projet, le type de ticket, le résumé, la description et les libellés, avec les valeurs que vous insérez. Rien d’autre sur la réponse ou la personne ne quitte Polzy. Une réponse anonyme n’a pas de personne : les valeurs comme l’e-mail du répondant sont vides ; ce que quelqu’un a écrit n’est envoyé qu’après sa lecture de sécurité, et une réponse retenue pour examen part sous forme de texte de remplacement. Les réponses individuelles ne sont pas retenues par la taille minimale des groupes : pensez à qui peut lire le projet avant de mettre les mots des gens dans un ticket.
Dépannage
- The Jira site must start with https://. Saisissez l’adresse complète, comme
https://acme.atlassian.net. - The account email is required. Saisissez l’adresse e-mail du compte auquel appartient le jeton.
- Jira refused the credentials (401). L’e-mail et le jeton ne correspondent pas, le jeton a expiré ou a été révoqué, ou c’est un jeton avec des scopes. Créez un nouveau jeton comme ci-dessus, choisissez Configurer la portée sur la ligne de Jira dans Intégrations, collez-le et Enregistrer. Une exécution qui rencontre cette erreur fait passer Jira à Nécessite une action.
- Jira refused the credentials (403). Le compte n’a pas le droit de faire cela dans ce projet. Donnez-lui le droit d’y consulter et d’y créer des tickets.
- Jira answered 400: suivi d’un champ qui is required. Le type de ticket exige un champ que l’étape ne remplit pas, comme un composant. Rendez le champ facultatif pour ce type dans Jira, ou choisissez un autre type.
- Jira answered 404. Le projet a été supprimé, ou le compte ne peut plus le voir.
- La liste Projet est un simple champ. Le compte ne voit aucun projet, ou Jira n’a pas pu être joint. Vérifiez les accès du compte.
- This step names no project ou The issue has no summary. Renseignez le Projet et le Résumé de l’étape.
- Jira is needs_attention and cannot be used (dans une exécution). La connexion nécessite une action. Reconnectez-la, puis relancez.
- L’action ne se ferme pas. L’étape Jira ne s’est pas exécutée après Créer une action dans la même exécution, le statut du ticket n’est pas dans la catégorie « terminé » de Jira, ou la connexion nécessite une action — les vérifications sont suspendues jusqu’à ce que ce soit réglé.
Bon à savoir
- Une connexion, tous les projets. Chaque étape choisit son projet parmi ceux que voit le compte : une seule connexion sert toutes les équipes.
- Qui est le rapporteur ? Le compte auquel appartient le jeton.
- Une étape peut-elle ouvrir deux fois le même ticket ? Non. Une étape relancée après un plantage réutilise ce qu’elle a créé la première fois.
Liens utiles
Articles liés
Les membres connectés peuvent demander à Polzy ou écrire à l’équipe depuis Support. Notre délai de réponse dépend de votre forfait.