Jira Rayon

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

Visitez le site Web ServiceNow Store 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.

Abonnement à Hub d'intégration

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.

Version de spoke

Jira Spoke V5.1.0 correspond à la dernière version.

Dépendances des spokes

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)
• ServiceNow Flow Designer : entrées dynamiques (com.glide.hub.dynamic_inputs)
• Intégrations : infrastructure d’authentification externe (com.glide.external.app)

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

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 de l’API dans Version de l’API dans la liste connexe Attributs. Par défaut, la version de l’API est 2. Pour plus d’informations sur la création d’un enregistrement de connexion, reportez-vous à la section Configurer une connexion pour le spoke Jira .
• Jira Centre de services n’est pas pris en charge par le spoke.

Jira Module Webhooks

Des webhooks bidirectionnels peuvent être configurés pour être averti 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 dont Jira 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 séparée 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 de webhook Jira
• Politiques d’acheminement du webhook Jira

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 Jira WebHook. La politique d’acheminement par défaut prend en charge ces champs :

Catégorie	Champ
Problème	URL d’instance Jira Événement webhook Description du problème Créées 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 de l’état du problème précédent Projet
Commentaire	Jira URL d’instance Événement webhook Commentaire Créées 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
Journal de travail	Jira URL d’instance Événement webhook Temps passé dans le journal de travail Créées Mis à jour
Pièce jointe	Jira URL d’instance Événement webhook Créées Nom de fichier de la pièce jointe Taille de la pièce jointe Type MIME de la pièce jointe
Projet	Jira URL d’instance Événement webhook Projet
Version	Jira URL d’instance Événement webhook Version Version Description Fusionné dans la version Description de la version fusionnée

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. Pour Configurer un webhook bidirectionnel pour le spoke Jira en savoir plus sur l’installation et la configuration des webhooks, reportez-vous à la section .

Flux secondaire du spoke

Fournit Jira un exemple de flux secondaire pour gérer divers Jira événements de webhook. L’exemple de flux secondaire disponible est Webhooks de processus Jira . Le flux secondaire des webhooks de processus Jira prend en charge ces champs :

Catégorie	Champ
Problème	Utilisateur Problème Pièces jointes Journal des changements de problème Projet
Commentaire	Problème Projet Commentaire
Journal de travail	Journal de travail
Pièces jointes	Pièce jointe
Projet	Projet
Version	Version
Événement webhook
Horodatage
Charge utile Remarque : Il s’agit de la charge utile complète Jira .

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 que les flux secondaires sont configurés pour éviter les boucles infinies.

Remarque :

• Vous devez configurer les webhooks pour utiliser le flux secondaire de spoke. Pour en savoir plus sur l’installation et la configuration du webhook, reportez-vous Configurer un webhook bidirectionnel pour le spoke Jira à la rubrique .
• 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.

Déclencheurs de spokes

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 :

Catégorie	Déclencheur	Description
Gestion de tableau	Tableau supprimé	Le déclencheur est lancé lorsqu’un tableau est supprimé.
	Tableau mis à jour	Le déclencheur est lancé lorsqu’un tableau est mis à jour.
	Tableau créé	Le déclencheur est lancé lorsqu’un tableau est créé.
Gestion des commentaires	Commentaire supprimé	Le déclencheur est lancé lorsqu’un commentaire est supprimé.
	Commentaire mis à jour	Le déclencheur est lancé lorsqu’un commentaire est mis à jour.
	Commentaire créé	Le déclencheur est lancé lorsqu’un commentaire est créé.
Gestion des problèmes	Problème mis à jour	Le déclencheur est lancé 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.
	Problème affecté	Le déclencheur est lancé lorsqu’un problème est affecté.
	Problème supprimé	Le déclencheur est lancé lorsqu’un problème est supprimé.
	Problème créé	Le déclencheur est lancé lorsqu’un problème est créé.
Gestion des sprints	Sprint mis à jour	Le déclencheur est lancé lorsqu’un sprint est mis à jour.
	Sprint supprimé	Le déclencheur est lancé lorsqu’un sprint est supprimé.
	Sprint créé	Le déclencheur est lancé lorsqu’un sprint est créé.
	Sprint fermé	Le déclencheur est lancé lorsqu’un sprint est fermé.
	Sprint démarré	Le déclencheur est lancé lorsqu’un sprint est démarré.

Pour en savoir plus sur la configuration des déclencheurs pour le spoke Jira, consultez Configurer des déclencheurs pour le spoke Jira. Pour plus d’informations sur l’intégration entrante, reportez-vous à la section Intégration entrante conditionnelle et pilotée par les événements.

Actions du spoke

Utilisez des actions dans le pour Studio de workflow automatiser Jira les Spoke 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.

Catégorie	Action	Description
Gestion de l'audit	Rechercher un flux de journaux d'audit	Récupère l’activité de connexion pour les abonnements utilisateur AtlassianJira .
Gestion des groupes	Ajouter un utilisateur au groupe	Ajoute un utilisateur donné à un groupe dans Jira.
	Créer un groupe	Crée un groupe dans Jira.
	Rechercher un flux de groupes	Récupère tous les groupes du compte Atlassian, y compris les groupes par défaut. Remarque : Cette action peut être utilisée uniquement avec Jira un abonnement Cloud.
	Rechercher un flux d’utilisateurs par nom de groupe	Récupère les détails de tous les membres d’un groupe Atlassian.
	Supprimer un groupe	Supprime le groupe donné de Jira.
	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.
	Ajouter un observateur	Ajoute l’utilisateur spécifié en tant qu’observateur pour le problème spécifié.
	Affecter un problème	Affecte le problème à Jira l’utilisateur.
	Copier la pièce jointe	Copie la pièce jointe requise associée à l’enregistrement ServiceNow sur le problème requis dans Jira.
	Créer un problème	Crée un problème dans Jira. Selon la façon dont votre organisation l’utilise Jira, un problème peut représenter un bogue logiciel, une tâche de projet, un ticket de support technique, etc. Un problème dans Jira représente une tâche dans le Now Platform.
	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.
	Supprimer la pièce jointe	Supprime la pièce jointe requise dans Jira.
	Supprimer le problème	Supprime un problème dans Jira.
	Supprimer un observateur	Supprime l’utilisateur en tant qu’observateur pour le problème spécifié.
	Faire la transition	Fait passer un problème d’un Jira état à un autre.
	Rechercher les états des types de problèmes par projet	Récupère les détails des états d’un projet.
	Rechercher le problème	Récupère les détails d’un problème.
	Rechercher les priorités des problèmes	Récupère la liste des priorités de problèmes et les détails pour les priorités de problèmes individuels.
	Rechercher le flux de problèmes	Récupère une liste des problèmes correspondant à une chaîne de requête JQL.
	Rechercher le flux de problèmes du sprint	Récupère les détails de tous les problèmes pour le sprint donné.
	Rechercher des transitions	Récupère des informations sur toutes les transitions pour un ID de problème donné.
	Rechercher des observateurs	Récupère la liste des observateurs pour le problème spécifié.
	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.
	Obtenir les champs créables (métadonnées)	Récupère la liste de tous les champs dans un projet requis Jira .
	Obtenir les champs modifiables (métadonnées)	Récupère la liste de tous les champs modifiables dans un problème requis Jira .
	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 .
	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.
	Rechercher un projet	Récupère les détails du projet spécifié par son ID ou sa clé.
	Rechercher des projets	Récupère les détails de tous les projets. Remarque : Cette action ne fonctionne que pour le Jira serveur.
	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.
	Rechercher les utilisateurs pouvant être affectés à des projets	Récupère une liste d’utilisateurs qui peuvent être affectés à des problèmes dans un ou plusieurs projets.
Gestion des sprints	Créer un sprint	Crée un sprint dans Jira.
	Supprimer le sprint	Supprime un sprint dans Jira.
	Rechercher un sprint	Récupère les détails du sprint requis sous la forme d’un objet complexe.
	Rechercher des sprints par tableau	Récupère les détails de tous les sprints dans le tableau requis.
	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 ServiceNow Agile Development.
	Rechercher le flux des stories	Récupère les détails de toutes les 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.
	Rechercher un utilisateur authentifié	Récupère les détails du compte d’utilisateur authentifié.
	Rechercher les appartenances à des groupes pour l’utilisateur	Récupère les détails de tous les groupes d’un utilisateur Atlassian.
	Rechercher un flux d'utilisateurs	Récupère les détails de tous les abonnements utilisateur Atlassian Jira . Remarque : Cette action peut être utilisée avec un Jira abonnement cloud uniquement.
	Rechercher un flux d’utilisateurs par nom	Récupère une liste d’utilisateurs qui correspondent à la chaîne de recherche. Remarque : Cette action peut être utilisée avec un Jira abonnement au serveur uniquement.
	Supprimer un utilisateur	Supprime un utilisateur de Jira. 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 Jira depuis n’importe quel enregistrement de l’instance ServiceNow . 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.
	Rechercher des champs	Récupère le nom interne et d’autres détails de l’étiquette de champ requise dans Jira.
	Rechercher un problème à partir des commentaires	Récupère les détails du problème en analysant la charge utile du commentaire spécifié. Vous pouvez utiliser cette action dans le flux secondaire de webhook de processus Jira pour le serveur JIRA sur site lorsque seules les informations relatives au commentaire 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.
	Rechercher la pièce jointe la plus récente sur le 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 que la pièce jointe spécifiée.
	Rechercher le commentaire le plus récent sur le problème	Récupère le dernier commentaire 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 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 .
	S'abonner au webhook	Enregistre un webhook dans l’instance Jira .
	Se désabonner du webhook	Supprime le webhook enregistré dans l’instance Jira .
	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 Exigences de compte

Cela Jira nécessite de 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

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 d’alias Jira . Pour utiliser ces actions, vous devez créer un enregistrement de connexion et un enregistrement de dédentation et les associer à l’enregistrement d’aliasJira.

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 s’exécutent.