Intégrer airfocus à Shortcut

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

Utilisez cette intégration bidirectionnelle pour transférer des épopées ou des histoires dans Shortcut et suivre leur état à partir d'airfocus.

Avantages

Utilisez l'intégration flexible des raccourcis d'airfocus pour hiérarchiser vos histoires et vos épopées afin d'élaborer des feuilles de route plus efficaces. Collaborez à l'établissement de vos priorités afin de faire ce qu'il faut. L'intégration de Shortcut permet de synchroniser la stratégie de haut niveau avec le développement quotidien.

  • Importer des épopées et des histoires en raccourci (en tant qu'éléments) dans l'airfocus.
  • Placez des éléments prioritaires dans Shortcut en vue de leur développement et suivez leur état d'avancement directement depuis airfocus.
  • Créez un flux de travail flexible de filtrage et de mappage, par exemple associer plusieurs états de raccourci au même état d'airfocus.
  • Gardez les champs synchronisés entre les deux systèmes, y compris le titre, la description, l'état/la voie, l'étiquette (synchronisation bidirectionnelle).

Configuration initiale

Naviguez vers l'espace de travail airfocus avec lequel vous souhaitez configurer l'intégration des raccourcis. Allez sur "Extensions" et ensuite "Ajouter des intégrations". Localisez l'intégration des raccourcis et cliquez sur "Connect".

intégrer-avec-court-circuit-1.png
intégrer-avec-court-circuit-2.png

Saisissez un code API de raccourci. Pour générer un jeton, ouvrez l'application Raccourci, allez dans Paramètres Votre compte Jetons d'API et générez un jeton d'API. Cliquez sur "Procédez".

intégrer-avec-court-circuit-3.png

Remarques :

  • Lors de la mise en place d'une intégration de Shortcut dans airfocus, vous devez choisir si vous souhaitez importer & sync Shortcut epics ou Shortcut stories avec airfocus.
  • Vous ne pouvez intégrer qu'un seul flux de travail raccourci à la fois. Si vous souhaitez intégrer a) plusieurs flux de travail Shortcut ou b) à la fois un flux de travail (avec ses projets & stories) ET des épopées dans le même espace de travail airfocus, veuillez configurer plusieurs intégrations.

Filtres d'intégration

Vous devez d'abord choisir si vous souhaitez synchroniser vos épopées ou vos histoires à partir de Shortcut.

SI vous avez choisi des histoires, vous pouvez en outre réduire la sélection d'éléments pour votre synchronisation :

intégrer-avec-court-circuit-4.png
  • Vous pouvez également choisir un projet si vous utilisez encore cette ancienne fonction sur Raccourci.
  • Vous pouvez choisir des étiquettes pour limiter l'importation. Si vous laissez ce champ vide, toutes les histoires correspondant aux autres filtres seront prises en compte.

SI vous avez choisi des épopées, vous pouvez en outre restreindre la sélection des éléments pour votre synchronisation en choisissant éventuellement des étiquettes pour limiter l'importation.

intégrer-avec-court-circuit-5.png

Cartographie de terrain

Utilisez le mappage pour définir comment les informations contenues dans Shortcut doivent être mappées dans airfocus (et vice versa). Les noms des histoires/épopées (obligatoires) et les descriptions (facultatives) sont toujours mappés par défaut lors de la mise en place d'une nouvelle intégration.

Comment définir les directions cartographiques

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

intégrer-avec-court-circuit-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". 

intégrer-avec-court-circuit-7.png

Par défaut, la direction de mappage est réglée sur Raccourci vers airfocus uniquement et peut être modifiée par l'utilisateur en fonction de 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 seront affichés dans la liste déroulante à l'autre extrémité. Après avoir sélectionné les deux champs que vous souhaitez mettre en correspondance, vous pouvez choisir les options de champ et la manière dont ils doivent être mis en correspondance.

intégrer-avec-court-circuit-8.png

Options de cartographie de terrain pour les histoires

Raccourci airfocus Raccourci → airfocus airfocus → Raccourci airfocus ↔ Raccourci
Nom Nom de l'article
Description Description de l'article ⚠️
État Statut / champ personnalisé à sélection unique
Priorité Champ de sélection unique personnalisé
Gravité Champ de sélection unique personnalisé
Intitulé Champ multi-sélection personnalisé
Champ personnalisé Champ de sélection unique personnalisé
Estimation Champ de chiffres personnalisé
Date de fin Champ de date personnalisé

Options de cartographie des champs pour les épopées

Raccourci airfocus Raccourci → airfocus airfocus → Raccourci airfocus ↔ Raccourci
Nom Nom de l'article
Description Description de l'article ⚠️
État Statut / champ personnalisé à sélection unique
Intitulé Champ multi-sélection personnalisé
Date de début Champ de date personnalisé
Date de fin Champ de date personnalisé
Champ date de début + date de fin (par paire) Champ de date personnalisé
Estimation Champ de chiffres personnalisé

⚠️ AVERTISSEMENT : Les utilisateurs peuvent désormais activer la synchronisation bidirectionnelle pour le champ de description. Toutefois, le processus de synchronisation bidirectionnelle peut entraîner de légères modifications du contenu et de la mise en forme de vos descriptions de raccourcis. Cela est dû au fait que tous les styles de raccourcis ne sont pas encore pris en charge par airfocus.

Notes

  • Les champs airfocus qui sont mappés à sens unique de Shortcut vers airfocus deviennent des champs en lecture seule dans airfocus, car toute modification apportée par un utilisateur à ces champs sera écrasée lors de la prochaine synchronisation.
  • Si l'un des champs de date du raccourci n'est pas défini ou si la date d'échéance d'un raccourci épique est antérieure à la date de début, airfocus remplit la date de début avec une date antérieure d'un jour à la date d'échéance.
  • Vous pouvez définir l'étiquette que vous souhaitez attacher aux éléments de travail raccourcis synchronisés par défaut si vous avez configuré au moins une correspondance de champ multi-sélection. (Le paramétrage apparaîtra comme une sous-section de cette cartographie).

Réglages supplémentaires

Lorsque l'option "Archiver les éléments inconnus" est activée, les éléments précédemment importés seront archivés dans airfocus, s'ils ne sont plus présents dans Shortcut ou s'ils n'entrent plus dans les filtres définis pour l'intégration.

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.

Lorsque vous cliquez sur "Afficher les journaux", vous pouvez afficher les journaux d'activité de l'intégration des raccourcis et voir quelles modifications ont été apportées avant la dernière synchronisation.

intégrer-avec-court-circuit-9.png

Pour enregistrer vos paramètres et importer vos histoires/photos sur airfocus, cliquez sur mettre à jour et synchroniser.

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.