Modules Jira Software
Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Jira Software et le connecter à plusieurs applications et services tiers.
Ces instructions s’appliquent aux modules Jira Cloud et Jira Server.
Pour obtenir des instructions sur la création d’un scénario, consultez les articles sous Créer des scénarios : index d’article.
Pour plus d’informations sur les modules, consultez les articles sous Modules : index des articles.
Conditions d’accès
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront | Tous |
| Licence Adobe Workfront |
Nouveau : Standard Ou En cours : Travail ou version ultérieure |
| Licence Adobe Workfront Fusion ** |
Actuel : aucune exigence de licence Workfront Fusion. Ou Hérité : Workfront Fusion pour l’automatisation et l’intégration du travail |
| Produit |
Nouveau :
Ou Actuel : votre entreprise doit acheter Adobe Workfront Fusion. |
Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.
Conditions préalables
Pour utiliser les modules Jira, vous devez disposer d’un compte Jira.
Informations sur l’API Jira
Le connecteur Jira utilise les éléments suivants :
Connecter Jira Software à Workfront Fusion
La méthode de connexion dépend de si vous utilisez Jira Cloud ou Jira Server.
Connecter Jira Cloud à Workfront Fusion
Connecter Jira Cloud à Workfront Fusion
Pour connecter Jira Software à Workfront Fusion, vous devez créer un jeton d’API et l’insérer avec votre URL de service et votre nom d’utilisateur ou d’utilisatrice dans le champ Créer une connexion dans Workfront Fusion.
Créer un jeton d’API dans Jira
-
Créez un jeton API dans Jira.
Pour obtenir des instructions, nous vous recommandons de rechercher « Créer un jeton API » dans la documentation Jira.
-
Après avoir créé le jeton, copiez-le vers un emplacement sécurisé.
note important IMPORTANT Vous ne pouvez plus visualiser le jeton après avoir fermé cette boîte de dialogue. 1. Conservez le jeton généré en lieu sûr.
-
Continuez avec Configurer le jeton d’API Jira dans Workfront Fusion.
Configurer le jeton d’API Jira dans Workfront Fusion
-
Dans n’importe quel module Jira Cloud de Workfront Fusion, cliquez sur Ajouter à côté du champ connexion.
-
Indiquez les informations suivantes :
- Environnement
- Type
- URL du service : il s’agit de l’URL de base que vous utilisez pour accéder à votre compte Jira. Exemple :
yourorganization.atlassian.net - Le nom d’utilisateur ou d’utilisatrice
- Le jeton d’API : il s’agit du jeton d’API que vous avez créé dans la section Créer un jeton d’API dans Jira de cet article.
-
Cliquez sur Continuer pour créer la connexion et revenir au module.
Connecter Jira Server à Workfront Fusion
Pour autoriser une connexion entre Workfront Fusion et Jira Server, vous avez besoin de votre clé de consommateur ou consommatrice, de votre clé privée et de l’URL du service. Vous devrez peut-être contacter votre administrateur Jira pour cette information.
Générer des clés publiques et privées pour votre connexion Jira
Pour acquérir une clé privée pour votre connexion Workfront Fusion Jira, vous devez générer des clés publiques et privées. Cette opération s’effectue via le terminal de votre ordinateur. Vous pouvez localiser votre terminal en recherchant terminal dans le menu de démarrage ou la barre de recherche de votre ordinateur (et non dans la barre de recherche de votre navigateur).
-
Dans votre terminal, exécutez les commandes
opensslsuivantes.-
openssl genrsa -out jira_privatekey.pem 1024Cette commande génère une clé privée de 1 024 bits.
-
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365Cette commande crée un certificat X509.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8Cette commande extrait la clé privée (format PKCS8) dans le fichier
jira_privatekey.pcks8. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pemCette commande permet d’extraire la clé publique du certificat dans le fichier
jira_publickey.pem.note note NOTE Si vous utilisez Windows, vous devrez peut-être enregistrer manuellement la clé publique dans le fichier jira_publickey.pem:-
Dans votre terminal, exécutez la commande suivante :
openssl x509 -pubkey -noout -in jira_publickey.cer -
Copiez la sortie du terminal, y compris
-------BEGIN PUBLIC KEY--------et-------END PUBLIC KEY--------. -
Collez la sortie du terminal dans un fichier nommé
jira_publickey.pem.
-
-
-
Continuez à configurer l’application cliente en tant que consommatrice dans Jira.
Configurez l’application cliente en tant que consommatrice dans Jira.
-
Connectez-vous à votre instance Jira.
-
Dans le panneau de navigation de gauche, cliquez sur Jirales paramètres
-
Dans le champ Entrer l’URL de l’application que vous voulez lier, entrez :
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1 -
Cliquez sur Créer un lien. Ignorez le message d’erreur « Aucune réponse n’a été reçue de l’URL que vous avez saisie ».
-
Dans la fenêtre Lier les applications, entrez des valeurs dans les champs Clé de consommateur ou consommatrice et Secret partagé.
Vous pouvez choisir les valeurs de ces champs.
-
Copiez les valeurs des champs Clé de consommateur ou consommatrice et Secret partagé dans un endroit sûr.
Vous aurez besoin de ces valeurs plus tard dans le processus de configuration.
-
Remplissez les champs de l’URL comme suit :
table 0-row-2 1-row-2 2-row-2 3-row-2 champ Description URL du jeton de demande <Jira base url>/plugins/servlet/oauth/request-tokenURL d’autorisation <Jira base url>/plugins/servlet/oauth/authorizeURL du jeton d’accès <Jira base url>/plugins/servlet/oauth/access-token -
Cochez la case Créer un lien entrant.
-
Cliquez sur Continuer.
-
Dans la fenêtre Lier les applications, remplissez les champs suivants :
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Consumer Key Collez la clé de consommateur que vous avez copiée dans un endroit sûr. Consumer name Saisissez le nom de votre choix. Ce nom est destiné à vous servir de référence. Public key Collez la clé publique de votre fichier jira_publickey.pem. -
Cliquez sur Continuer.
-
Continuez vers Créer une connexion à Jira Server ou Jira Data Center dans Workfront Fusion.
Créer une connexion à Jira Server ou Jira Data Center dans Workfront Fusion
-
Dans n’importe quel module Jira Server de Workfront Fusion, cliquez sur Ajouter à côté du champ connexion.
-
Dans le panneau Créer une connexion, remplissez les champs suivants :
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header Connection name Saisir le nom de la connexion Environment Choisissez si vous utilisez un environnement de production ou hors production. Type Choisissez si vous utilisez un compte de service ou un compte personnel. Consumer Key Collez la clé de consommateur que vous avez copiée dans un endroit sûr dans Configurer l’application client en tant que consommatrice dans Jira. Private Key Collez la clé privée du fichier jira_privatekey.pcks8que vous avez créé dans Générer des clés publiques et privées pour votre connexion Jira.Service URL Saisissez l’URL de votre instance Jira. Exemple : yourorganization.atlassian.net -
Cliquez sur Continuer pour créer la connexion et retourner au module.
Modules Jira Software et leurs champs
Lorsque vous configurez les modules Jira Software, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Jira Software supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.
Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mappage des informations d’un module à un autre.
Déclencheurs
Surveiller des enregistrements
Ce module déclencheur lance un scénario lorsqu’un enregistrement est ajouté, mis à jour ou supprimé.
Actions
Ajouter un problème au sprint
Ce module d’action ajoute un ou plusieurs problèmes à un sprint.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Créer un enregistrement
Ce module d’action crée un nouvel enregistrement dans Jira.
Le module renvoie tous les champs standard associés à l’enregistrement, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Appel API personnalisé
Ce module d’action vous permet d’effectuer un appel personnalisé et authentifié à l’API Jira Software. Utilisez ce module pour créer une automatisation du flux de données qui ne peut pas être effectuée par les autres modules Jira Software.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP.
<Instance URL>/rest/api/2/Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.
Par exemple, {"Content-type":"application/json"}
Workfront Fusion ajoute les en-têtes d’autorisation pour vous.
Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.
Par exemple : {"name":"something-urgent"}
Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.
Note :
Lors de l’utilisation d’instructions conditionnelles telles que if dans votre fichier JSON, placez les guillemets en dehors de l’instruction conditionnelle.
Supprimer un enregistrement
Ce module d'action supprime l'enregistrement spécifié.
Vous indiquez l’ID de l’enregistrement.
Le module renvoie l’ID de l’enregistrement et tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Télécharger une pièce jointe
Ce module d’action télécharge une pièce jointe particulière.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Lire un enregistrement
Ce module d’action lit les données d’un seul enregistrement dans Jira Software.
Vous indiquez l’ID de l’enregistrement.
Le module renvoie tous les champs standard associés à l’enregistrement, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Lire un enregistrement
Ce module d’action met à jour un enregistrement existant, tel qu’une question ou un projet.
Vous indiquez l’ID de l’enregistrement.
Le module renvoie l’ID de l’enregistrement et tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Recherches
Liste des enregistrements
Ce module de recherche permet de retrouver tous les éléments d’un type spécifique qui correspondent à votre requête de recherche.
Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Rechercher des enregistrements
Ce module de recherche recherche les enregistrements d’un objet dans Jira Software qui correspondent à la requête de recherche que vous avez spécifiée.
Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.