Intégrer airfocus à Jira

Écrit par :  Morgan T
Dernière mise à jour :  

Connectez votre stratégie produit dans airfocus avec votre exécution du développement dans Jira grâce à cette puissante intégration bidirectionnelle. Vous pouvez importer des éléments de travail dans airfocus et pousser des éléments airfocus - y compris des épopées et des fonctionnalités - dans Jira, ce qui vous permet de suivre leur état à partir d'airfocus tout en reliant vos flux de travail de gestion de produits, vos cadres de priorisation et vos feuilles de route au développement quotidien grâce à une synchronisation transparente des données. Lisez la suite pour savoir comment mettre en place et configurer cette intégration.

Avantages

Connectez vos flux de travail de gestion de produits, vos cadres de priorisation et vos feuilles de route au développement quotidien en synchronisant vos données de manière transparente entre airfocus et Jira. L'intégration est compatible avec Jira Cloud, Jira Server et Jira Data Center.

  • Importer des questions Jira (en tant qu'éléments) dans airfocus.
  • Transférer des éléments airfocus dans Jira (comme n'importe quel type d'enjeu).
  • Synchronisation bidirectionnelle & filtrage flexible (JQL personnalisé).
  • Cartographie flexible des champs.
  • Affichez vos scores de priorité airfocus dans Jira pour mettre en contexte la valeur et les priorités de l'entreprise.
  • Possibilité de voir les relations parents-enfants directement dans l'airfocus.

Les exigences

  • Sur airfocus : L'utilisateur doit avoir les permissions "Full" sur l'espace de travail pour lequel il veut configurer l'intégration Jira.
  • Sur Jira : "Administrateur" des autorisations sont nécessaires pour établir le lien d'application entre votre instance Jira et l'équipe airfocus.
  • Si le lien applicatif entre l'instance Jira et l'équipe airfocus a déjà été établi, tout utilisateur Jira ayant au moins "Create_Issue" l'autorisation sur un projet peut mettre en place de nouvelles intégrations sur cette instance.
  • Notre intégration Jira est compatible avec Jira Cloud, Jira Server et Jira Data Center. Nous prenons en charge toutes les versions de Jira Server répertoriées dans la politique de fin de vie du support Atlassian. Les versions antérieures à celles énumérées ici ont atteint leur fin de vie (EOL) et peuvent fonctionner mais ne sont pas prises en charge.

Configurer l'intégration Jira

  1. Inscrivez-vous à airfocus ou connectez-vous à votre compte existant. 
  2. Créez un nouvel espace de travail dans airfocus ou sélectionnez celui avec lequel vous souhaitez intégrer Jira.
    • Vous ne devez autoriser votre instance Jira qu'une seule fois par équipe airfocus.
    • Vous pouvez ajouter plusieurs intégrations Jira à un espace de travail donné (par exemple, à partir de différents projets ou instances Jira).
  3. Cliquez sur Extensions dans le coin supérieur droit de votre espace de travail.
  4. Sélectionnez Gérer les intégrations.
  5. Cliquez sur Connect sur la tuile "Jira".
  6. Sélectionnez Connecter une nouvelle instance Jira dans le menu déroulant qui s'affiche.
  7. Saisissez l'URL de base de votre instance Jira (par ex. https://airfocustest.atlassian.net/ ou https://jira.mycompany.com).
  8. Cliquez sur Continuer.
  9. Copiez l'"URL de l'application". Vous en aurez besoin pour les étapes suivantes dans Jira.
  10. Cliquez sur Jira application link center pour ouvrir le Jira Application Link Center.
    • Vous devez être un administrateur de Jira pour accéder à cette page. 

Les étapes suivantes varient pour Jira Cloud et Jira Server/Data Center. Consultez la section ci-dessous pour savoir si votre instance peut continuer.

Configurer le filtrage de l'intégration

  1. Sélectionnez le projet que vous souhaitez synchroniser. Vous pouvez taper pour filtrer la liste des projets.
    • Les projets que vous pouvez voir mais pour lesquels vous ne disposez pas des autorisations CREATE_ISSUES sont marqués comme tels (uniquement disponible pour Jira Cloud).
    • Le nom de votre intégration est créé automatiquement en fonction du projet. Vous pouvez également le modifier ultérieurement.
  2. Sélectionnez le type de question que vous souhaitez synchroniser. 
    • Étant donné que les champs peuvent différer d'un type de question à l'autre (en fonction de votre version de Jira et du type de projet, c'est-à-dire géré par l'équipe ou par l'entreprise), cela permet de filtrer les champs que vous pouvez mapper à ceux qui sont réellement disponibles sur le type de question sélectionné.
    • Si vous souhaitez synchroniser plusieurs types de problèmes, nous vous recommandons de mettre en place une intégration pour chacun d'entre eux, soit dans le même espace de travail, soit dans plusieurs espaces de travail. Vous pouvez connecter les intégrations d'autres espaces de travail (par exemple pour les épopées ou les sous-tâches) via la hiérarchie airfocus.
    • Vous pouvez également filtrer davantage les problèmes synchronisés en fournissant une requête JQL dans le filtre de problèmes (pour en savoir plus sur JQL, cliquez ici).
intégrer-avec-jira-5.png

Mettez en correspondance les champs airfocus et Jira

Utilisez le mappage pour définir comment les informations de Jira doivent être mises en correspondance avec les informations d'airfocus. Si vous modifiez une question ou un élément dans un système, l'autre système sera ajusté en conséquence.

Vous pouvez, par exemple, définir comment les statuts Jira doivent être mis en correspondance avec les champs à sélection unique de l'airfocus et/ou comment les étiquettes Jira doivent être mises en correspondance avec les champs à sélection multiple de l'airfocus.

Il existe également de nombreuses autres options permettant de faire correspondre différents champs personnalisés et systèmes de Jira à vos champs airfocus.

Si vous examinez les options de mappage des champs, vous constaterez que deux champs sont toujours mappés par défaut : les noms et les descriptions des articles.

Vous pouvez définir pour chacun de vos champs si vous souhaitez une synchronisation unidirectionnelle ou bidirectionnelle entre le champ dans Jira et airfocus.

intégrer-avec-jira-6.png

Vous pouvez définir les directions de cartographie pour tous les champs en même temps (dans la mesure où cela est techniquement possible) à l'aide du bouton "Définir la direction".

Par défaut, la direction du mappage est définie de Jira à airfocus uniquement et peut être modifiée par l'utilisateur pour tout ce qui est disponible pour le mappage.

intégrer-avec-jira-7.png

Lorsque vous configurez un nouveau mappage pour l'un de vos champs, vous constaterez que vous ne pouvez mapper un champ Jira à un champ airfocus que si les deux extrémités ont le même type de champ.

Lorsque vous sélectionnez un champ dans la liste déroulante, seuls les champs correspondant au type de champ seront affichés dans la liste déroulante à l'autre extrémité.

Après avoir sélectionné les deux champs que vous souhaitez mapper, vous pouvez choisir les options de champ et la manière dont ils doivent être mappés.

Vue d'ensemble de tous les types de champs mappables

Champs du système Jira pouvant être appliqués :

Jira airfocus Jira → airfocus airfocus → Jira
Nom de la question Nom de l'article
Description de la question Description de l'article ⚠️
Statut Statut/champ personnalisé à sélection unique
Étiquettes Champ multi-sélection personnalisé
Date de création Champ de date personnalisé ✅ (date uniquement)
Mise à jour Champ de date personnalisé ✅ (date uniquement)
Critères d'acceptation
Agents Personnes/Assignés ⚠️ ⚠️
Signalé par Personnes/Assignés ⚠️ ⚠️
Pièces jointes Pièces jointes
Champ Date (début/échéance) (par paire) Champ de date personnalisé
Champ Date (début/échéance) Champ de date personnalisé
Dépendances Dépendances
Correction de la version Champ multi-sélection personnalisé
Correction de la version Jalon (multi-sélection)
Correction de la version Durée
Version de correction (la plus récente) Champ personnalisé à sélection unique
Version de correction (la plus récente) Champ multi-sélection personnalisé
Date de publication de la version du correctif Champ de date personnalisé
ID de la question ID de l'article
Type de ticket Champ personnalisé à sélection unique
Champ multi-sélection Champ multi-sélection personnalisé
Champ de priorité Champ personnalisé à sélection unique
Sprints Champ Période
Sprint (ID) Champ multi-sélection personnalisé
Sprint (nom) Champ de texte personnalisé
Sprint (dates) Champ de date personnalisé
Sprint (le plus récent) Champ personnalisé à sélection unique
Champ de l'équipe Champ personnalisé à sélection unique

⚠️ Avertissement concernant la synchronisation bidirectionnelle pour le champ de description : Le processus de synchronisation bidirectionnelle peut entraîner de légères modifications dans le contenu et le formatage de vos descriptions Jira. Cela est dû au fait que tous les styles de Jira ne sont pas encore pris en charge de manière native dans airfocus.

⚠️ Avertissements concernant le mappage des champs de personnes : La logique de mappage est basée sur les noms d'affichage. Par conséquent, "Kirsten" dans Jira ne correspond PAS à "Kirst" dans airfocus, même si les deux comptes utilisent la même adresse électronique.

Dans le cas où Jira n'autorise qu'une seule valeur pour un champ de personnes (par exemple, il ne peut y avoir qu'une seule personne affectée), une synchronisation avec airfocus favorise la première valeur pour le champ de personnes airfocus mappé. Par exemple, un ticket dans Jira assigné à "Julian" écrasera un élément dans airfocus assigné à "Julian et Nikita". Nikita sera supprimée et seul Julian restera affecté.

Champs personnalisés Jira applicables :

Jira airfocus Jira → airfocus airfocus → Jira airfocus ↔ Jira
Champ à sélection unique Champ personnalisé à sélection unique
Champ multi-sélection Champ multi-sélection personnalisé
Champ de la date Champ de date personnalisé (plage de dates si multiple)
Champ de texte (à l'exclusion du texte enrichi) Champ de texte personnalisé
Champ de texte enrichi Description de l'article/ champ de description de l'airfocus ⚠️ ⚠️
Champ de numéros Champ de chiffres personnalisé
Champ de numéros Score des notes de priorité
Étiquettes Champ multi-sélection personnalisé

Dépannage : Trouvez votre champ de date

Nous avons besoin d'au moins deux champs de date (en dehors des versions de correction) pour pouvoir les faire correspondre à un champ de plage de dates airfocus.

Notre intégration ne peut détecter les champs de date que s'ils sont visibles sur le type de dossier synchronisé (écran). Vous devez vous assurer qu'au moins deux champs de date figurent sur le type d'enjeu (écran) dans Jira et qu'au moins un champ de plage de dates est disponible pour le mappage dans votre espace de travail airfocus.

Ce que cela donne dans Jira :

  • pour Jira Cloud géré par l'équipe, allez dans les paramètres du projet > issue types et faites glisser le champ de la barre latérale droite vers la liste des champs au milieu.
  • pour Jira Cloud géré par l'entreprise (et Jira Server), allez dans les paramètres du projet > issues > screens et modifiez l'écran du type d'issue que vous synchronisez. Vous pouvez ajouter des champs de date supplémentaires en bas de page.

Champs de mise en correspondance automatique

Lorsque les champs comportent de nombreuses options, activez l'option "Auto-map options" pour gagner du temps. Cela permet de mapper automatiquement les champs ayant les mêmes valeurs dans airfocus et dans Jira.

intégrer-avec-jira-9.png

Génération automatique de valeurs de champs

Activez "Options de création automatique de champs" pour ajouter automatiquement les nouveaux champs créés dans Jira à airfocus lorsqu'ils sont ajoutés à un élément. 

intégrer-avec-jira-10.png

Note: Le générateur de champs à création automatique ne tient pas compte des majuscules et des minuscules.

Comment cartographier le score de focalisation avec Jira

Grâce à l'intégration d'airfocus à Jira, vous pouvez utiliser airfocus pour établir des priorités et des feuilles de route, tandis que les développeurs (et d'autres) utilisent Jira pour planifier le développement au jour le jour.

Par défaut, nous affichons déjà dans Jira les données airfocus telles que les scores de priorité, les couloirs et les délais. Cet article d'aide décrit comment vous pouvez mapper le score de focalisation airfocus avec un champ personnalisé Jira (que vous pouvez également filtrer dans Jira).

En associant le score de focalisation airfocus à votre projet Jira, vous serez en mesure d'afficher votre priorité numéro un là où les gens travaillent - sur chaque carte d'enjeu Jira synchronisée et sur la couverture de la carte d'enjeu. De cette façon, toute votre équipe sera alignée et se concentrera sur les tâches les plus importantes.

intégrer-avec-jira-11.png

Pour afficher le score de focalisation airfocus dans Jira, vous devez le mapper avec un champ personnalisé Jira. Le champ personnalisé doit avoir le type de champ "Champ de numéros". L'installation prend environ 3 minutes.

Voici comment procéder :

  1. Dans Jira, cliquez sur l'icône de l'engrenage dans le coin supérieur droit pour ouvrir les paramètres.
  2. Cliquez sur Questions.
  3. Sélectionnez Champs personnalisés dans le menu de navigation situé à gauche.
  4. Cliquez sur Créer un champ personnalisé dans le coin supérieur droit.
  5. Sélectionnez le champ Nombre comme type de champ.
  6. Saisissez un nom et une description (facultatif).
  7. Cliquez sur Créer.
  8. Associez le nouveau champ personnalisé aux écrans (de votre projet synchronisé)
    intégrer-avec-jira-19.png
  9. Retournez à vos paramètres d'intégration Jira dans airfocus et sélectionnez le champ personnalisé nouvellement créé dans le menu déroulant.
    intégrer-avec-jira-20.png

Le score de focalisation d'airfocus s'affichera désormais pour vos problèmes Jira.
 

Si vous souhaitez également afficher le score de mise au point sur les couvertures de vos cartes, procédez comme suit :

  1. Cliquez sur l'icône à trois points dans le coin supérieur droit de votre tableau.
  2. Sélectionnez les paramètres de la carte.
  3. Cliquez sur Mise en page de la carte dans le menu de navigation situé à gauche.
  4. Sélectionnez le champ personnalisé de votre score de focalisation dans la liste déroulante.
  5. Cliquez sur Ajouter.
  6. Vous trouverez également sur le tableau le score de focalisation.
    intégrer-avec-jira-24.png

Configurer des paramètres supplémentaires

  • Lorsque l'option "Archive unknown issues" est activée, les éléments précédemment importés seront archivés dans airfocus s'ils ne sont plus présents dans Jira (ou s'ils ne correspondent plus au filtre JQL).
  • Lorsque "Synchronisation automatique" est activé, votre intégration se synchronisera automatiquement toutes les 10 minutes et chaque fois que vous accéderez à l'espace de travail.
  • Cliquez sur Afficher les journaux pour afficher les journaux d'activité de votre intégration Jira et voir quelles modifications ont été apportées avant la dernière synchronisation.

Synchronisation hiérarchique

La synchronisation de la hiérarchie pour Jira vous permet de synchroniser automatiquement les relations parent-enfant de votre projet Jira vers airfocus. Cela vous permet d'effectuer vos tâches de gestion de produits sur airfocus tout en ayant sous les yeux la dernière hiérarchie Jira, sans avoir à basculer entre airfocus et Jira.

Pour configurer/activer la synchronisation de la hiérarchie pour Jira, vous aurez besoin de :

  • Deux espaces de travail ou plus entre lesquels la hiérarchie « airfocus » est activée, OU un espace de travail autorisant des relations hiérarchiques au sein même de cet espace.
  • Deux ou plusieurs types d'enjeux Jira synchronisés avec airfocus.
  • Si vous avez deux intégrations dans deux espaces de travail, synchronisez un seul type d'élément pour chaque espace de travail.
  • Si vous avez deux intégrations dans un espace de travail, synchronisez un seul type d'élément pour chacune des intégrations dans cet espace de travail.

Un utilisateur doit avoir un accès complet à l'espace de travail pour pouvoir modifier quoi que ce soit dans l'intégration.

Pour configurer la synchronisation des hiérarchies, procédez comme suit :

  1. Dans les paramètres de l'espace de travail d'airfocus, assurez-vous que la hiérarchie des produits airfocus est activée avec un autre espace de travail ou dans votre espace de travail actuel.
    intégrer-avec-jira-26.png
  2. En bas de la page des paramètres d'intégration Jira, activez le widget "Automatic item linking".
  3. Vous pouvez choisir n'importe quel espace de travail qui remplit les conditions suivantes :
    • L'autre espace de travail a une relation hiérarchique avec l'espace actuel.
    • L'autre espace de travail est intégré à la même instance Jira.
    • L'utilisateur a un accès complet à l'autre espace de travail.
    • L'autre espace de travail se trouve dans la même équipe airfocus.

Lorsque la synchronisation de la hiérarchie est activée, vous pouvez voir les relations parent-enfant directement dans l'airfocus.

intégrer-avec-jira-28.png

Notez les points suivants lorsque vous activez la synchronisation de la hiérarchie pour Jira :

  • L'intégration n'ajoute que les relations entre les éléments synchronisés, et non des éléments supplémentaires. Cela signifie que les éléments doivent déjà être synchronisés par leur intégration respective avant que les liens hiérarchiques ne soient synchronisés.
  • L'API Jira ne révèle pas les enfants d'une épopée, ce qui empêche airfocus de détecter si une épopée Jira a des problèmes d'enfants. Pour que les relations entre les enfants soient visibles dans airfocus, l'épopée doit déjà être synchronisée avec airfocus lorsque vous synchronisez les problèmes au niveau des enfants, afin que toutes les relations soient reflétées correctement dans airfocus.

La synchronisation de la hiérarchie pour Jira peut également être configurée dans le même espace de travail, si plusieurs types d'enjeux Jira sont synchronisés avec le même espace de travail airfocus (par le biais d'une seule ou de plusieurs intégrations) et que l'option " Autoriser les relations hiérarchiques dans cet espace de travail " a été activée dans l'onglet Hiérarchie des paramètres de l'espace de travail.

Un utilisateur doit avoir au moins un accès en lecture au projet Jira connecté afin d'activer la synchronisation de la hiérarchie pour Jira.

Note concernant la synchronisation de la hiérarchie pour les utilisateurs du centre de données Jira/on-prem :

  • La hiérarchie airfocus n'est pas synchronisée avec les initiatives Jira on-prem. Uniquement les épopées, les histoires, les tâches et les sous-tâches.
  • La hiérarchie airfocus est synchronisée avec tous les niveaux de Jira Cloud, y compris les initiatives, les épopées, les histoires, les tâches et les sous-tâches.

Informations supplémentaires

Connecter plusieurs projets Jira

Pour connecter un autre projet Jira de la même instance Jira à votre espace de travail, vous n'avez pas besoin de repasser par le processus d'authentification. Vous pouvez désormais ajouter une autre intégration de projet Jira sur la page des intégrations. L'installation ne nécessitera que la sélection de l'instance et le démarrage immédiat du mappage.

Adresses IP statiques à mettre sur liste blanche pour l'intégration de votre serveur Jira

Si vous intégrez un système de déploiement sur site tel que Jira Server, votre équipe informatique devra peut-être autoriser la liste airfocus dans votre pare-feu afin qu'airfocus puisse établir des connexions avec votre serveur pour créer des enregistrements. Vous pouvez vous connecter via le port 443.

Les équipes sur https://app.airfocus.com ou https://app.us.airfocus.com utilisent ces adresses IP :

  • 46.101.71.101
  • 46.101.69.142

Équipes sur https://airfocus.app  utiliser ces adresses IP :

  • 100.24.176.163
  • 34.204.246.112
  • 54.227.154.184
  • 35.156.253.227
  • 18.159.159.136
  • 18.199.183.125

Résolution des problèmes

  • Vérifiez que les autorisations de l'utilisateur qui tente de connecter airfocus à Jira correspondent aux exigences.
  • Vérifiez qu'il n'y a pas d'avertissement ou de champs manquants dans la section de mise en correspondance des champs.
  • Cliquez sur le bouton "Debug" en bas des paramètres d'intégration. Pendant la synchronisation, plusieurs points de terminaison de l'API sont appelés. Si l'un d'entre eux est défaillant, il est difficile de savoir lequel. La boîte de dialogue de débogage affiche tous les appels et leurs résultats, ce qui vous permet de trouver plus facilement une mauvaise configuration.
  • Supprimez et réinstallez l'intégration. Conseil : le lien d'application configuré pour connecter airfocus à Jira est conservé.
  • Contactez notre charmante équipe d'assistance à la clientèle pour obtenir de l'aide supplémentaire.

Donnez votre avis sur cet article

Vous avez des commentaires sur cet article ? Racontez-nous votre expérience ici.

Vous avez trouvé ce que vous cherchiez ?

Vous avez encore une question ou vous voulez partager ce que vous avez appris ? Visitez notre Communauté   pour obtenir de l’aide et collaborer avec les autres.