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 à Centre 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.3.0 est 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)
Versions prises en charge
- 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.
- Registres de webhooks Jira
- Politiques d'acheminement du webhook Jira
| Catégorie | Champ |
|---|---|
| Problème |
|
| Commentaire |
|
| Journal de travail |
|
| Pièce jointe |
|
| Projet |
|
| Version |
|
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
| Catégorie | Champ |
|---|---|
| Problème |
|
| 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 . |
|
Lors de la personnalisation des flux secondaires, vous devez vous assurer que les flux secondaires sont configurés pour éviter les boucles infinies.
- 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 commencé | 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 ServiceNow AI Platform. Les actions disponibles sont les suivantes :
- 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 . Remarque : Cette action est prise en charge sur Server 9 et versions antérieures, ainsi Jira que sur Jira Cloud. |
| Rechercher un flux de journaux d'audit (Server versions 10 et ultérieures) | Récupère les enregistrements du journal d’audit de l’instance dans une Jira plage de dates spécifiée. Remarque : Cette action est prise en charge sur Jira Server 9 et les versions ultérieures. |
|
| 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 des utilisateurs par flux de 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 le 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 ServiceNow AI Platform. | |
| 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é. | |
| Effectuer la transition | Fait passer un problème d’un Jira état à un autre. | |
| Rechercher les statuts de types de problème par projet | Récupère les détails des états d’un projet. | |
| Rechercher un 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 relatifs à chaque priorité. | |
| Rechercher le flux de problèmes | Récupère une liste des problèmes correspondant à une chaîne de requête JQL. | |
| Rechercher un flux de problèmes de 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 les champs créables (métadonnées) | Récupère la liste de tous les champs dans un projet requis Jira . |
| Obtenir les champs créables (métadonnées) | Récupère la liste de tous les champs modifiables dans un problème requis Jira . | |
| Obtenir les types de problème (métadonnées) | Récupère la liste de tous les types de problèmes dans un projet requis Jira . | |
| 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 des 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 d'un commentaire | 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 dernière pièce jointe sur un 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 dernier commentaire sur un 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é. | |
| Rechercher un serveur | Récupère des informations générales sur l’instance JIRA actuelle. | |
| 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. |
Agents IA disponibles
Installez Now Assist pour Spokes et commencez à utiliser les agents IA disponibles. Pour plus d'informations, consultez Now Assist pour les spokes.
- Dans le ServiceNow système agentique, vous pouvez créer un workflow agentique qui comprend un ensemble d’instructions de grand modèle de langage (LLM) ainsi qu’un ou plusieurs agents IA autonomes pour exécuter un objectif. Consultez Create an agentic workflow pour plus d’informations sur l’ajout d’agents IA pour créer des workflows agentiques selon vos besoins et fournir le déclencheur requis.
Vous pouvez également rechercher d’autres agents IA disponibles et les ajouter à votre workflow agentique. Consultez Find AI agents pour plus d'informations.
- Vous pouvez créer un clone de l’agent IA de spoke requis et le personnaliser selon vos besoins. Consultez Duplicate an AI agent pour plus d’informations sur la création d’un clone.
- Consultez la rubrique Now Assist AI agents pour plus d’informations sur les agents IA.
Les agents IA disponibles sont les suivants :
| Agent IA | Description |
|---|---|
| Agent IA de gestion des stories Jira | Récupère des informations sur les stories dans un flux, crée de nouvelles stories et met à jour les stories existantes. |
| Agent IA de gestion des utilitaires Jira | Fournit des actions utilitaires qui peuvent copier la pièce jointe du problème dans l’enregistrement, récupérer la dernière pièce jointe et les derniers commentaires sur un problème JIRA et récupérer les détails du champ à l’aide d’étiquettes. Garantit une récupération précise des données. |
| Agent IA de gestion des utilisateurs Jira | Crée et supprime l’utilisateur requis. Récupère des informations sur les utilisateurs, les appartenances à des groupes et les comptes d’utilisateurs authentifiés. |
| Agent IA de gestion de l'audit Jira | Gère les journaux d’audit et fournit des informations exploitables en automatisant les tâches répétitives. |
| Agent IA de gestion des sprints | Supprime des sprints, met à jour les détails du sprint et récupère des informations de sprint spécifiques. |
| Agent IA de gestion de projet Jira | Récupère les détails du projet, crée de nouveaux projets, récupère les flux de projet et identifie les utilisateurs pouvant être affectés aux projets. |
| Agent IA de gestion des groupes Jira | Gère les groupes en effectuant des actions telles que la création et la suppression de groupes, l’ajout et la suppression d’utilisateurs, la récupération des détails sur les groupes, la récupération des données et des mises à jour, et la récupération des membres des groupes. |
| Agent IA de gestion des problèmes Jira | Gère les problèmes en effectuant des actions telles que la suppression des problèmes, la gestion des transitions, la gestion des observateurs et l’utilisation des pièces jointes. Gère également les transitions, les commentaires, les pièces jointes et les observateurs. |
- Il peut y avoir des agents IA installés avec l’application qui ne sont pas utilisés dans les Now Assist workflows agentiques. Pour savoir comment afficher tous les agents disponibles sur votre instance, consultez Rechercher des agents IA.
- Pour rechercher des agents qui ne sont peut-être pas installés sur votre instance, visitez AI Agent Marketplace sur le ServiceNow Store.
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
Centre 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.