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 Jira Software connecter à Workfront Fusion, vous devez créer un jeton API et l’insérer avec votre URL de service et votre nom d’utilisateur dans le champ Create a connection de 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é.
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 de Jira Cloud de Workfront Fusion, cliquez sur Add en regard du champ connection .
-
Indiquez les informations suivantes :
- Environnement
- Type
- Service URL: Il s’agit de l’URL de base que vous utilisez pour accéder à votre compte Jira. Exemple :
yourorganization.atlassian.net
- Username
- API token: il s’agit du jeton API que vous avez créé dans la section Créer un jeton API dans Jira de cet article.
-
Cliquez sur Continue 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 obtenir une clé privée pour votre connexion Workfront Fusion Jira, vous devez générer des clés publiques et privées.
-
Dans votre terminal, exécutez les commandes
openssl
suivantes.-
openssl genrsa -out jira_privatekey.pem 1024
Cette 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 365
Cette commande crée un certificat X509.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
Cette commande extrait la clé privée (format PKCS8) dans le fichier
jira_privatekey.pcks8
. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
Cette commande permet d’extraire la clé publique du certificat dans le fichier
jira_publickey.pem
.NOTE
Si vous utilisez Windows, vous devrez peut-être enregistrer manuellement la clé publique dans le fichierjira_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 Jira Settings
-
Dans le champ Enter the URL of the application you want to link , saisissez
https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
-
Cliquez sur Create new link. Ignorez le message d’erreur « Aucune réponse n’a été reçue de l’URL que vous avez saisie ».
-
Dans la fenêtre Link applications , saisissez les valeurs dans les champs Consumer key et Shared secret .
Vous pouvez choisir les valeurs de ces champs.
-
Copiez les valeurs des champs Consumer key et Shared secret vers un emplacement sécurisé.
Vous aurez besoin de ces valeurs plus tard dans le processus de configuration.
-
Remplissez les champs de l’URL comme suit :
champ Description Request Token URL <Jira base url>/plugins/servlet/oauth/request-token
Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
-
Cochez la case Create incoming link .
-
Cliquez sur Continue.
-
Dans la fenêtre Link applications, renseignez les champs suivants :
-
Cliquez sur Continue.
-
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 de Jira Server de Workfront Fusion, cliquez sur Add en regard du champ connection .
-
Dans le panneau Create a connection, renseignez les champs suivants :
-
Cliquez sur Continue pour créer la connexion et revenir 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
Watch for records
Ce module déclencheur lance un scénario lorsqu’un enregistrement est ajouté, mis à jour ou supprimé.
Actions
Add issue to sprint
Ce module d’action ajoute un ou plusieurs problèmes à un sprint.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Create a Record
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.
Custom API Call
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.
Delete a record
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.
Download an attachment
Ce module d’action télécharge une pièce jointe particulière.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Read a record
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.
Update a record
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
List records
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.
Search for records
Ce module de recherche recherche les enregistrements dans un objet dans Jira Software qui correspondent à la requête 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.