Disponible pour : Jira Cloud, Jira Server (On-Premise) et Datacenter (également protégé par LDAP)
Configuré par : l’admin d’équipe de Miro et l’admin 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 problèmes éventuels et sur la manière de 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. Le flux général devrait cependant être le même. Les instructions ci-dessous se trouvent également 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.
1. Allez dans Jira Settings (Paramètres de Jira) > Products (Produits) > Integrations (Intégrations) > Application links (Liens d’application).
2. Cliquez sur Create new link (Créer un nouveau lien) (si vous êtes sur une version plus récente de Jira Cloud et Jira Server, choisissez Atlassian product/Create an incoming link (Produit Atlassian/Créer un lien entrant)). Tapez https://miro.com
Ajout de l’adresse du site de Miro à la liste des liens d’application
3. Vous verrez ensuite la fenêtre de dialogue suivante. Revérifiez l’URL ou cliquez sur Continue (Continuer) :
Fenêtre de configuration de l’URL de l’application
4. Dans la fenêtre Link applications (Lier les applications), remplissez les champs Application name (Nom de l’application) et Application type (Type d’application), puis cliquez sur Continue (Continuer).
Les champs Application name (nom de l’application) et Application type (type d’application) sont requis
Vous verrez le message Application Link ‘APPLICATION_NAME’ created successfully (Lien d’application ’NOM DE L’APPLICATION’ créé avec succès) et le nom apparaîtra sur la liste.
5. Authentifiez maintenant l’application à l’aide de vos données Miro. Dans l’application qui s’affiche, cliquez sur Edit (Modifier) :
Le lien de l’application est maintenant créé et nécessite une configuration
6. Ouvrez l’onglet OAuth dans Incoming Authentication (Authentification entrante). Remplissez quatre valeurs : URL, Consumer Key (Clé du consommateur), Consumer Name (Nom du consommateur) et Public Key (Clé publique). Les valeurs sont les mêmes pour toutes les équipes Miro.
Fenêtre d’authentification entrante Incoming Authentication
Pour obtenir les valeurs, connectez-vous à Miro et accédez à team settings (paramètres de l’équipe) > Apps & Integrations (Applications et intégrations) > Jira cards (cartes Jira).
Veuillez noter que les cartes sont installées au niveau de l’équipe. Si vous avez un plan Enterprise, vous devrez donc choisir l’une des équipes de votre entreprise (vous pouvez connecter plusieurs équipes à la même instance Jira), comme suit : Company Settings (Paramètres de l’entreprise) > Teams (Équipes). Choisissez une équipe dans la liste et accédez à Apps & Integrations (Applications et intégrations).
Si vous n’avez pas encore cartes Jira dans votre liste des applications, faites défiler vers le haut de la section Apps & Integrations (Applications et intégrations), cliquez sur Install apps (Installer des applications) et procédez à l’installation de l’application à partir du Marketplace Miro. Quand vous voyez l’application des cartes Jira sur la liste, cliquez dessus.
L’onglet du plugin s’ouvre et vous pouvez voir l’étape 1 qui demande d’obtenir les valeurs requises pour l’authentification dans Jira :
Valeurs des cartes Jira
Copiez les valeurs de Miro, collez-les dans l’onglet OAuth de Jira et appuyez sur Save (Enregistrer). Une fois que Jira aura traité les valeurs, vous verrez un message indiquant que Miro est maintenant autorisé à traiter vos données Jira, statut Configured (Configuré) :
Le statut de configuration réussie
Étape 2 - Connexion
Retournez dans Miro et ouvrez les paramètres de l’application Jira cards (Team settings (Paramètres d’équipe) > Apps & Integrations ()Apps & Intégrations > Jira cards (cartes Jira)).
Choisissez l’une des deux options : créez 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 le lien de base de la page de votre tableau de bord Jira :
Tableau de bord de 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. 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. Dans vos WebHooks Jira, vous trouverez le nouveau WebHook créé pour l’équipe Miro pour laquelle vous avez établi une connexion. Si vous voulez connecter plusieurs équipes, nous vous recommandons d’aller sur votre page Jira WebHooks et de modifier chaque nouveau WebHook créé pour lui donner un nom unique afin d’éviter les confusions.
Créer un WebHook permet d’établir le canal pour les demandes de mise à jour. Ensuite, 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 depuis Miro est exactement le même que celui de votre instance Jira. Lorsqu’un utilisateur final tente d’importer ou de modifier une carte Jira pour la première fois, il devra se connecter à Jira à l’aide de ses identifiants utilisateur 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)
Si vous avez plusieurs équipes Miro, vous pouvez utiliser un lien d’application existant pour synchroniser Miro et Jira. Veuillez installer l’application des cartes Jira dans l’une de vos équipes et coller simplement l’URL de base de Jira dans les paramètres d’intégration de vos autres équipes Miro et cliquez sur Connect (Connecter).
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 !