Disponible pour : Jira Cloud, Jira Server (On-Premise) et Datacenter (également protégé par LDAP)
Configuré par : le responsable d’équipe de Miro et l’administrateur du système Jira ayant les autorisations d’administration du projet
⚠️ Si des problèmes techniques surgissent, veuillez vous référer à notre article sur les éventuels problèmes et sur comment les résoudre.
💡 En savoir plus sur les cartes Jira dans la FAQ sur les cartes Jira et l’article sur la configuration d’un webhook pour les cartes Jira.
Configuration de Jira et de Miro
✏️ Notez que les menus de Jira peuvent être différents en fonction de la version de Jira que vous utilisez ; cela dit, le flux général devrait être le même. Les instructions ci-dessous peuvent également être trouvées sur cette page d’aide d’Atlassian (disponible uniquement en anglais).
Étape 1 - Lien d’application
Commencez par créer un lien avec l’application et configurez-le.
- Rendez-vous dans Paramètres Jira > Produits > Intégrations > Liens d’application > Créer un lien :
Notez que l’interface de Jira peut différer en fonction de votre version de Jira. - Choisissez lien direct de l’application et saisissez https://miro.com/ dans le champ URL de l’application.
Important : vous devez entrer l’URL dans ce format exact. Cliquez sur Continuer.
Créer le lien
- Dans le menu suivant, cliquez à nouveau simplement sur Continuer.
- Dans le menu Réviser le lien, vérifiez bien que l’URL est toujours exactement https://miro.com/ et saisissez le nom de l’application de votre choix. Faites défiler la page et tout en bas, cochez la case Créer un lien entrant. Ignorez le reste des champs et cliquez sur Continuer.
Seul le champ Nom de l’application doit être rempli.
- Vous verrez ici les champs pour les valeurs Miro. Pour obtenir les valeurs, connectez-vous dans Miro et rendez-vous dans les paramètres de l’équipe > Applications et intégrations > Cartes Jira.
Si vous n’avez pas les cartes Jira dans votre liste d’applications, faites défiler jusqu’au haut de la section, cliquez sur Installer des applications et procédez à l’installation de l’application à partir de la Marketplace de Miro. Une fois que vous voyez les cartes Jira dans la liste, cliquez pour les ouvrir.
L’onglet du plugin s’ouvrira et vous pouvez voir l’étape 1 pour obtenir les valeurs requises :
Valeurs des cartes Jira
Copiez les valeurs et ajoutez-les au menu Atlassian Réviser le lien. - Vous verrez le message de traitement pendant un instant :
La dernière étape de la création du lien
Et vous avez terminé du côté Atlassian. Le lien apparaîtra dans la liste de vos liens d’application.
Étape 2 - Connexion
Retournez à la page Miro et choisissez l’une des deux options : créer un webhook manuellement ou automatiquement. En fonction de votre choix, décochez l’option appropriée. Pour plus d’informations, consultez cet article. Nous vous recommandons vivement d’utiliser le webhook automatique pour ne pas avoir à le réinitialiser en cas de grosses mises à jour du plugin.
Enfin, saisissez votre URL Jira et cliquez sur Connect (Connecter) :
Connexion des cartes Jira
Pour obtenir l’URL de Jira, veuillez copier lURL de base de votre instance Jira. Nous prenons en charge les formats suivants :
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Si votre URL Jira n’est pas acceptée, référez-vous à cet article (disponible uniquement en anglais). Veuillez également vérifier que Miro dispose d’un accès suffisant à votre Jira pour établir la connexion.
Vous avez maintenant connecté votre instance Jira à votre équipe Miro.
Autorisation de l’utilisateur
Une fois l’intégration connectée, chacun de vos utilisateurs finaux doit connecter son profil Jira personnel pour établir les autorisations appropriées. Cela garantit que l’accès de chaque utilisateur du côté Miro est exactement le même que du côté de votre instance Jira. Lorsque les utilisateurs finaux essaient d’importer ou de modifier une carte Jira pour la première fois, il leur sera demandé de se connecter à Jira à l’aide de leurs identifiants individuels.
Une fois cela fait, les utilisateurs peuvent ajouter des tâches sous forme de cartes sur le tableau blanc. Toute modification apportée dans Jira est répercutée dans les cartes Jira sur le tableau.
✏️ Si un utilisateur n’a pas d’identifiants Jira et qu’il a accès au tableau sur lequel la carte a été ajoutée, il verra le titre de la carte, le type de problème, la priorité, l’assigné et tous les attributs configurés pour s’afficher sur la carte Jira. Cependant, il ne pourra pas développer la carte pour voir les autres attributs et il ne pourra pas modifier son contenu à moins d’en avoir l’autorisation. Si l’utilisateur ne se connecte pas avec ses identifiants Jira, il ne verra pas l’avatar du destinataire et l’aspect général de la carte sera différent.
Utiliser une instance Jira pour plusieurs équipes Miro (facultatif)
Notez que les cartes sont installées au niveau de l’équipe. Si vous utilisez notre forfait Enterprise et que vous avez plusieurs équipes, vous devrez donc recommencer l’étape 2 pour chacune des équipes que vous souhaitez connecter. Le lien d’application existant sera utilisé pour toutes.
Une fois votre équipe connectée à une instance Jira, un nouveau WebHook est créé dans vos WebHooks Jira pour l’équipe Miro que vous avez connectée. Créer un WebHook permet d’établir le canal pour les demandes de mise à jour.
⚠️ Si vous prévoyez de connecter plusieurs équipes, nous vous recommandons vivement d’aller sur votre page Jira WebHooks et de modifier chaque WebHook nouvellement créé pour leur donner un nom unique et éviter tout risque de confusion.
La connexion de plusieurs instances Jira à une seule équipe Miro n’est pas prise en charge.
Désinstallation du plugin
Allez dans Team Settings (Paramètres d’équipe) > Apps & Integrations (Applications et intégrations) > Jira Cards (cartes Jira) et désactivez votre URL de Jira à l’étape 2. Cliquez ensuite sur Uninstall for team (Désinstaller pour l’équipe).
Désinstallation des cartes Jira
💡 N’oubliez pas de jeter un œil à l’article principal sur l’utilisation de cartes Jira !