Connectez votre stratégie produit dans airfocus avec votre exécution de développement dans Azure DevOps 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 Azure DevOps, 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 de l'intégration Azure DevOps
- Importez les éléments de travail Azure DevOps dans airfocus.
- Introduisez les éléments airfocus dans Azure DevOps (comme n'importe quel type d'élément de travail).
- Filtrage flexible (via Azure DevOps Issue Search).
- Cartographie flexible pour les champs système et personnalisés avec des directions de synchronisation configurables par champ.
- Faites correspondre directement les descriptions Azure DevOps aux descriptions airfocus.
- Affichez vos itérations (sprints) dans airfocus pour obtenir un contexte autour de la valeur et des priorités de l'entreprise.
Mise en place de l'intégration
Les intégrations dans airfocus se connectent toujours à un espace de travail airfocus spécifique. Vous pouvez ajouter plusieurs intégrations Azure DevOps à un espace de travail donné (par exemple, à partir de différents projets Azure DevOps ou pour différents types d'éléments de travail).
Remarque : assurez-vous que le compte Azure DevOps avec lequel vous configurez l'intégration est affecté au groupe d'autorisations Project Collection Administrator, afin de vous assurer que vous disposez d'un accès de niveau administrateur à l'organisation que vous souhaitez synchroniser.
Pour configurer l'intégration Azure DevOps, procédez comme suit :
- Inscrivez-vous à airfocus ou connectez-vous à votre compte existant.
- Créez un nouvel espace de travail dans airfocus ou sélectionnez celui avec lequel vous souhaitez intégrer Azure DevOps.
- Cliquez sur Extensions dans le coin supérieur droit de la page.
- Sélectionnez Gérer les intégrations.
- Cliquez sur Connect dans la tuile "Azure DevOps".
À partir de là, les étapes diffèrent en fonction de votre type d'instance. Lisez les sections ci-dessous pour connaître les étapes de chacune d'entre elles.
Connectez-vous à votre compte Azure DevOps Cloud
Pour continuer à configurer l'intégration pour un compte Azure DevOps Cloud, procédez comme suit :
- Sélectionnez Azure Cloud dans le sélecteur de type d'instance.
- Cliquez sur Continuer.
Vous serez redirigé vers Azure DevOps pour authentifier vos autorisations d'accès et, après vous être connecté à votre compte, vous serez redirigé vers la page des intégrations airfocus de votre espace de travail.
Assurez-vous que le paramètre "Third-party application access via OAuth" est activé dans l'écran des politiques d'organisation sur Azure DevOps pour garantir une intégration réussie.
Connectez-vous à votre compte Azure DevOps Server (sur site)
Pour continuer à configurer l'intégration pour un compte Azure DevOps Cloud, procédez comme suit :
- Sélectionnez Azure On-Premise dans le sélecteur de type d'instance.
- Cliquez sur Continuer.
- Entrez les détails pour vous connecter à votre instance Azure DevOps Server.
- Base URL: Saisissez la première partie de l'URL de votre serveur Azure DevOps (tout ce qui précède la fin de votre domaine/adresse IP et la première barre oblique inverse). Par exemple : https://198.254.533.325. L'URL doit être accessible par nos serveurs, vous ne pouvez donc pas utiliser d'URL hébergés localement.
- Jeton d'accès personnel: Obtenez votre jeton d'accès personnel en allant dans la section des jetons d'accès personnels des paramètres de sécurité de vos utilisateurs Azure DevOps. Pour plus de détails, voir la section "Obtenir un jeton d'accès personnel" ci-dessous.
- Nom de l'organisation: saisissez le nom exact de l'organisation Azure DevOps que vous souhaitez synchroniser avec airfocus.
- Cliquez sur Continuer pour connecter votre équipe airfocus à votre organisation Azure DevOps.
Obtenir un jeton d'accès personnel
Pour obtenir votre jeton d'accès personnel dans Azure DevOps, procédez comme suit :
- Ouvrez vos paramètres de sécurité ADO.
- Sélectionnez Jetons d'accès personnels dans le menu de navigation situé à gauche de la page.
- Cliquez sur + New Token en haut de la page.
- Créez un nouveau jeton avec au moins les autorisations suivantes :
- Éléments de travail (lecture et écriture)
- Projet et équipe (lire)
- Les jetons d'accès personnels peuvent être configurés pour une durée maximale d'un an. N'oubliez pas de maintenir la validité de votre jeton à jour afin que votre intégration airfocus puisse fonctionner sans interruption.
- Cliquez sur Créer.
- Copiez le jeton et collez-le dans vos paramètres d'intégration dans airfocus.
Configurez vos filtres d'intégration
Pour configurer vos filtres d'intégration :
- Sélectionnez le projet Azure DevOps avec lequel vous souhaitez vous intégrer. Ajoutez les informations suivantes pour qu'airfocus sache où envoyer les données :
- Organisation
- Projet
- Zone
- Si vous le souhaitez, vous pouvez inclure les éléments de travail de tous les sous-domaines du domaine sélectionné en cochant la case située à côté de "Inclure les éléments de travail de tous les sous-domaines du domaine sélectionné".
Vous pouvez également spécifier les éléments de travail que vous souhaitez synchroniser en utilisant le champ Azure DevOps Issue Search dans les paramètres d'intégration. Il permet d'effectuer des recherches rapides et flexibles dans tous vos éléments de travail et dans tous vos projets (par ex. t:epic AND s:new).
Filtres communs
- Pour filtrer par type d'élément de travail Azure DevOps :
- t:epic
- t:feature
- t:story
- t:tâche
Pour récupérer des éléments avec une étiquette Azure DevOps spécifique
- tags:tag abc
Pour récupérer les éléments d'une itération Azure DevOps spécifique.
- itération:itération abc
Pour en savoir plus sur la recherche avancée , cliquez ici.
Configurez votre cartographie des champs
Utilisez le mappage pour définir comment les informations dans Azure DevOps doivent être mappées dans airfocus (et vice versa). Les noms des éléments (obligatoire) et les descriptions des éléments (facultatif) sont toujours mappés par défaut lors de la mise en place d'une nouvelle intégration.
Comment définir les directions cartographiques
Définissez pour chacun de vos champs si vous souhaitez une synchronisation unidirectionnelle ou bidirectionnelle entre le champ dans Azure DevOps et airfocus.
Définissez les directions de mappage pour tous les champs en une seule fois à l'aide du menu déroulant "Définir la direction".
Par défaut, la direction du mappage est définie d'Azure DevOps à airfocus uniquement et peut être modifiée par l'utilisateur pour tout ce qui est disponible pour le mappage.
Comment ajouter une nouvelle cartographie de champ
Lorsque vous sélectionnez un champ dans la liste déroulante, seuls les champs correspondant au type de champ sont affichés dans la liste déroulante à l'autre extrémité.
Après avoir sélectionné deux champs à mapper, vous pouvez sélectionner les options de champ et la manière dont ils doivent être mappés :
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 Azure DevOps.
Génération automatique de valeurs de champs
Activez "Options de création automatique de champs" pour ajouter automatiquement à airfocus les nouveaux champs créés dans Azure DevOps lorsqu'ils sont ajoutés à un élément.
Note: Le générateur de champs à création automatique ne tient pas compte des majuscules et des minuscules.
Vue d'ensemble de toutes les options de cartographie des champs actuellement disponibles
| Azure DevOps | airfocus | ADO → airfocus | airfocus → ADO |
| Nom de la question | Nom de l'article | ✅ | ✅ |
| Description de la question | Description de l'article | ✅ | ✅ ⚠️ Note : 1 |
| Statut de la question | Statut / champ personnalisé à sélection unique | ✅ | ✅ |
| Étiquettes d'émission (anciennes étiquettes) | Champ multi-sélection personnalisé | ✅ | ✅ |
| Champ booléen | Champ booléen personnalisé | ✅ | ✅ Note : 2 |
| Champ de texte (une seule ligne) | Champ de texte personnalisé | ✅ | ✅ Note : 2 |
| Champ numérique (entier, double) Note : 3 | Champ de chiffres personnalisé | ✅ | ✅ Note : 2 |
| Champ de priorité | Champ de chiffres personnalisé | ✅ | ✅ Note : 2 |
| Champ d'effort | Champ de chiffres personnalisé | ✅ | ✅ Note : 2 |
| Champ Picklist de texte avec valeurs personnalisées autorisées Note : 4 |
Champ de texte personnalisé | ✅ | ✅ Note : 2 |
| Champ de la liste de sélection des numéros avec les valeurs personnalisées autorisées Note : 4 |
Champ de chiffres personnalisé | ✅ | ✅ Note : 2 |
| Toute autre liste de sélection avec des valeurs personnalisées désactivées Remarque : 4 |
Champ personnalisé à sélection unique | ✅ | ✅ Note : 2 |
| Champ date-heure Note : 5 |
Champ de date personnalisé | ✅ |
✅ ⚠️ |
| Paires de champs date-heure Note : 7 |
Champ de date personnalisé | ✅ | ✅ Note : 2 |
| Itération/impression Dates de début et de fin | Champ de date personnalisé | ✅ | ❌ |
| Nom de l'itération/de l'impression | Champ personnalisé à sélection unique | ✅ | ✅ |
| Points d'histoire (nombre) | Champ de chiffres personnalisé | ✅ | ✅ |
| Priorité de l'arriéré (nombre) | Champ de chiffres personnalisé | ✅ | ✅ |
| Rang de la pile (nombre) | Champ de chiffres personnalisé | ✅ | ✅ Note : 8 |
| Dépendances | Dépendances | ❌ | ❌ |
| ID de la question | ID de l'article | ❌ | ❌ |
| Critères d'acceptation | ❌ | ❌ | ❌ |
| Pièces jointes | Pièces jointes | ❌ | ❌ |
Notes
- ⚠️ Si la description est synchronisée dans les deux sens, il se peut qu'airfocus modifie légèrement le contenu et la mise en forme de vos descriptions Azure DevOps. Cela est dû au fait que tous les styles Azure DevOps ne sont pas encore pris en charge de manière native par Airfocus.
- Le mappage dans cette direction ne peut pas être pris en charge si le champ cible dans ADO est configuré en lecture seule.
- Cela inclut uniquement les champs numériques personnalisés d'ADO. Les champs numériques du système doivent être implémentés séparément (comme par exemple la priorité ou l'effort). Par conséquent, si un champ numérique du système n'est pas explicitement mentionné dans ce tableau, cela signifie qu'il n'est pas encore pris en charge.
- Les listes de sélection avec des valeurs personnalisées autorisées ne conviennent pas à la mise en correspondance avec les champs de sélection airfocus, car le nombre d'options de sélection dans ce cas est dynamique et peut fréquemment changer au fil du temps, ce qui nécessiterait de reconfigurer la mise en correspondance de l'intégration à chaque fois qu'une nouvelle valeur apparaît dans la liste de sélection. C'est pourquoi nous faisons correspondre ces listes de sélection à des champs textuels ou numériques ordinaires dans l'airfocus, de sorte que toute nouvelle valeur du côté ADO est toujours automatiquement synchronisée avec le côté airfocus.
- Cela inclut les champs personnalisés de type date-heure, ainsi que les champs système Date de début, Date cible, Date d'échéance, Date de résolution et Date de changement d'état.
- ⚠️ Pour l'instant, airfocus ne prend pas en charge les champs date-heure (avec la partie temporelle), mais uniquement les champs date. Par conséquent, la mise en correspondance de champs date-heure ADO avec des champs date airfocus dans les deux sens entraîne la perte de la partie heure du côté ADO - l'heure sera réinitialisée par airfocus à 00:00:00.
- À l'heure actuelle, ADO ne dispose pas de champs de dates intégrés. Il est toutefois possible de faire correspondre une paire de champs ADO de type date-heure à un champ airfocus de type plage de dates.
- Le mappage du champ Stack Rank d'airfocus vers Azure DevOps peut entraîner un comportement inattendu. La documentation Microsoft recommande de ne pas mettre à jour manuellement ce champ, car Azure DevOps calcule dynamiquement le classement des piles en arrière-plan pour maintenir les priorités du carnet de commandes. Il est préférable de l'utiliser comme une synchronisation à sens unique entre ADO et airfocus.
Synchronisation hiérarchique
Hierarchy sync for Azure DevOps vous permet de synchroniser automatiquement les relations parent-enfant de votre projet Azure DevOps vers airfocus (à sens unique pour l'instant). Cela vous permet de faire du travail de gestion de produits sur airfocus tout en ayant la dernière hiérarchie Azure DevOps en vue, sans avoir besoin de passer d'airfocus à Azure DevOps.
Pour configurer/activer la synchronisation de la hiérarchie pour Azure DevOps, vous aurez besoin de :
- Deux espaces de travail ou plus avec la hiérarchie airfocus activée entre eux OU un espace de travail qui autorise les relations hiérarchiques au sein du même espace de travail.
- Deux types d'éléments de travail Azure DevOps ou plus ont été 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 les paramètres d'intégration.
Pour configurer la synchronisation des hiérarchies, procédez comme suit :
- 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.
- En bas de la page des paramètres d'intégration Azure DevOps, activez le widget "Automatic item linking".
- Pour garantir le maintien de la hiérarchie, assurez-vous que les espaces de travail remplissent les conditions suivantes :
- L'autre espace de travail est intégré à la même organisation Azure DevOps.
- 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.
Notez les points suivants lorsque vous activez la synchronisation de la hiérarchie pour Azure DevOps :
- 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.
- La synchronisation de la hiérarchie pour Azure DevOps peut également être configurée dans le même espace de travail, si plusieurs types d'éléments de travail Azure DevOps 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 Azure DevOps connecté afin d'activer la synchronisation de la hiérarchie pour Azure DevOps.
Réglages supplémentaires
- Lorsque l'option "Archive unknown issues" est activée, les éléments précédemment importés sont archivés dans airfocus s'ils ne sont plus présents dans Azure DevOps ou s'ils ne correspondent plus aux filtres définis pour l'intégration.
- Lorsque "Synchronisation automatique" est activé, votre intégration se synchronise automatiquement toutes les 10 minutes et chaque fois que vous accédez à l'espace de travail.
- Cliquez sur Afficher les journaux pour afficher les journaux d'activité de votre intégration Azure DevOps et voir quelles modifications ont été apportées avant la dernière synchronisation.
Pour enregistrer vos paramètres et importer vos éléments dans airfocus, cliquez sur Mettre à jour et synchroniser.
Adresses IP statiques à mettre sur liste blanche pour votre intégration Azure DevOps
Équipes sur https://app.airfocus.com ou https://app.us.airfocus.com utiliser 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
Informations importantes
- Pour créer/authentifier une nouvelle intégration avec Azure DevOps, le compte Azure DevOps utilisé doit avoir un accès de niveau administrateur.
- Pour modifier une intégration existante sur airfocus, l'utilisateur doit disposer des droits complets sur l'espace de travail.
- Même si l'utilisateur airfocus n'a pas accès au compte Azure DevOps utilisé pour la configuration initiale, le compte Azure DevOps doit conserver les mêmes autorisations pour garantir le bon fonctionnement de l'intégration à tout moment.
- Si une synchronisation bidirectionnelle a été activée auparavant, elle sera appliquée à tous les mappages dans la mesure du possible. Sinon, il s'agira d'une voie unique entre Azure DevOps et Airfocus.
- Si "Show Azure DevOps description" a été activé, l'intégration ne synchronisera la description dans le champ spécial en lecture seule que jusqu'au 31 mars 2023. Les utilisateurs doivent migrer manuellement vers le nouveau mappage des champs de description dans la section de mappage des champs de leurs intégrations. A partir du 1er avril 2023, le champ "description spéciale" (et sa bascule) ne sera plus disponible.
Donnez votre avis sur cet article
Vous avez des commentaires sur cet article ? Racontez-nous votre expérience ici.