Disponible pour : Jira Cloud, Jira Server (sur site) et Datacenter (protégé par LDAP également).
Mise en place par : Miro Team Admin & Jira System Admin avec des permissions d'administration de projet.
⚠️ Si des problèmes techniques apparaissent, veuillez vous référer à notre article sur les problèmes éventuels 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 Miro sur Jira
✏️ 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.
- Allez dans Jira Settings > Products > Integrations > Application links > Create link :
Notez que l'interface Jira peut différer en fonction de votre version de Jira.
- Sélectionnez Lien de candidature direct et saisissez https://miro.com/ dans le champ URL de la candidature.
Important : vous devez saisir 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. /span>
Seul le champ Nom de la demande doit être rempli.
- Vous verrez ici les champs pour les valeurs Miro. Pour obtenir les valeurs, connectez-vous à Miro.
- Pour l'intégration au niveau de l'équipe, allez à Paramètres de l'équipe > Applications et intégrations > Cartes Jira.
- Pour l'intégration au niveau de l'organisation, allez à Paramètres de l'entreprise > Applications > Gérer les applications > Cartes Jira > Paramètres.
Si Jira Cards ne figure pas dans votre liste d'applications, faites défiler jusqu'en haut de la section, cliquez sur Installer les applications et procédez à l'installation de l'application à partir de la Marketplace de Miro. Une fois que vous avez vu les cartes Jira dans la liste, cliquez sur pour les ouvrir.
L'onglet du plugin s'ouvre, 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 Review Link.
- Vous verrez le message de traitement pendant quelques instants :
La dernière étape de la création de liens
Ceci termine les étapes du côté d'Atlassian. Le lien apparaîtra dans la liste de vos liens d’application.
Étape 2 - Connexion
Retournez dans les paramètres de votre carte Jira dans Miro et choisissez l'une des deux options suivantes : créer un webhook manuellement ou automatiquement. Si vous choisissez de le faire manuellement, décochez l'option. Pour plus d’informations, consultez cet article/span>. 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.
⚠️ Bien qu'Atlassian ait cessé de prendre en charge Jira Server à compter de février 2024, Miro continuera de prendre en charge l'intégration de Jira Cards pour Jira Server dans un avenir prévisible.
- Allez sur https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Si "Liens d'application" n'est pas sélectionné, cliquez dessus.
Liens de l'application du serveur Jira
- Cliquez sur le lien Créer. Sélectionnez "Atlassian product" et indiquez l'URL de l'application, "https://miro.com". Cliquez sur Continuer.
Configuration de l'URL de l'application
- La boîte de dialogue "Lier les applications" s'affiche. Ajoutez un nom d'application (par exemple, Miro Jira Card) et sélectionnez "Application générique" pour le type d'application.
Vous devriez voir l'URL de votre application Miro sous "Vous créez un lien à partir de :", et vous devriez voir https://miro.com sous "Vers cette application :". Cliquez sur Continue.jira_server_link_applicationsDétails de la configuration des applications Link
- La configuration de la liaison sera traitée. Une fois l'opération terminée, vous verrez votre nouveau lien dans la zone "Liens d'application" de Jira Server.
Votre application configurée dans Jira Server
- Ensuite, vous devez configurer les détails de votre application. Cliquez sur l'icône en forme de crayon correspondant à votre demande pour en modifier les détails.
- Dans la boîte de dialogue Configurer, cliquez sur l'option Authentification entrante . Renseignez la clé du consommateur, le nom du consommateur, la clé publique et , éventuellement, une description.
- Pour l'intégration au niveau de l'équipe, ces informations sont disponibles à l'adresse suivante Paramètres de l'équipe > Applications et intégrations > Cartes Jira.
- Pour l'intégration au niveau de l'organisation, ces informations sont disponibles à l'adresse suivante Paramètres de l'entreprise > Applications > Gérer les applications > Cartes Jira > Paramètres.
Configuration des détails de l'authentification entrante dans le serveur Jira
Dé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 devrait maintenant être confirmé, et ce serveur Jira peut maintenant être utilisé dans Miro pour l'utilisation des cartes Jira. Veillez à choisir "Jira Server" et "OAuth 1.0" du côté de Miro.
jira_server_welcome_to_jira
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.
Utilisation d'une instance Jira pour plusieurs équipes Miro
Vous pouvez installer les cartes au niveau de l'équipe ou de l'organisation. Si vous avez plusieurs équipes, vous pouvez utiliser les paramètres au niveau de l'organisation pour éviter de répéter la procédure de configuration pour chaque équipe. Le lien de candidature existant est utilisé pour toutes les équipes.
Après avoir connecté votre équipe ou organisation à une instance Jira, un nouveau WebHook est créé dans vos WebHooks Jira pour cette équipe ou organisation Miro. La création d'un webhook établit un canal pour les demandes de mise à jour.
Si vous spécifiez des paramètres au niveau de l'organisation, les équipes déjà connectées conservent leurs paramètres actuels. Toutefois, ils peuvent à tout moment passer aux paramètres du niveau de l'organisation.
En outre, si nécessaire, les équipes peuvent remplacer les paramètres au niveau de l'organisation, afin de se connecter à une instance Jira différente.
Si vous êtes un client Enterprise et que vous souhaitez migrer plusieurs connexions au niveau de l'équipe vers la connexion par défaut au niveau de l'organisation, contactez l'équipe chargée de votre compte.
⚠️ Si vous souhaitez connecter plusieurs équipes séparément, nous vous recommandons de donner un nom unique au webhook pour chaque équipe. Accédez à votre page Jira WebHooks et modifiez chaque webhook nouvellement créé.
La connexion de plusieurs instances Jira à une seule équipe Miro n’est pas prise en charge.
Désactiver le plugin
Pour une intégration au niveau de l'équipe, accédez à Paramètres de l'équipe > Applications et intégrations > Jira Cards. Sélectionnez ensuite Supprimer pour l'équipe.
Dans le cas d'une intégration au niveau de l'organisation, pour restreindre l'utilisation de l'application Jira, accédez à Paramètres de l'entreprise > Applications > Gérer les applications > Cartes Jira. Placez ensuite le commutateur en position d'arrêt.
⚠️ Si vous désactivez Jira pour l'organisation, les utilisateurs de toutes les équipes Enterprise ne peuvent pas utiliser les cartes Jira. Pour en savoir plus sur la gestion et la restriction des applications, voir Gestion des applications.
En savoir plus : Voir Comment utiliser les cartes Jira.