Jira

Jira est un connecteur : il relie une application MeDo à un site Jira Cloud, ce qui permet à l'application de lire les projets, les tableaux, les sprints, les tickets et les commentaires, et de créer ou modifier des tickets sur ce site. L'application travaille avec les projets et les tickets accessibles au compte connecté.

#Ce que vous pouvez construire

• Un tableau de bord de sprint privé. Listez les tickets ouverts d'un projet avec leur statut, leur assigné et leur échéance.
• Une page de signalement de bug. Transformez la soumission d'un visiteur en ticket Jira dans un projet choisi, avec l'e-mail du rapporteur dans la description.
• Un outil de notes de version. Choisissez une version, listez les tickets corrigés dans ce sprint et publiez le résumé en commentaire sur chaque ticket.
• Un tableau de triage. Affichez les tickets non assignés et assignez-en un à un collègue après confirmation.

Jira convient lorsque le travail est déjà suivi sous forme de tickets Jira et que l'application doit ajouter une vue ciblée ou une entrée structurée. Ce n'est pas un produit de reporting : les listes de tickets sont paginées, voir Limites.

#Exemples de construction

Copiez l'un de ces textes dans la zone de prompt. Le premier est le point de départ minimal et ne fait que lire des données.

Use @Jira to build a private sprint dashboard that only I can sign in to, listing open issues in my Scrum project with status, assignee, and due date.

Use @Jira to build a bug-report page where a visitor's submission creates a Jira issue in the backlog with the reporter's email in the description.

Use @Jira to build a release-note tool: I pick a version, it lists the issues fixed in that sprint, and I post the summary back as a Jira comment on each issue.

Use @Jira to build a triage board that shows unassigned issues and lets me assign one to a teammate after I confirm the change.

#Préparer et connecter

Vous avez besoin d'un site Jira Cloud et d'un compte qui voit déjà le projet visé. Aucun jeton d'API ni enregistrement d'application Atlassian n'est nécessaire.

1. Ouvrez Skills & Connectors dans la barre latérale et recherchez Jira.
2. Ouvrez la carte Jira et cliquez sur Connect.
3. Saisissez le sous-domaine de votre site — la partie avant .atlassian.net, par exemple acme pour acme.atlassian.net.
4. Connectez-vous à Atlassian et approuvez l'accès demandé par MeDo.
5. Le bouton devient Connected.

Si vous commencez à construire avant de vous connecter, MeDo affiche un bouton de connexion Jira sous sa réponse. Vous pouvez vous connecter à cet endroit.

Si votre compte Atlassian donne accès à plusieurs sites, vérifiez le site utilisé après la connexion : demandez à l'application de lister les sites visibles par la connexion et reconnectez-vous avec le bon sous-domaine si nécessaire.

#Utilisation dans votre application

• L'application utilise votre site connecté, pas le compte Atlassian de chaque visiteur. Les visiteurs n'ont pas besoin de compte Jira. Placez les vues de tickets internes derrière la connexion de votre application et limitez-les aux personnes prévues.
• Choisissez le projet dans le prompt, ou laissez l'application proposer un sélecteur. Dans les deux cas, l'application doit travailler sur le projet que vous avez choisi, pas sur celui qu'un visiteur sélectionne.
• Les listes de tickets sont des pages, pas des totaux. Chaque page contient 50 tickets. Demandez à l'application d'afficher une page avec un moyen clair d'en charger davantage, et évitez de présenter une page comme tout le backlog.
• Les types et les statuts sont résolus par identifiant. Un site dans une autre langue affiche ses propres noms de types et de statuts ; l'application les choisit donc dans les listes du site plutôt que d'utiliser des noms anglais figés.
• Les changements de statut suivent le workflow du projet. L'application ne propose que les transitions disponibles pour ce ticket à cet instant, et utilise leur identifiant.
• L'assignation utilise l'identifiant de compte. Les noms affichés et les e-mails ne servent que de repli, car un site peut masquer les e-mails des membres.
• Les écritures sont confirmées avant. MeDo prévisualise le nouveau ticket, ou le champ et la nouvelle valeur, avant d'enregistrer. Cela couvre la création et la modification d'un ticket, une transition, une assignation, un commentaire et la liaison de deux tickets.
• Les commentaires et les descriptions acceptent le Markdown. L'application convertit le Markdown au format de document de Jira.
• Les notes internes appartiennent à l'application. Les notes et l'état de suivi sans champ Jira correspondant vivent dans les tables de votre application, liées au ticket réel.

#Limites et dépannage

« Connection required » apparaît dans l'application. Demandez au propriétaire de l'application d'ouvrir la carte du connecteur, de cliquer sur Connect, puis rechargez.

Un nouveau ticket est refusé pour son type. Sur un site localisé, envoyez le type par son identifiant numérique issu de la liste des types du site, et non par un nom anglais comme « Task ».

L'assignation semble sans effet. Une assignation réussie renvoie une réponse vide. Relisez le ticket pour confirmer l'assigné.

Une transition est refusée. Le workflow de ce ticket ne la propose pas à cet instant. Listez les transitions disponibles du ticket et utilisez l'un de leurs identifiants.

Un ticket n'a pas été mis à jour. Les écritures ne sont pas retentées automatiquement. Ouvrez le ticket dans Jira, vérifiez ce qui s'est réellement passé, puis répétez l'opération.

#Voir aussi

• Catalogue de connecteurs — les autres connecteurs et leur usage.
• Skills et Connecteurs — comment les Skills sont appelés, tarifés et limités.
• Gérer l'accès et les rôles — restreignez qui peut lire et modifier les données connectées.