Disponible pour : Jira Cloud, Jira Server (On-Premise) et Datacenter (également protégé par
LDAP)Configuré par : l’admin d’équipe Miro et l’admin système Jira avec des autorisations d’administration du projet
⚠️ Si des problèmes techniques surviennent, consultez notre article sur les problèmes éventuels et comment les résoudre.
💡 Pour en savoir plus sur les cartes Jira, consultez les articles FAQ sur les cartes Jira et Comment paramétrer le webHook pour les cartes Jira.
Configurer Miro sur Jira
✏️ Notez que les menus Jira peuvent différer selon la version de Jira que vous utilisez, mais le flux général doit être le même. Les instructions ci-dessous sont également disponibles dans le service d’assistance d’Atlassian.
Étape 1 - Lien de l’application
Tout d’abord, créez un lien d’application et configurez-le.
- Rendez-vous dans Paramètres Jira > Produits > Intégrations > Liens d’application > Créer un lien :Notez que l’interface Jira peut varier selon votre version Jira.
- Choisissez Lien direct de l’application et saisissez https://miro.com/ dans le champ URL de l’application.Important
: vous devez saisir l’URL dans ce format exact. Cliquez sur Poursuivre.
Création du lien
- Dans le menu suivant, cliquez simplement sur Poursuivre.
- Dans le menu Réviser le lien, vérifiez 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 cochez la case Créer un lien entrant. Ignorez le reste des champs et cliquez sur Poursuivre.
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 à Miro et rendez-vous dans Paramètres de l’équipe > Applications et intégrations > Cartes Jira.Si
vous ne disposez pas des 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 du Marketplace Miro. Après avoir vu les cartes Jira dans la liste, cliquez pour
l’ouvrir.L’onglet du plugin s’ouvrira et vous pouvez voir l’étape 1 pour obtenir les valeurs requises :Valeurs des cartes JiraCopiez
les valeurs et ajoutez-les au menu Lien de révision d’Atlassian. - Vous verrez le message de traitement pendant un moment ou deux :
La dernière étape de création du lien
Cela complète les étapes du côté Atlassian. Le lien apparaîtra dans la liste de vos liens d’application.
Étape 2 - Consultant
Retournez aux paramètres de votre carte Jira dans Miro et choisissez l’une des deux options : créer un webhook manuellement ou automatiquement. Si vous choisissez manuellement, décochez l’option. Voir plus d’informations dans cet article. Nous vous recommandons fortement d’utiliser le webhook automatique, afin que vous n’ayez pas à le réinitialiser en cas de grosses mises à jour du plugin.
Enfin, saisissez votre URL Jira et cliquez sur Se connecter :
Condre les cartes Jira
Pour obtenir l’URL Jira, copiez l’URL de base de votre instance Jira. Nous acceptons les formats suivants :
https://name.domain/
https://name.domain:port/https://IPaddress/
https://IPaddress/https://IPaddress:port/
Si votre URL Jira n’est pas acceptée, consultez cet article. Vérifiez également que Miro a suffisamment d’accès à votre Jira pour établir la connection.
Vous avez maintenant connecté votre instance Jira à votre équipe Miro.
⚠️ Notez que Jira Server sera interrompu à partir de février 2024. Les étapes ci-dessous fonctionneront toutefois de la même manière avec Jira Data Center.
- Rendez-vous sur https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Si l’option Liens d’application n’est pas sélectionnée, cliquez dessus.
Liens d’application Jira Server
- Cliquez sur Créer un lien. Sélectionnez « Produit Atlassian » et fournissez l’URL de l’application, « https://miro.com ». Cliquez sur Poursuivre.
Configuration de l’URL de l’application
- Vous accéderez à la boîte de dialogue Lier les applications. Ajoutez un nom d’application (par exemple, la carte Miro Jira) et sélectionnez « Application générique » pour le type d’application.
Vous devriez voir votre URL d’application Jira sous « Vous créez un lien à partir de : », et vous devriez voir https://miro.com sous « Vers cette application : ». Cliquez sur Poursuivre.Configurer les détails des applications Lier - La configuration du lien sera traitée. Lorsqu’il sera terminé, vous verrez votre nouveau lien dans la zone « Liens d’application » de Jira Server.
Votre application configurée dans Jira Server
- Ensuite, vous devrez configurer les détails de votre application. Cliquez sur l’icône du crayon de votre application pour modifier les détails de l’application.
- Dans la boîte de dialogue Configurer, cliquez sur l’option Authentification entrante. Remplissez la clé grand public, le nom du client, la clé publique et éventuellement une description. Ces informations se trouvent dans Miro dans les paramètres de votre équipe sous Applications et intégrations.
Configuration des détails de l’authentification entrante dans Jira ServerDétails du lien de l’application Jira dans Miro
- Faites défiler jusqu’à la fin des options d’authentification entrante et cliquez sur Enregistrer. Votre statut de vérification doit maintenant être Consulté. Ce serveur Jira peut maintenant être utilisé dans Miro pour une utilisation avec les cartes Jira. Assurez-vous de choisir « Jira Server » et « OAuth 1.0 » du côté de Miro.
Autorisation de l’utilisateur
Une fois l’intégration relié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 celui de votre instance Jira. Lorsque les utilisateurs finaux essaient d’importer ou de modifier une carte Jira pour la première fois, ils seront invités à se connecter à Jira à l’aide de leurs identifiants d’utilisateur individuels.
Une fois cela fait, les utilisateurs peuvent ajouter des tâches sous forme de cartes sur le tableau blanc. Toutes les modifications apportées dans Jira sont reflétées dans les cartes Jira sur le tableau.
✏️ Si un utilisateur ne dispose pas d’identifiants Jira et que l’utilisateur 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é, le destinataire et tous les attributs qui sont configurés pour être affichés sur la carte Jira. Cependant, ils ne pourront pas développer la carte pour voir d’autres attributs et la modifier à moins d’avoir donné leur autorisation. Si l’utilisateur ne connecte pas ses identifiants Jira, il ne verra pas l’avatar du destinataire et l’apparence générale de la carte sera différente.
Utilisation d’une instance Jira pour plusieurs équipes Miro (optionnel)
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 de l’application existant sera utilisé pour tous.
Après avoir connecté votre équipe à une instance Jira, un nouveau WebHook est créé dans vos WebHooks Jira, pour l’équipe Miro vers laquelle vous avez fait une connection. La création d’un webhook permet d’établir le canal pour les demandes de mise à jour.
⚠️ Si vous prévoyez de connecter plusieurs équipes, nous vous recommandons fortement d’aller sur votre page Jira WebHooks et de modifier chaque WebHook nouvellement créé pour avoir un nom unique ; sinon, il pourrait y avoir une confusion.
La connexion de plusieurs instances Jira à une équipe Miro n’est pas prise en charge.
Désinstallation du plugin
Rendez-vous dans Paramètres de l’équipe > Applications et intégrations > Cartes Jira et désactivez votre URL Jira dans l’étape 2. Cliquez ensuite sur Désinstaller pour l’équipe.
Désinstallation des cartes Jira
💡 N’oubliez pas de jeter un œil à l’article principal sur l’utilisation des cartes Jira !