---
sourceDocument: Xanadu : créer des intégrations avec des applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications
Release :
- xanadu
ft:locale :
- fr-FR
ft:publication_title :
- Xanadu : créer des intégrations avec des applications
ft:clusterId :
- crint
bundleId :
- crint
workflow :
- Creator
---
# Jira Rayon
# Jira Rayon {#ariaid-title1}
* Rversion finale: Xanadu
*
* Mis à jour 1 août 2024
*
*  13 minutes de lecture
Gérez les problèmes, les utilisateurs, les stories et les groupes dans Jira. Récupérez les données Jira à utiliser dans un flux. Utilisez des webhooks bidirectionnels et abonnez-vous à Jira avec une URL de rappel ServiceNow.
## Demander des applications dans l'App Store {#jira-spoke-v3-0-2__section_e1f_jvb_x3b}
Visitez le site Web [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les [ServiceNow Storenotes de publication relatives à l'historique des versions](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#jira-spoke-v3-0-2__inline-send-to-store}
## Abonnement à Hub d'intégration {#jira-spoke-v3-0-2__section_rsf_yvb_l3b}
Ce spoke requiert un abonnement au Centre d'intégration. Pour plus d'informations, consultez [Calendriers juridiques - Vue d'ensemble du Centre d'intégration](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).
## Version de spoke {#jira-spoke-v3-0-2__section_llr_psv_bsb}
Jira Spoke V5.0.0 correspond à la dernière version.{#jira-spoke-v3-0-2__jira-ver}
## Dépendances des spokes {#jira-spoke-v3-0-2__section_h3x_pxb_glb}
Si vous rencontrez des difficultés pour installer l'application, assurez-vous que les modules d'extension dépendants suivants sont installés :
* Modèle d'action du Centre d'intégration ServiceNow : flux de données (com.glide.hub.action_type.datastream)
* Objet complexe (com.glide.cobject)
* Étape d'action ServiceNow Centre d'intégration : obtenir les informations de connexion (com.glide.hub.action_step.get_connection_info)
* ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
* ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
* Concepteur de flux ServiceNow : entrées dynamiques (com.glide.hub.dynamic_inputs)
* Intégrations : infrastructure d'authentification externe (com.glide.external.app)
{#jira-spoke-v3-0-2__ul_u5k_czb_glb}
Remarque :
Certains de ces modules d'extension sont des fonctionnalités sous licence et nécessitent une licence appropriée s'ils sont utilisés en dehors de l'implémentation des spokes. Pour en savoir plus sur les licences, contactez votre chargé de clientèle.
## Versions prises en charge {#jira-spoke-v3-0-2__section_vm3_334_zgb}
Ce spoke a été conçu pour la version v2 de l'API, mais peut être compatible avec les versions ultérieures.
Remarque :
* Si votre Jira instance prend en charge une autre version d'API, spécifiez la version d'API dans Version d'API dans la liste connexe Attributs. Par défaut, la version de l'API est 2. Pour en savoir plus sur la création d'un enregistrement de connexion, reportez-vous [Configurer une connexion pour le spoke Jira](https://servicenow-prod.fluidtopics.net/vQZP6rIhzn9SqABmx5Egcg#jira-basic-conf-temp "Ajoutez et configurez une connexion Jira pour authentifier les ServiceNow demandes dans le spoke Jira.") à la rubrique
* Jira Centre de services n'est pas pris en charge par le spoke.
{#jira-spoke-v3-0-2__ul_skg_2n2_rmb}
## Jira Module Webhooks {#jira-spoke-v3-0-2__section_ak4_xwn_z3b}
Des webhooks bidirectionnels peuvent être configurés pour être informé des événements requis. La politique d'acheminement définit les conditions qui doivent être remplies pour notifier l'instance ServiceNow . Ces conditions sont basées sur les événements pour Jira lesquels vous souhaitez être notifié. Lorsque les conditions sont remplies, la politique d'acheminement déclenche le flux secondaire associé, qui à son tour automatise les Jira tâches.
Les webhooks bidirectionnels nécessitent une configuration distincte et peuvent être utilisés indépendamment sans utiliser les actions de spoke. Par défaut, l'application Jira Webhooks est disponible dans le Jira et comporte les modules suivants :
* Registres Webhook Jira
* Politiques d'acheminement de WebHook Jira
{#jira-spoke-v3-0-2__ul_qzt_2h4_z3b}
Utilisez le Jira module Registres Webhook pour affecter un jeton et fournir le chemin d'accès de l'API. Vous devez générer une URL de rappel ici et fournir l'URL dans Jira. Une politique d'acheminement par défaut est fournie dans le module Politiques d'acheminement WebHook Jira . La politique d'acheminement par défaut prend en charge les champs suivants :{#jira-spoke-v3-0-2__table_routing_policy__entry__2}
| Catégorie | Champ |
|-|-|
| Problème | * URL de l'instance Jira * Événement de webhook * Description du problème * Créé * Mis à jour * Résolution du problème * Résolution du problème précédent * Résumé des problèmes * Type de problème * Type de problème précédent * Priorité du problème * Priorité du problème précédent * État du problème * État du problème précédent * Catégorie d'état du problème * Catégorie d'état du problème précédent * Projet {#jira-spoke-v3-0-2__ul_tny_fv1_1jb} |
| Commentaire | * Jira URL d'instance * Événement de webhook * Commentaire * Créé * Mis à jour * Résumé des problèmes * Type de problème * Priorité du problème * État du problème * Catégorie d'état du problème * Projet {#jira-spoke-v3-0-2__ul_bqk_mv1_1jb} |
| Journal de travail | * Jira URL d'instance * Événement de webhook * Temps passé dans le journal de travail * Créé * Mis à jour {#jira-spoke-v3-0-2__ul_off_rv1_1jb} |
| Pièce jointe | * Jira URL d'instance * Événement de webhook * Créé * Nom de fichier de la pièce jointe * Taille de la pièce jointe * Type MIME de pièce jointe {#jira-spoke-v3-0-2__ul_bkt_tv1_1jb} |
| Projet | * Jira URL d'instance * Événement de webhook * Projet {#jira-spoke-v3-0-2__ul_r3q_wv1_1jb} |
| Version | * Jira URL d'instance * Événement de webhook * Version * Version Description * Fusionné dans la version * Description de la version fusionnée {#jira-spoke-v3-0-2__ul_mqx_xv1_1jb} |
[ ]
{#jira-spoke-v3-0-2__table_routing_policy}
Pour utiliser d'autres conditions dans la politique d'acheminement, créez une politique d'acheminement dans le module Politiques d'acheminement Jira WebHook et spécifiez les conditions selon vos besoins. Consultez la rubrique [Configurer un webhook bidirectionnel pour le spoke Jira](https://servicenow-prod.fluidtopics.net/aKL~2VWf9T6_4s0ivpuLMA#setup-jira302-webhooks "Configurez un webhook auquel vous Jira abonner avec une ServiceNow URL de rappel.") pour en savoir plus sur l'installation et la configuration des webhooks.
## Flux secondaire du spoke {#jira-spoke-v3-0-2__section_gj2_3q4_z3b}
Fournit Jira un exemple de flux secondaire pour gérer divers Jira événements webhook. L'exemple de flux secondaire disponible est Webhooks de processus Jira . Le flux secondaire Traiter Jira les webhooks prend en charge les champs suivants :{#jira-spoke-v3-0-2__table_ydf_st1_1jb__entry__2}
| Catégorie | Champ |
|-|-|
| Problème | * Utilisateur * Problème * Pièces jointes * Journal des changements de problème * Projet {#jira-spoke-v3-0-2__ul_afn_vt1_1jb} |
| Commentaire | * Problème * Projet * Commentaire {#jira-spoke-v3-0-2__ul_vsh_xt1_1jb} |
| Journal de travail | Journal de travail |
| Pièces jointes | Pièce jointe |
| Projet | Projet |
| Version | Version |
| Événement de webhook ||
| Horodatage ||
| Charge utile Remarque : Il s'agit de l'ensemble Jira de la charge utile. ||
[ ]
{#jira-spoke-v3-0-2__table_ydf_st1_1jb}Pour personnaliser le flux secondaire par défaut, vous devez créer une copie de l'exemple de flux secondaire, analyser la charge utile et personnaliser le flux secondaire selon vos besoins. La charge utile est l'une des entrées du flux secondaire.
Lors de la personnalisation des flux secondaires, vous devez vous assurer qu'ils sont configurés pour éviter les boucles infinies.
Remarque :
* Vous devez configurer les webhooks pour utiliser le flux secondaire du spoke. Consultez la rubrique [Configurer un webhook bidirectionnel pour le spoke Jira](https://servicenow-prod.fluidtopics.net/aKL~2VWf9T6_4s0ivpuLMA#setup-jira302-webhooks "Configurez un webhook auquel vous Jira abonner avec une ServiceNow URL de rappel.") pour en savoir plus sur l'installation et la configuration du webhook.
* L'exemple de flux secondaire s'exécute en tant qu'utilisateur par défaut. Le flux secondaire peut être configuré pour s'exécuter en tant que système.
{#jira-spoke-v3-0-2__ul_js3_r4w_qjb}
## Déclencheurs de spoke {#jira-spoke-v3-0-2__section_cpg_rpm_ccc}
Utilisez des déclencheurs dans le Spoke Jira pour vous abonner aux événements requis. Le point de terminaison permet aux webhooks de se connecter à votre instance ServiceNow. Vous pouvez configurer les flux pour qu'ils s'exécutent uniquement lorsque les conditions de déclenchement spécifiées sont remplies. Les événements pris en charge sont les suivants :
{#jira-spoke-v3-0-2__table_usl_cqm_ccc__entry__3}
| Catégorie | Déclencheur | Description |
|-|-|-|
| Gestion de tableau | Tableau supprimé | Le déclencheur est initié lorsqu'un tableau est supprimé. |
| Gestion de tableau | Tableau mis à jour | Le déclencheur est initié lorsqu'un tableau est mis à jour. |
| Gestion de tableau | Tableau créé | Le déclencheur est initié lorsqu'un tableau est créé. |
| Gestion des commentaires | Commentaire supprimé | Le déclencheur est initié lorsqu'un commentaire est supprimé. |
| Gestion des commentaires | Commentaire mis à jour | Le déclencheur est initié lorsqu'un commentaire est mis à jour. |
| Gestion des commentaires | Commentaire créé | Le déclencheur est initié lorsqu'un commentaire est créé. |
| Gestion des problèmes | Problème mis à jour | Le déclencheur est initié lorsqu'un problème est mis à jour. Les événements tels que le problème affecté, le problème résolu, le problème fermé, le problème rouvert, le problème déplacé et d'autres événements liés à la mise à jour d'un problème relèvent de cet événement webhook. |
| Gestion des problèmes | Problème affecté | Le déclencheur est initié lorsqu'un problème est affecté. |
| Gestion des problèmes | Problème supprimé | Le déclencheur est initié lorsqu'un problème est supprimé. |
| Gestion des problèmes | Problème créé | Le déclencheur est initié lorsqu'un problème est créé. |
| Gestion du sprint | Sprint mis à jour | Le déclencheur est initié lorsqu'un sprint est mis à jour. |
| Gestion du sprint | Sprint supprimé | Le déclencheur est initié lorsqu'un sprint est supprimé. |
| Gestion du sprint | Sprint créé | Le déclencheur est initié lorsqu'un sprint est créé. |
| Gestion du sprint | Sprint fermé | Le déclencheur est initié lorsqu'un sprint est fermé. |
| Gestion du sprint | Sprint démarré | Le déclencheur est initié lorsqu'un sprint est démarré. |
[ ]
{#jira-spoke-v3-0-2__table_usl_cqm_ccc}
Pour en savoir plus sur la configuration des déclencheurs du spoke Jira, consultez [Configurer des déclencheurs pour le spoke Jira](https://servicenow-prod.fluidtopics.net/sB9_sfvsfaCD0UteiaAiPQ#jira-ext-trigger "Configurez des déclencheurs pour le spoke Jira pour les événements requis. Le point de terminaison permet aux webhooks de se connecter à votre instance ServiceNow."). Pour en savoir plus sur l'intégration entrante, reportez-vous à la section [Intégration entrante conditionnelle et pilotée par les événements](https://servicenow-prod.fluidtopics.net/91gVf4FimNZKzeRfTjFEHQ "Hub d'intégration Active l’intégration entrante conditionnelle et pilotée par les événements avec des applications tierces.").
## Actions du spoke {#jira-spoke-v3-0-2__section_r2m_j1d_mfb}
Utilisez des actions dans pour Spoke JiraStudio de workflow automatiser des Jira tâches lorsqu'un événement se produit dans le Now Platform. Les actions disponibles sont les suivantes :
Remarque :
* Certaines des actions de spoke à partir de cette version n'ont pas l'entrée Alias de connexion .
Les flux existants dans votre instance qui utilisent des actions des versions précédentes continuent de fonctionner. Cependant, ces actions antérieures sont renommées en ajoutant le suffixe obsolète et vous ne pouvez pas les utiliser à partir de cette version.
* Des options d'évaluation des erreurs sont fournies dans certaines actions de spoke.
{#jira-spoke-v3-0-2__ul_kgt_hwj_jvb}
{#jira-spoke-v3-0-2__table_pvx_v4s_qwb__entry__3}
| Catégorie | Action | Description |
|-|-|-|
| Audit Management | Rechercher un flux de journaux d'audit | Récupère l'activité de connexion pour les abonnements des utilisateurs AtlassianJira . |
| Gestion des groupes | Ajouter un utilisateur au groupe | Ajoute l'utilisateur donné à un groupe dans Jira. |
| Gestion des groupes | Créer un groupe | Crée un groupe dans Jira. |
| Gestion des groupes | Rechercher un flux de groupes | Récupère tous les groupes du compte Atlassian, y compris les groupes par défaut. Remarque : Cette action ne peut être utilisée qu'avec Jira un abonnement Cloud. |
| Gestion des groupes | Rechercher des utilisateurs par flux de noms de groupe | Récupère les détails de tous les membres d'un groupe Atlassian. |
| Gestion des groupes | Supprimer le groupe | Supprime le groupe donné à partir de Jira. |
| Gestion des groupes | Retirer l'utilisateur du groupe | Supprime l'utilisateur donné d'un groupe dans Jira. |
| Gestion des problèmes | Ajouter un commentaire | Ajoute un commentaire au problème spécifié dans Jira. |
| Gestion des problèmes | Ajouter un observateur | Ajoute l'utilisateur spécifié en tant qu'observateur pour le problème spécifié. |
| Gestion des problèmes | Affecter un problème | Affecte le problème à Jira l'utilisateur. |
| Gestion des problèmes | Copier la pièce jointe | Copie la pièce jointe requise associée à l'enregistrement ServiceNow dans le problème requis dans Jira. |
| Gestion des problèmes | Créer un problème | Crée un problème dans Jira. Selon l'utilisation de Jiravotre entreprise, un problème peut représenter un bogue logiciel, une tâche de projet, un ticket de service d'assistance, etc. Un problème dans Jira représente une tâche dans .Now Platform |
| Gestion des problèmes | Créer des problèmes | Crée jusqu'à 50 problèmes en bloc. Le type de problème créé par l'action dépend de la Jira configuration. |
| Gestion des problèmes | Supprimer la pièce jointe | Supprime la pièce jointe requise dans Jira. |
| Gestion des problèmes | Supprimer le problème | Supprime un problème dans Jira. |
| Gestion des problèmes | Supprimer un observateur | Supprime l'utilisateur en tant qu'observateur pour le problème spécifié. |
| Gestion des problèmes | Effectuer la transition | Fait passer un problème d'un Jira état à un autre. |
| Gestion des problèmes | Rechercher les états des types de problèmes par projet | Récupère les détails des états dans un projet. |
| Gestion des problèmes | Rechercher un problème | Récupère les détails d'un problème. |
| Gestion des problèmes | Rechercher les priorités des problèmes | Récupère la liste des priorités des problèmes et les détails de leurs priorités. |
| Gestion des problèmes | Rechercher le flux de problèmes | Récupère une liste des problèmes correspondant à une chaîne de requête JQL. |
| Gestion des problèmes | Rechercher le flux des problèmes de sprint | Récupère les détails de tous les problèmes pour le sprint donné. |
| Gestion des problèmes | Rechercher des transitions | Récupère des informations sur toutes les transitions pour un ID de problème donné. |
| Gestion des problèmes | Rechercher des observateurs | Récupère la liste des observateurs pour le problème spécifié. |
| Gestion des problèmes | Mettre à jour le problème | Met à jour un nombre défini de champs d'un problème dans Jira avec des valeurs transmises comme entrée. |
| Récupération des métadonnées | Obtenir des tableaux (métadonnées) | Récupère les détails de tous les tableaux dans Jira. |
| Récupération des métadonnées | Obtenir les champs créables (métadonnées) | Récupère la liste de tous les champs dans un projet requis Jira . |
| Récupération des métadonnées | Obtenir les champs modifiables (métadonnées) | Récupère la liste de tous les champs modifiables dans un problème requis Jira . |
| Récupération des métadonnées | Obtenir les types de problèmes (métadonnées) | Récupère la liste de tous les types de problèmes dans un projet requis Jira . |
| Récupération des métadonnées | Obtenir des projets (métadonnées) | Récupère la liste de tous les Jira projets. |
| Gestion des projets | Créer un projet | Crée un projet dans Jira. |
| Gestion des projets | Rechercher un projet | Récupère les détails du projet spécifié par son ID ou sa clé. |
| Gestion des projets | Rechercher des projets | Récupère les détails de tous les projets. Remarque : Cette action ne fonctionne que pour le Jira serveur. |
| Gestion des projets | Rechercher un flux de projets | Récupère les détails de tous les projets. Remarque : Cette action ne fonctionne que pour le Jira cloud. |
| Gestion des projets | Rechercher les utilisateurs pouvant être affectés à des projets | Récupère une liste des utilisateurs qui peuvent être affectés aux problèmes dans un ou plusieurs projets. |
| Gestion du sprint | Créer un sprint | Crée un sprint dans Jira. |
| Gestion du sprint | Supprimer le sprint | Supprime un sprint dans Jira. |
| Gestion du sprint | Rechercher un sprint | Récupère les détails du sprint requis en tant qu'objet complexe. |
| Gestion du sprint | Rechercher des sprints par tableau | Récupère les détails de tous les sprints dans le tableau requis. |
| Gestion du sprint | Mettre à jour le sprint | Met à jour les détails d'un sprint dans Jira. |
| Gestion des stories | Créer une story | Crée une story dans l'instance Jira Cloud. Ceci est comparable à la story dans le module d'extension Agile Development de ServiceNow. |
| Gestion des stories | Rechercher le flux des stories | Récupère les détails de toutes les stories. |
| Gestion des stories | Mettre à jour la story | Met à jour un nombre défini de champs d'une story dans Jira le cloud avec les valeurs d'entrée fournies. |
| Gestion des utilisateurs | Créer un utilisateur | Crée un utilisateur dans Jira. Remarque : Cette action n'est pas prise en charge lorsque l'authentification OAuth 2.0 est utilisée. |
| Gestion des utilisateurs | Rechercher un utilisateur authentifié | Récupère les détails du compte d'utilisateur authentifié. |
| Gestion des utilisateurs | Rechercher les appartenances à des groupes pour l'utilisateur | Récupère les détails de tous les groupes d'un utilisateur Atlassian. |
| Gestion des utilisateurs | Rechercher un flux d'utilisateurs | Récupère les détails de tous les abonnements des utilisateurs Atlassian Jira . Remarque : Cette action ne peut être utilisée qu'avec un Jira abonnement Cloud. |
| Gestion des utilisateurs | Rechercher un flux d'utilisateurs par nom | Récupère une liste d'utilisateurs qui correspondent à la chaîne de recherche. Remarque : Cette action ne peut être utilisée qu'avec un Jira abonnement au serveur. |
| Gestion des utilisateurs | Supprimer un utilisateur | Supprime un utilisateur à partir du Jirafichier . Remarque : Cette action n'est pas prise en charge lorsque l'authentification OAuth 2.0 est utilisée. |
| Actions d'utilitaire | Copier la pièce jointe du problème dans l'enregistrement | Copie la pièce jointe vers Jira n'importe quel enregistrement de ServiceNow l'instance. Lorsque vous utilisez cette action dans un flux secondaire, assurez-vous que la pastille de données URL de contenu est spécifiée dans le champ URL de la pièce jointe. |
| Actions d'utilitaire | Rechercher des champs | Récupère le nom interne et d'autres détails de l'étiquette de champ requise dans Jira. |
| Actions d'utilitaire | Rechercher un problème à partir d'un commentaire | Récupère les détails du problème en analysant la charge utile pour le commentaire spécifié. Vous pouvez utiliser cette action dans le flux secondaire du webhook de processus Jira pour le serveur local Jira lorsque seules les informations relatives aux commentaires sont spécifiées sans aucun détail sur le Jira problème. Par exemple, lorsque seules les informations de commentaire sont spécifiées, cette action analyse la charge utile et extrait les détails du problème. |
| Actions d'utilitaire | Rechercher la pièce jointe la plus récente du problème | Récupère la dernière pièce jointe pour le problème spécifié à partir de Jira. Vous pouvez utiliser cette action dans un flux ou un flux secondaire pour validation. Par exemple, un flux secondaire ajoute une pièce jointe supplémentaire uniquement lorsque la dernière pièce jointe d'un problème dans Jira n'est pas la même pièce jointe spécifiée. |
| Actions d'utilitaire | Rechercher le commentaire le plus récent sur le problème | Récupère le dernier commentaire de Jira pour le problème spécifié. Vous pouvez utiliser cette action dans un flux ou un flux secondaire pour validation. Par exemple, un flux secondaire ajoute un commentaire supplémentaire uniquement lorsque le dernier commentaire d'un problème dans Jira n'est pas le même commentaire spécifié. |
| Gestion des Webhook | Rechercher des webhooks | Récupère les détails de tous les webhooks enregistrés à partir de l'instance Jira . |
| Gestion des Webhook | S'abonner au webhook | Enregistre un webhook dans l'instance Jira . |
| Gestion des Webhook | Se désabonner du webhook | Supprime le webhook enregistré dans Jira l'instance. |
| Gestion des Webhook | Mettre à jour un webhook | Met à jour le webhook avec l'ID donné dans Jira. Remarque : Cette action n'est pas prise en charge lorsque l'authentification OAuth 2.0 est utilisée. |
[ ]
{#jira-spoke-v3-0-2__table_pvx_v4s_qwb}
## Jira Exigences de compte {#jira-spoke-v3-0-2__section_vkv_m1d_mfb}
Il est nécessaire de Jira générer un jeton d'API pour Jira utiliser votre compte Atlassian.
## Exigences en matière d'alias de connexion et d'informations d'identification {#jira-spoke-v3-0-2__section_hdq_dsj_vdb}
Hub d'intégration utilise des alias pour gérer les informations de connexion et d'identification, ainsi que les informations d'identification OAuth. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'environnements multiples. Si les informations de connexion ou d'identification changent, il n'est pas nécessaire de mettre à jour les actions qui utilisent la connexion.
Ce spoke utilise l'enregistrement alias Jira . Pour utiliser ces actions, vous devez créer un enregistrement de connexion et un enregistrement de credential et les associer à l'enregistrement d'alias.Jira
Ces actions utilisent des appels REST, qui peuvent s'exécuter sur une instance. Utilisez l'enregistrement de connexion associé à l'alias Jira pour configurer le point de terminaison sur lequel les actions sont exécutées.