Si vous rencontrez un problème lors de l’installation ou de l’utilisation des cartes Jira ou du module complémentaire Jira, ce guide pourra peut-être vous aider.
Suggestions pour les cartes Jira
Message/problème |
Causes probables et étapes pour résoudre le problème |
---|---|
Connexion |
|
Erreur Jira is not connected (Jira n’est pas connecté) lorsque vous essayez de vous connecter à Miro avec vos identifiants personnels Fenêtre contextuelle Unable to add Jira Cards (Impossible d’ajouter des cartes Jira) lorsque vous essayez d’utiliser l’application des cartes Jira sur un tableau |
L’application des cartes Jira est installée, mais votre équipe Miro n’est pas connectée à Jira. Veuillez suivre ce guide d’installation : Configurer et désinstaller des cartes Jira. Si vous n’êtes pas admin d’équipe, demandez à l’admin de le faire. |
Request to Jira ... failed: Timeout has occurred / Unknown host / Connection refused (Requête à Jira... échec : le délai a été dépassé/Hôte inconnu/Connexion refusée) |
Jira est uniquement accessible sur votre intranet (vous utilisez les mauvaises adresses IP pour communiquer avec le système Jira). Assurez-vous d’ajouter notre adresse IP, nos domaines et nos sous-domaines dans votre liste d’autorisations pour octroyer le niveau d’accès requis à notre intégration. |
Application link in your Jira is not configured correctly (Le lien d’application dans votre Jira n’est pas configuré correctement) |
- Vous avez manqué certaines étapes dans la configuration du lien ou du webhook - Vous avez installé le module complémentaire Jira au lieu de configurer le lien pour les cartes Jira. Essayez d’installer l’intégration des cartes Jira en partant de zéro. Si vous avez choisi de créer le webhook manuellement, essayez de le créer automatiquement. |
Application link in your instance of Jira is not configured correctly, or token has expired. Check the application link and reconnect the integration (Le lien d’application dans votre instance Jira n’est pas configuré correctement ou le jeton a expiré. Vérifiez le lien de l’application et reconnectez l’intégration). |
- Le lien de l’application dans Jira a été reconfiguré. - Le jeton a expiré. - Le jeton a été révoqué. Assurez-vous que votre lien d’application est configuré correctement et essayez de reconnecter Miro aux cartes Jira. Si vous utilisez une version de Jira hautement protégée ou si vous utilisez un serveur proxy, assurez-vous d’ajouter notre adresse IP, nos domaines et nos sous-domaines dans votre liste d’autorisations pour fournir le niveau d’accès requis à notre intégration. |
Le lien de votre application demande plus de valeurs que l’URL, la clé du consommateur, le nom du consommateur, la clé publique |
Vous regardez l’onglet Outgoing Authentication (Authentification sortante) du menu de configuration. - Passez à l’onglet Incoming Authentication (Authentification entrante). L’authentification sortante ne nécessite pas de configuration. - Si vous ne pouvez pas ignorer l’étape, ajoutez des valeurs temporaires, quelles qu’elles soient. Vous pourrez les supprimer plus tard : sur la page avec la liste Application links (liens d’application), cliquez sur Edit (Modifier) pour modifier le lien Miro Cards et supprimer les valeurs temporaires. |
Jira URL is not valid /
|
Votre Jira est sur un réseau privé ou le pare-feu de votre entreprise bloque les connexions réseau externes. Ajoutez nos adresses IP NAT Gateway (ainsi que les ports) à votre liste d’autorisations. |
Vous utilisez un serveur proxy ou vos URL Jira externes et internes ne coïncident pas. Assurez-vous de remplir le champ URL de Jira avec une adresse à laquelle nous pouvons accéder, aussi, configurez un serveur proxy inverse pour nous permettre d’y accéder et/ou suivez les étapes de ce guide d’Atlassian (disponible uniquement en anglais). Avec cette solution, l’intégration pourra connecter et transmettre avec succès les demandes entre votre Jira et Miro si vos URL externes et internes sont différentes. |
|
Il y a un problème avec votre certificat SSL (les certificats auto-signés ne sont pas pris en charge). Vérifiez le certificat SSL actif sur le serveur Jira. Cet outil pourrait être utile : entrez votre URL Jira et regardez les résultats de la vérification de connexion. |
|
Votre Jira est sous SSO (peut également entraîner l’erreur Incoming authentication is not configured, l’authentification entrante n’est pas configurée correctement). Assurez-vous que votre processus de SSO ne s’applique pas aux demandes de connexion de notre intégration. Les points de terminaison suivants doivent être exclus des processus de SSO : POST {JIRA_URL}/plugins/servlet/oauth/request-token
POST {JIRA_URL}/plugins/servlet/oauth/access-token
GET {JIRA_URL}/rest/api/2/serverInfo
|
|
Comportement inattendu lors de l’installation |
Vous utilisez la version 6.4 ou inférieure de Jira. Nos cartes ne fonctionneront pas avec ces versions en raison de ce bug sur Jira (page en anglais uniquement). Veuillez mettre à jour votre Jira à la dernière version. |
App authorisation failed. Please try to authorise the app again. (L’autorisation de l’application a échoué. Veuillez essayer d’autoriser à nouveau l’application.) |
Une perte de connexion momentanée. Cliquez sur Connect (Se connecter) pour vous connecter à nouveau. |
Erreur Jira : « You don’t have permissions to create Webhook ’Miro’. » (Vous n’avez pas les autorisations pour créer un webhook ’Miro’). |
Vous n’avez pas les droits d’administrateur sur Jira. Veuillez demander à votre admin Jira de changer votre rôle en admin afin que vous puissiez configurer l’intégration. |
Request to Jira failed: PKIX path building failed: unable to find valid certification path to requested target (Échec de la requête à Jira : la construction du chemin PKIX a échoué : impossible de trouver un chemin de certification valide vers la cible demandée) |
Il y a un problème avec votre certificat de serveur. |
Utilisation des cartes |
|
Les cartes Jira ne se mettent pas à jour
|
Vous utilisez un webhook manuel. Veuillez désactiver l’intégration et la reconnecter en utilisant un webhook automatique. Si tout fonctionne correctement avec un webhook automatique, cela signifie que le webhook manuel a été configuré incorrectement. Aussi, consultez l’article Configurer un webhook pour les cartes Jira. |
Si vous utilisez un webhook automatique : La première étape de dépannage consiste à reconnecter l’intégration. Si cela ne corrige pas le problème, plusieurs raisons pourraient expliquer pourquoi les cartes Jira ne sont plus actives : - Un tableau Miro a été déplacé/téléchargé à partir d’une sauvegarde dans une équipe depuis une autre - Les tickets Jira qui ne sont pas mis à jour ont été déplacés d’un projet à un autre sur Jira - Vous n’avez pas accès aux projets dans lesquels se trouvent les tickets Jira. - les cartes non mises à jour ne se trouvent pas dans l’instance Jira que vous utilisez actuellement sur votre navigateur |
|
Les cartes Jira ont cessé de se mettre à jour sans qu’aucun changement n’ait été apporté de votre côté et lorsque vous essayez de vous reconnecter, vous obtenez le message Application link in your Jira is not configured correctly (Le lien de l’application dans votre Jira n’est pas configuré correctement). |
Le message d’erreur peut apparaître lorsque Miro est incapable de solliciter un Jira connecté en raison d’une erreur d’autorisation. Cela peut se produire si la personne qui a configuré l’intégration révoque son jeton ou si Jira est configuré avec une courte durée de vie du jeton émis, qui devient donc tout simplement invalide par la suite et doit être reconnecté pour récupérer un nouveau jeton d’autorisation valide avec lequel Miro accède à Jira. |
L’option Edit card (Modifier la carte) renvoie une fenêtre vide |
Vous utilisez la version Jira 7.6 et ultérieure. Pour des raisons de sécurité, Atlassian peut ne pas autoriser l’intégration de contenu dans iFrames, ce qui pourrait également affecter les fenêtres contextuelles qui permettent de modifier vos cartes Jira. Vous pouvez suivre ces instructions (disponibles uniquement en anglais) pour appliquer une solution de rechange. |
Impossible d’ajouter des cartes Jira |
Vous avez créé un webhook manuel et n’avez pas enregistré les informations de configuration. Vérifiez si le champ Jira URL (URL Jira) est rempli dans les paramètres Miro. Assurez-vous de cliquer sur Connect (Connecter). |
L’icône Edit (Modifier) ne s’affiche pas
|
Vous utilisez la version 7.6 ou ultérieure du serveur Jira. L’icône de modification pourrait ne pas s’afficher en raison d’une mise à jour de sécurité dans cette version. |
Votre profil n’est pas autorisé à modifier le ticket Jira en question. Vérifiez si vous avez accès au mode édition après avoir ouvert le ticket sur Jira. |
|
Vous obtenez le message : You are not logged in and do not have the permissions required to act on the selected issue as a guest. Please log in (Vous n’êtes pas connecté et n’avez pas les autorisations requises pour agir en tant qu’invité sur le ticket sélectionné. Veuillez vous connecter.) |
En raison de la manière dont notre intégration utilise les cookies, votre Jira pourrait ne pas vous permettre de vous connecter à partir de cette page. Connectez-vous à Jira dans un autre onglet du navigateur. |
Votre Jira est sous SSO et votre fournisseur d’identité (IdP) ne permet pas l’authentification via des iframes. Si vous travaillez sur l’application de bureau Miro, nous vous recommandons de passer sur la version navigateur sur miro.com. |
|
Aucune option pour convertir/créer une carte Jira dans Miro lorsque vous choisissez certains projets : - Aucune donnée dans le champ Type de ticket - Le bouton Convert/Create (Convertir/Créer) est inactif |
Vous n’avez pas accès au projet dans Jira. Vérifiez si vous pouvez obtenir un droit d’accès. |
Unable to create Jira issue (Impossible de créer un ticket Jira) lorsque vous essayez de convertir/créer une nouvelle carte Jira : |
Vous n’avez pas les droits nécessaires pour créer des tickets Jira. Veuillez contacter votre admin Jira et lui demander de vous accorder les autorisations nécessaires sur Jira. Voici à quoi cela devrait ressembler : |
Certains champs personnalisés ne sont pas affichés dans le menu Convert to Jira Issue/Edit Jira Issue (Convertir en ticket Jira/Modifier le ticket Jira) Erreur Can’t create Jira issue (Impossible de créer un ticket Jira). Required fields (...) are not supported (Impossible de créer un ticket Jira. Les champs obligatoires (...) ne sont pas pris en charge) lors de la création d’un ticket Jira dans Miro |
Les champs ne sont pas activés sur le sélecteur de tableaux de cartes Jira. Utilisez notre sélecteur Jira intégré pour configurer des champs personnalisés en suivant les étapes de ce guide sur les cartes Jira. |
Si Select fields to display on cards (Sélectionner les champs à afficher sur les cartes) n’affiche pas les champs personnalisés de votre Jira, il est possible que certains des écrans (page disponible uniquement en anglais) configurés pour les projets de votre instance Jira cachent les champs de Miro. Allez dans Project settings (Paramètres du projet) > Screens (Écrans) > Default Screen Scheme (Schéma d’écran par défaut) et vérifiez si les champs requis sont autorisés. |
|
Miro ne prend pas en charge les champs de types de données complexes. Miro prend en charge les champs personnalisés de base, mais pas ceux qui sont complexes. Configurez les champs de cartes Jira et supprimez les champs qui ne sont pas pris en charge. |
|
Vous ne pouvez pas choisir le Reporter (Rapporteur) lors de la modification/création d’une carte Jira |
Il n’y a pas de champ Reporter (Rapporteur) dans les métadonnées Create (Créer) de Jira : le champ n’est pas disponible sur l’écran Create (Créer) (article disponible uniquement en anglais) de Jira pour le projet sélectionné. Allez dans Project settings (Paramètres du projet) > Screens (Écrans) et vérifiez si le champ Reporter (Rapporteur) existe dans l’écran Create (Créer). |
Vous n’avez pas les autorisations nécessaires pour définir le rapporteur pour les tickets dans le projet sélectionné. Demandez à l’admin Jira de vérifier vos niveaux d’accès et assurez-vous de disposer de l’autorisation nécessaire pour définir/modifier le champ Reporter (Rapporteur) dans le projet sélectionné. Pour ce faire, l’admin doit se connecter à Jira > aller dans Settings (Paramètres) > Issues (Tickets) > Permission schemes (Schémas d’autorisation) > et cocher le champ Modify Reporter (Modifier le rapporteur) (veuillez ajouter le champ Application access (Accès à l’application) : Any logged in user (Tout utilisateur connecté) au cas où vous ne l’auriez pas sur la liste) : |
|
Le champ du rapporteur n’est pas modifiable pour des besoins d’audit et est défini sur la personne qui a créé le ticket. L’indisponibilité du champ est un comportement attendu. |
|
Certains champs sont affichés dans le mode modification d’une carte, mais ne s’affichent pas sur les cartes Jira dans les tableaux |
Miro ne reçoit pas de mises à jour de Jira.
|
Erreur Jira is not available (Jira n’est pas disponible) dans les paramètres de l’application dans les cartes Jira |
1. Demandez à l’admin d’équipe de désactiver et de reconnecter l’intégration. 2. Votre Jira est sous protection (pare-feu, bloqueurs de sécurité, etc.) et ne peut être atteint par Miro. Si en même temps les cartes Jira se synchronisent entre Miro et Jira, cela signifie que votre Jira peut nous envoyer des webhooks. C’est pourquoi vous pouvez voir les mises à jour sur vos tableaux.
|
Erreur Jira webhook issues (Problèmes de webhook Jira) dans les paramètres d’application des cartes Jira |
- Vous avez modifié/supprimé un webhook du côté de Jira
Nous vous suggérons de désactiver intégration et de la reconnecter à nouveau. |
Lorsque vous utilisez Ctrl + V (pour Windows)/Cmd + V (pour Mac) pour coller le lien d’un ticket Jira sur le tableau, il ne se transforme pas en une carte Jira, mais il est collé en tant qu’URL |
Le tableau est encore en train de charger. Cela peut se produire sur les grands tableaux ou les tableaux avec de grandes images ou de grands documents PDF. Veuillez attendre au moins 10 secondes après avoir ouvert le tableau et laissez le tableau charger complètement. Ensuite, essayez de coller à nouveau le lien. |
La description n’est pas visible sur les cartes Jira sur le tableau |
La description d’une carte peut être cachée si vous dézoomez. Pour voir la description, il est peut-être nécessaire d’élargir la carte ou de zoomer (la description devient en partie visible avec un triple zoom du tableau) |
Message « Showing 0 of 0 matching sprints » (Affichage de 0 sur 0 sprints correspondants) lorsque vous essayez de rechercher et de trouver des sprints disponibles |
1. Cela se produit lorsque vous n’avez pas de sprints actifs/futurs (car ils sont tous fermés/terminés). 2. Votre filtre dans Jira n’inclut aucun projet. Veuillez ajouter un projet nécessaire au JQL pour le filtre des tableau. Ainsi, les sprints apparaîtront à la fois dans Jira et dans Miro. |
Échec de la connexion SSL avec... |
L’erreur signifie que Miro n’a pas accès à votre Jira. |
Aucun utilisateur ne s’affiche dans le champ « Assignee » (Personne assignée) de la carte Jira dans Miro
|
Assurez-vous que la permission « Browse users » (Parcourir les utilisateurs) est définie au niveau global dans Jira. En savoir plus sur la façon de gérer les autorisations globales (uniquement disponible en anglais). |
Suggestions pour le module complémentaire Jira
Message/problème | Causes probables et étapes pour résoudre le problème |
---|---|
You are not logged in and do not have the permissions required to act on the selected issue as a guest. Please log in (Vous n’êtes pas connecté et n’avez pas les autorisations requises pour agir en tant qu’invité sur le ticket sélectionné. Veuillez vous connecter) |
Malheureusement, en raison de la façon dont notre plugin utilise les cookies, Jira ne vous permettra pas de vous connecter à partir de cette page. Connectez-vous à Jira dans un autre onglet du navigateur. |
Après avoir cliqué sur le bouton Install (Installer) sur la page des modules complémentaires vous pourriez recevoir l’erreur suivante : |
Perte momentanée de connexion. Dans ce cas, il suffit de réessayer l’installation une minute plus tard. |
Pendant ou après la configuration du module complémentaire Jira, vous n’arrivez pas à accéder à la page suivante à une étape donnée |
Quelque chose dans vos cookies ou dans votre cache arrête le processus. Effacez la mémoire de votre navigateur pour le domaine atlassian.com et réessayez. |
Après une installation réussie, vos utilisateurs de Jira qui ne sont pas enregistrés sur Miro voient le menu de connexion Miro au lieu du tableau intégré. |
Les politiques de Jira bloquent certaines des fonctionnalités du plugin. Malheureusement, ce comportement est causé par la dernière mise à jour de l’API Jira et ne peut pas être corrigé pour le moment. |
Le module complémentaire ne se souvient pas de votre autorisation et vous demande à chaque fois de vous connecter. Lorsque vous essayez d’ajouter des tableaux à un ticket Jira, le sélecteur de tableaux affiche l’erreur : « Sorry, integration is unavailable » (Désolé, l’intégration n’est pas disponible). |
Les cookies tiers sont bloqués dans votre navigateur. Pour y remédier, suivez les instructions (uniquement disponibles en anglais) sur l’activation des cookies dans votre navigateur. Cela se produit principalement avec Mozilla et Safari en raison de leurs nouvelles politiques de sécurité. |