Jira Parlé

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 V4.3.2 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 du Centre d’intégration ServiceNow : obtenir des 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 : cadre de travail 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 d’API sous la liste connexe Attributs. Par défaut, la version de l’API est 2. Consultez Configurer une connexion pour le spoke Jira pour plus d’informations sur la création d’un enregistrement de connexion.
Jira Service Desk n’est pas pris en charge par le spoke.

Jira Module Webhooks

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 informé. Lorsque les conditions sont remplies, la politique d’acheminement déclenche le flux secondaire associé, qui automatise à son tour 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 et Jira comporte les modules suivants :

Registres Webhook Jira
Politiques d’acheminement de WebHook Jira

Utilisez le Jira module Registres Webhook pour affecter un jeton et fournir le chemin d’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 les champs suivants :


Catégorie	Champ
Problème	URL d’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
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
Journal de travail	Jira URL d’instance Événement de webhook Journal de travail Temps consacré Créé Mis à jour
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
Projet	Jira URL d’instance Événement de webhook Projet
Version	Jira URL d’instance Événement de 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. Consultez Configurer un webhook bidirectionnel pour plus d’informations sur la configuration des webhooks.

Flux secondaire du spoke

La Jira fournit 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 Webhooks de processus Jira prend en charge ces champs :


Catégorie	Champ
Problème	Utilisateur Problème Pièces jointes Journal des changements du 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 de webhook
Horodatage
Charge utile Remarque : Il s’agit de l’ensemble Jira de la charge utile.

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 du spoke. Consultez Configurer un webhook bidirectionnel pour plus d’informations sur 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.

Actions du spoke

Utilisez des actions dans le pour automatiser les Spoke JiraJira tâches lorsqu’un événement se produit dans le Now Platform.Concepteur de flux 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. Toutefois, ces actions antérieures sont renommées en ajoutant le suffixe déconseillé 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	Champ	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.
	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 ne peut être utilisée qu’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 le 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 dans 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 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é.
	Effectuer 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 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 des problèmes et les détails de leurs priorités individuelles.
	Rechercher le flux de problèmes	Récupère une liste de problèmes correspondant à une chaîne de requête JQL.
	Rechercher le flux des 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 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 aux problèmes d’un ou de 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 en tant qu’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 des utilisateurs Atlassian Jira . Remarque : Cette action ne peut être utilisée qu’avec un Jira abonnement Cloud.
	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.
	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 de Jira vers 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 requis dans Jira.
	Rechercher le problème à partir du 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 de processus Jira Webhook pour le serveur sur site 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 des 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 à des fins de 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 n’est Jira pas la même 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 à des fins de validation. Par exemple, un flux secondaire ajoute un commentaire supplémentaire uniquement lorsque le dernier commentaire d’un problème dans Jira est différent du 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	Inscrit un webhook dans l’instance Jira .
	Se désabonner du webhook	Supprime le webhook enregistré dans Jira l’instance.
	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

Vous devez 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

Hub d'intégration utilise des alias pour gérer les informations de connexion et d’informations 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 dential etles 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.