À propos de Openflow Connector for Jira Cloud

Note

Le connecteur est soumis aux conditions d’utilisation du connecteur.

Cette rubrique décrit les concepts de base de Openflow Connector for Jira Cloud, son flux de travail et ses limites.

Le site Openflow Connector for Jira Cloud ingère les données des problèmes Atlassian Jira dans Snowflake. Il utilise l’API REST Jira Cloud et Jira Query Language (JQL) pour récupérer les données, qui sont ensuite stockées dans une table Snowflake. L’ingestion des données se déroule en deux phases :

  1. Un chargement initial, où toutes les données sont récupérées lors de l’appel initial à l’API.

  2. Les chargements incrémentiels, qui fusionnent les mises à jour et les nouvelles données dans la table de destination et utilisent les horodatages des appels précédents pour limiter le résultat aux questions qui ont été mises à jour depuis le dernier chargement.

Utilisez ce connecteur si vous souhaitez effectuer les opérations suivantes :

  • Extrayez les questions Jira et les détails du projet pour une visibilité inter-équipes et des informations plus approfondies

Workflow

  1. Un administrateur de Jira Cloud effectue les tâches suivantes :

    1. Génère un jeton API dans l’instance Jira avec les champs d’application nécessaires (read:jira-work et read:jira-user) Ce jeton sera utilisé par le connecteur pour l’authentification.

    2. Définit les critères de recherche des questions, tels que le nom du projet, le champ créé et le champ mis à jour.

  2. Un administrateur de compte Snowflake effectue les tâches suivantes :

    1. Télécharge le fichier de définition du connecteur et l’importe dans le canevas Snowflake Openflow.

    2. Configure le connecteur :

      1. Fournit l’API de jeton Jira.

      2. Spécifie l’URL d’instance Jira.

      3. Définit les critères d’intégration des problèmes, en fournissant la requête JQL ou, pour les cas les plus simples, simplement le nom du projet.

      4. Paramètre les noms de la base de données et du schéma dans le compte Snowflake.

    3. Exécute le flux du connecteur dans le canevas Openflow. Lors de l’exécution, le connecteur effectue les actions suivantes :

      1. Crée un appel d’API pour récupérer les problèmes de l’instance Jira configurée.

      2. Extraie les données pertinentes, telles que les dates de création des dossiers, les statuts et les destinataires.

      3. Crée la table de destination configurée dans la base de données Snowflake si l’appel d’API a renvoyé au moins un résultat.

      4. Charge les données traitées dans la table Snowflake spécifiée.

  3. Les utilisateurs de Snowflake Business peuvent alors accéder aux vues, et effectuer des opérations sur les données téléchargées depuis Jira Cloud vers les tables de destination.

Limitations

  • Chaque instance de connecteur ne peut être associée qu’à une seule requête de recherche JQL.

  • Les horodatages dans les propriétés des connecteurs reflètent le fuseau horaire de Jira Cloud, ce qui peut entraîner des divergences avec le fuseau horaire local de l’utilisateur. Le fuseau horaire de Jira Cloud est récupéré une fois et conservé dans l’état du processeur FetchJiraIssues. La mise à jour du fuseau horaire du connecteur nécessite l’effacement de l’état de ce processeur.

  • Le connecteur n’est pas en mesure de refléter les suppressions dans les tables Snowflake cibles, car l’API REST Jira Cloud ne renvoie pas d’informations sur la suppression de données.

  • L’authentification de base à l’aide d’un e-mail et d’un jeton d’API est la seule méthode d’autorisation prise en charge. Par conséquent, le connecteur ne peut ingérer que des données accessibles par le propriétaire du jeton d’API.

  • Le processeur FetchJiraIssues est monotâche et conçu pour fonctionner sur le nœud principal.

Prochaines étapes

Paramétrez Openflow Connector for Jira Cloud

Langage: Français