- 06 Sep 2023
- 7 Minutes à lire
- Impression
- SombreLumière
- PDF
Intégration de synchronisation Airtable : Jira Server/Data Center
- Mis à jour le 06 Sep 2023
- 7 Minutes à lire
- Impression
- SombreLumière
- PDF
Découvrez comment utiliser la fonctionnalité d’intégration de synchronisation Airtable pour récupérer des informations depuis des applications externes et les organiser dans un tableau unique centralisé au sein d’Airtable. Cet article décrit comment synchroniser les problèmes Jira Server/Data Center avec une base Airtable. Nous utiliserons le terme Jira Server pour parler de Jira Server et Jira Data Center, car les mêmes étapes sont applicables aux deux produits. Cette synchronisation s’adresse spécifiquement aux organisations utilisant Jira sur site. Si votre organisation utilise Jira Cloud, vous pouvez lire un article d’assistance distinct à ce sujet. Pour le moment, cette source de synchronisation est uniquement disponible avec un forfait Enterprise.
Si vous configurez la première synchronisation Jira Server de votre organisation, pensez à vérifier que votre responsable informatique et les admins Airtable/Jira ont passé en revue les exigences en matière de serveur et de pare-feu et pris les mesures nécessaires avant de connecter le compte Jira Server à Airtable. Ces étapes ne doivent être réalisées qu’une seule fois.
Introduction
Disponibilité avec les forfaits | Espaces de travail avec un forfait Enterprise uniquement |
Autorisations |
|
Plateforme(s) | Web/navigateur, app Mac et app Windows |
Sujets associés |
|
Configuration d’une synchronisation avec Jira Server
Pour commencer, cliquez sur le symbole + à côté de votre liste de tableaux. Ensuite, sélectionnez l’option « Jira Server » sous « Synchroniser des données à partir de ».
Sélectionnez un compte Jira Server existant, ou connectez-vous à un nouveau compte Jira Server. Vous pourrez voir la liste des instances Jira Server configurées par votre admin Airtable. Pour connecter un compte Jira Server, sélectionnez l’instance Jira Server que vous souhaitez utiliser pour créer le tableau synchronisé. Si vous ne voyez pas le serveur que vous voulez utiliser, contactez l’équipe du compte Airtable pour lui demander de l’ajouter à la liste.
Lorsque vous cliquez sur « Continuer », un message vous demandant d’autoriser Airtable à se connecter à votre compte Jira Server s’affiche. Pour plus d’informations sur l’authentification, passez à la suite.
Une fois connecté(e) à Jira Server, vous pourrez choisir quel « Filtre » de problème utiliser pour créer des entrées Airtable.
Si vous recevez le message d’erreur « Impossible d’autoriser le compte », il se peut que le compte connecté ait atteint le taux limite de l’API REST de Jira.
Dans le cadre de cette synchronisation, seuls les filtres ajoutés aux favoris sont disponibles. Consultez la documentation d’Atlassian si vous avez besoin d’aide pour configurer un nouveau filtre ou ajouter un filtre à vos favoris. Il est important de choisir un filtre dont les conditions ne changeront pas. Lorsque les conditions d’un filtre sont modifiées dans Jira, les entrées qui ne correspondent plus sont supprimées, tout comme les ajouts effectués dans Airtable.
Par exemple, si vous avez synchronisé un filtre ne comportant que des bugs actifs et que l’un d’entre eux devient inactif, l’entrée Airtable sera supprimée avec l’ensemble des commentaires et de l’activité qui y sont associés, ainsi que les autres données de champ pouvant avoir été ajoutées. Si ce même bug est rendu actif à nouveau, une nouvelle entrée Airtable sera créée.
C’est la raison pour laquelle nous recommandons de choisir un filtre auquel aucune modification ne sera apportée.
Lorsque vous cliquez sur « Suivant », deux options de synchronisation s’offrent à vous. Vous pouvez synchroniser :
- Tous les champs de la vue source (filtre Jira), y compris tous les champs ajoutés par Jira ultérieurement.
- Des champs spécifiques de la vue source (filtre Jira).
Si vous optez pour la synchronisation de filtres spécifiques, un menu vous permettant d’activer ou de désactiver les champs individuels que vous souhaitez synchroniser depuis Jira s’affiche.
Vous trouverez plus d’informations sur les filtres Jira ci-dessous.
Avant de créer votre tableau synchronisé, vous devez accéder aux paramètres et sélectionner des options pour définir la fréquence de synchronisation et la manière dont sont gérées les entrées supprimées ou masquées au niveau de la source (Jira). Ces options sont les suivantes :
- La fréquence de synchronisation. Les options disponibles actuellement sont la synchronisation manuelle et la synchronisation automatique, qui se répète toutes les cinq minutes environ.
- Retirer ou non les entrées supprimées (les problèmes figurant dans le filtre Jira sélectionné) du tableau Airtable. Par défaut, les évènements supprimés sont retirés.
Une fois vos paramètres définis, cliquez sur le bouton « Créer un tableau ». L’opération de synchronisation va récupérer tous les problèmes à partir du filtre Jira sélectionné, puis générer des entrées Airtable.
Découverte des champs Jira pris en charge
Vous trouverez ci-dessous une liste de toutes les données de champs fournies par Jira pouvant être synchronisées avec Airtable grâce aux outils de configuration natifs proposés par Airtable :
Clé du problème | Priorité | Parent |
Récapitulatif | Libellés | Environnement |
Description | Temps passé | Versions affectées |
Statut | Cumul | Nom de l’Epic |
Projet | Temps passé | Sprint |
Type de problème | Temps restant | Rapporteur |
Créé | Temps cumulé restant | Marqué |
Mis à jour | Estimation d’origine | Estimation Story Point |
Composants | Date d’échéance | Date de début |
Story Points | Couleur du problème | |
Versions à corriger | Attribué à |
Cette liste comporte uniquement des champs personnalisés, et non pas les champs système évoqués ci-dessus. Les noms et les types correspondent aux champs personnalisés de la page /ViewCustomFields de Jira Server.
> paramètres > problèmes > champs personnalisés
Vous trouverez plus d’informations sur la différence entre les champs « standard » et « avancé » dans la documentation de Jira.
Type de champ personnalisé | Notes |
---|---|
Champ numérique | Standard |
Cases à cocher | Standard |
Liste de sélection (choix multiples/choix unique) | Standard |
Boutons radio | Standard |
Sélecteur de date et d’heure | Standard |
Sélecteur de date | Standard |
Libellés | Standard |
Champ de texte (plusieurs lignes/ligne unique) | Standard |
Sélecteur d’utilisateur (utilisateur unique) | Standard. Synchronisé sous forme de textes simples. |
Champ d’URL | Standard |
Rang global | Avancé |
Champ de sprint Jira | Avancé |
Types de champs non pris en charge | Avancé. Peut uniquement être affiché une fois intégré à un problème. |
Début cible | Avancé |
Fin cible | Avancé |
Sélecteur d’utilisateurs (plusieurs utilisateurs) | Avancé |
Changement de tâche masqué | Avancé |
Case à cocher de tâche | Avancé |
Sélecteur de projet (projet unique) | Avancé |
Champ de texte (lecture seule) | Avancé |
Sélecteur d’utilisateurs (plusieurs utilisateurs) | Avancé |
Les noms de champs préenregistrés/verrouillés sont aussi considérés comme des champs personnalisés dans Jira. Les utilisateurs de Jira ne peuvent pas créer d’autres champs personnalisés avec ces noms.
Nom du champ | Fonction du champ | Notes |
---|---|---|
Couleur Epic | Couleur de l’Epic | |
Lien Epic | Relation du lien Epic | S’affichera uniquement si le problème n’est PAS un Epic |
Nom Epic | Nom de l’Epic | S’affichera uniquement si le problème est un Epic |
Statut Epic | Statut de l’Epic | S’affichera uniquement si le problème est un Epic |
Rang | Rang global | Avancé |
Sprint | Champ de sprint Jira | Avancé |
Story points originaux | Story points originaux | Avancé |
Début cible | Date de début cible | Avancé |
Fin cible | Date de fin cible | Avancé |
Nom du champ | Type de champ | Notes |
---|---|---|
Liste de sélection | En cascade | Avancé |
Lien parent | Inconnu | Avancé : champ impossible à configurer |
Équipe | Inconnu | Avancé : champ impossible à configurer |
Sélecteur de version | Version(s) unique(s)/multiple(s) | Avancé |
Développement | Inconnu | Avancé : champ impossible à configurer |
Sélecteur de groupe | Groupe(s) unique(s)/multiple(s) | Avancé] |
Historique des versions publiées de Jira | Avancé |
Sécurité et périmètres OAuth
Authentification
L’intégration de Jira Server à Airtable utilise OAuth pour authentifier les requêtes des utilisateurs individuels au sein de votre instance Jira Server. L’écran de consentement OAuth ressemble à ceci :
Airtable aura uniquement accès aux problèmes et aux filtres auxquels a accès l’utilisateur qui a effectué la synchronisation avec Jira. Si le compte Jira ou Airtable de l’utilisateur ayant effectué la synchronisation avec Jira est désactivé, la synchronisation cessera de fonctionner.
Champs d’application de Jira Server
Airtable intègre Jira Server (sur site) via OAuth 1.0a. Il n’est pas nécessaire de fournir de champs d’application. De plus, les autorisations d’intégration correspondront aux autorisations individuelles accordées dans Jira Server. Pour en savoir plus, consultez la documentation de Jira ici.
Les jetons sont transmis entre les serveurs Airtable et Jira de manière sécurisée via HTTPS. Du côté d’Airtable, les jetons sont stockés dans des bases de données chiffrées lorsqu’elles ne sont pas utilisées.
FAQ
Airtable a uniquement accès aux problèmes et aux filtres auxquels peut accéder l’utilisateur qui a configuré la synchronisation avec Jira.
Contrairement à la fonctionnalité d’intégration de synchronisation avec Jira Cloud d’Airtable, la synchronisation avec Jira Server/Data Center peut uniquement récupérer les informations contenues dans les filtres ajoutés aux favoris.
Si ce compte est désactivé, la synchronisation cessera de fonctionner.
Les champs personnalisés basés sur les types de champs intégrés à Jira sont pris en charge, mais les autres types de champs personnalisés ne sont pas compatibles. Vous trouverez plus de détails à ce sujet ci-dessus.
Le nombre maximal de problèmes synchronisés est de 10 000. Nous imposons cette limite pour garantir de bonnes performances.
Oui. Pour protéger Jira Server, nous imposons par défaut une limite de cinq par seconde au nombre de requêtes API qu’Airtable peut envoyer vers votre instance Jira Server. Si vous avez des questions ou des doutes au sujet de cette limite, veuillez contacter l’équipe de votre compte Airtable.
En outre, la quantité de données pouvant être transférée par requête par l’API Jira est très limitée, c’est pourquoi les performances moyennes sont définies à 1 seconde pour 100 problèmes. Nous vous recommandons de sélectionner vos filtres de manière à restreindre au maximum votre requête.
Oui, ce type de synchronisation Airtable nécessite Jira Software 7.13 ou une version ultérieure.