Intégration Jira Software n8nAutomatiser Jira Software avec n8n.

Chaque modification laisse une ligne dans l'historique du ticket, et cette opération ramène cet historique dans le workflow : quel champ a bougé, et à quel moment.

• Issue Key : la référence telle qu'elle s'affiche dans Jira, du genre OPS-12, souvent {{ $json.key }} quand un trigger la fournit.
• Return All : coché, n8n parcourt toutes les pages de l'historique ; décoché, Limit plafonne le nombre d'entrées ramenées.

L'opération dépose un ticket et le renvoie avec la clé que Jira vient de lui attribuer, celle que les nœuds suivants réutilisent pour commenter ou compléter.

• Project : choisi dans la liste ou donné par son ID, il décide de la destination du ticket.
• Issue Type : sélectionné de la même façon, parmi les types que le projet propose.
• Summary : la ligne unique qui devient le titre.
• Additional Fields : l'endroit où vivent Description, Assignee, Priority, Parent Issue Key et Custom Fields quand un titre ne suffit pas.

La suppression est définitive, et le nœud oblige à trancher le sort des sous-tâches au lieu de décider à ta place.

• Issue Key : le ticket qui disparaît.
• Delete Subtasks : requis ici, pour que le workflow dise explicitement ce qu'il advient des enfants plutôt que de s'en remettre à une valeur par défaut.

Quand le workflow n'a que la clé sous la main, situation habituelle juste après un webhook, cette opération va chercher le reste du ticket en JSON.

• Issue Key : la clé du ticket à lire.
• Simplify : renvoie une version allégée de la réponse plutôt que la charge brute, ce qui garde les expressions lisibles derrière.
• Fields : dans Additional Fields, une liste séparée par des virgules pour restreindre la réponse ; *all ramène tout, et un champ préfixé d'un moins est exclu.

Ici, aucune clé à fournir : c'est la requête qui définit l'ensemble, et tous les tickets qui y répondent reviennent.

• JQL : dans Options, l'expression en langage de recherche Jira qui délimite le lot, la même syntaxe que dans la barre de recherche.
• Return All : coché pour un export complet, décoché pour s'arrêter à Limit.
• Expand : ajoute des blocs à chaque ticket, comme changelog ou transitions, quand la liste seule reste trop maigre.

C'est Jira qui envoie le mail : l'opération dépose une notification sur un ticket dans la file d'envoi de Jira, adressée aux personnes désignées.

• Issue Key : le ticket dont il est question.
• Notification Recipients : les destinataires, via Reporter, Assignee, Watchers, Voters, User Names or IDs et Group Names or IDs, ou en JSON brut quand JSON Parameters est activé.
• Subject : dans Additional Fields, à côté de Text Body et HTML Body ; laissé vide, Jira reprend la clé et le résumé du ticket.

Avant de bouger un ticket, encore faut-il savoir où il a le droit d'aller. L'opération renvoie les transitions disponibles compte tenu du statut actuel.

• Issue Key : le ticket à inspecter.
• Transition ID : dans Additional Fields, pour interroger une transition précise au lieu de la liste entière.
• Expand : accepte transitions.fields, qui décrit les champs de chaque écran de transition, les champs masqués exclus.

Modifier un ticket champ par champ, sans toucher au reste : c'est ce qui rend l'opération sûre sur des tickets où des gens travaillent en même temps.

• Issue Key : le ticket à modifier.
• Update Fields : la collection qui contient Summary, Description, Assignee, Priority, Labels, Issue Type, Parent Issue Key et Custom Fields.
• Status : rangé lui aussi dans Update Fields, et c'est par lui qu'un workflow fait avancer un ticket, faute d'opération de transition séparée.

Les fichiers circulent dans n8n sous forme de données binaires, et cette opération en pousse un sur un ticket.

• Issue Key : le ticket qui reçoit le fichier.
• Input Binary Field : le nom du champ binaire de l'item entrant qui contient le fichier, tel que le nœud précédent l'a nommé.

Un seul fichier, retrouvé par son identifiant propre : le ticket auquel il est accroché n'intervient pas dans l'appel.

• Attachment ID : l'ID de la pièce jointe, en général récupéré à une étape précédente.
• Download : requis, et il fonctionne de pair avec le champ de sortie ci-dessous.
• Put Output File in Field : le nom du champ binaire de sortie dans lequel le fichier est placé.

Vue depuis le ticket cette fois : tout ce qui y est accroché revient en un seul appel.

• Issue Key : le ticket dont on liste les pièces jointes.
• Download et Put Output File in Field : requis tous les deux, le second nommant le champ binaire de sortie où atterrissent les fichiers.
• Return All : coché pour le lot entier, décoché pour s'arrêter à Limit.

Rien d'autre à fournir que l'identifiant du fichier : le ticket auquel il appartenait reste en place, seule la pièce jointe part.

• Attachment ID : l'ID de la pièce jointe à retirer.

Le commentaire, c'est là qu'une automatisation parle aux humains du ticket. Cette opération en publie un dessous.

• Issue Key : le ticket auquel le commentaire se rattache.
• Comment : le texte lui-même.
• Document Format (JSON) : avec JSON Parameters activé, le corps part au format Atlassian Document Format au lieu du texte simple.
• Use Wiki Markup : dans Options, fait interpréter la syntaxe wiki du commentaire ; la valeur reste fausse tant que tu ne la changes pas.

Relire un commentaire précis demande les deux identifiants : celui du ticket, puis celui du commentaire à l'intérieur.

• Issue Key : l'ID ou la clé du ticket qui porte le commentaire.
• Comment ID : l'ID du commentaire à lire.
• Expand : dans Options, accepte Rendered Body, qui renvoie le commentaire rendu en HTML plutôt que tel qu'il est stocké.

Tout le fil de discussion d'un ticket dans un seul tableau, ce qui est exactement la matière d'une étape de synthèse.

• Issue Key : l'ID ou la clé du ticket dont on lit le fil.
• Order By : Created Ascending ou Created Descending, selon que la réponse la plus récente doit ouvrir ou fermer la liste.
• Return All : coché pour un fil long, décoché pour s'arrêter à Limit.

Retirer un commentaire est définitif, et contrairement à la version pièce jointe, il faut les deux identifiants pour désigner la cible.

• Issue Key : l'ID ou la clé du ticket.
• Comment ID : l'ID du commentaire à retirer.

Réécrire sur place évite d'empiler les corrections, et garde un fil lisible quand une même ligne de statut est rafraîchie plusieurs fois par jour.

• Comment ID : le commentaire à réécrire, aux côtés de l'Issue Key sous lequel il se trouve.
• Comment : le texte de remplacement.
• Document Format (JSON) : la variante Atlassian Document Format, utilisée quand JSON Parameters est activé.

L'arrivée d'une personne peut se terminer dans Jira : le nœud crée le compte au lieu de le laisser sur une liste de tâches administratives.

• Username, Email Address et Display Name : les trois champs requis, et un champ marqué requis bloque l'exécution du nœud tant qu'il reste vide.
• Password : dans Additional Fields ; laissé vide, un mot de passe aléatoire est généré.
• Notification : envoie le mail de confirmation.

Le miroir du départ, avec une surprise : aucun champ n'est requis, et c'est un champ optionnel qui désigne le compte.

• Account ID : l'identifiant du compte à supprimer, le seul champ que l'opération lit.

Un identifiant de compte d'un côté, une personne de l'autre : nom affiché, adresse, et sur demande les groupes qui vont avec.

• Account ID : l'identifiant du compte à récupérer.
• Expand : dans Additional Fields, groups ajoute tous les groupes auxquels la personne appartient, applicationRoles ajoute les applications auxquelles elle accède.