DocumentationWorkfrontGuide Workfront

Modules Jira Software

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Jira Software et le connecter à plusieurs applications et services tiers.

Si vous avez besoin d’instructions sur la création d’un scénario, consultez Créer un scénario dans Adobe Workfront Fusion.

Pour plus d’informations sur les modules, voir Modules dans Adobe Workfront Fusion.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Exigences actuelles du produit : si vous avez le plan Select ou Prime Adobe Workfront, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez vote administrateur ou administratrice Workfront.

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 :

Jira Cloud
Serveur Jira
apiVersion
2
2
apiVersionAgile
1,0
1,0
Balise API
1,7,29
1.0.19

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

  1. Accédez à https://id.atlassian.com/manage/api-tokens et connectez-vous.

  2. Cliquez sur Créer un jeton d’API.

  3. Saisissez un nom pour le jeton, par exemple Workfront Fusion.

  4. Copiez le jeton à l’aide du bouton Copier dans le presse-papiers.

    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.

  5. Continuez avec Configurer le jeton d’API Jira dans Workfront Fusion.

Configurer le jeton d’API Jira dans Workfront Fusion

  1. Dans Workfront Fusion, ajoutez un module Jira à un scénario pour ouvrir la boîte de dialogue Créer une connexion.

  2. Indiquez les informations suivantes :

    • 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.

  3. 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 ou administratrice Jira pour obtenir ces informations.

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.

  1. 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 note
      NOTE
      Si vous utilisez Windows, vous devrez peut-être enregistrer manuellement la clé publique dans le fichier jira_publickey.pem :

      1. Dans votre terminal, exécutez la commande suivante :

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. Copiez la sortie du terminal (y compris -------BEGIN PUBLIC KEY-------- et -------END PUBLIC KEY--------).

      3. Collez la sortie du terminal dans un fichier nommé jira_publickey.pem.

  2. Continuez à configurer l’application cliente en tant que consommatrice dans Jira.

Configurez l’application cliente en tant que consommatrice dans Jira.

  1. Connectez-vous à votre instance Jira.

  2. Dans le panneau de navigation de gauche, cliquez sur Paramètres Jira  > Applications  > Liens d’application.

  3. 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

  4. 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 ».

  5. 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.

  6. 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.

  7. 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-token
    URL d’autorisation <Jira base url>/plugins/servlet/oauth/authorize
    URL du jeton d’accès <Jira base url>/plugins/servlet/oauth/access-token

  8. Cochez la case Créer un lien entrant.

  9. Cliquez sur Continuer.

  10. 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.

  11. Cliquez sur Continuer.

  12. 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

NOTE
Utilisez l’application Jira Server pour vous connecter à Jira Server ou Jira Data Center.

  1. Dans n’importe quel module Jira Server de Workfront Fusion, cliquez sur Ajouter à côté du champ connexion.

  2. Dans le panneau Créer une connexion, remplissez les champs suivants :

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Connection name Saisir le nom de la connexion
    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.pcks8 que 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

  3. 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 Mapper des informations d’un module à l’autre dans Adobe Workfront Fusion.

Déclencheurs

Surveiller des enregistrements

Ce module déclencheur lance un scénario lorsqu’un enregistrement est ajouté, mis à jour ou supprimé.

Webhook

Sélectionnez le webhook que vous souhaitez utiliser pour surveiller les enregistrements.

Pour ajouter un nouveau webhook :

  1. Cliquez sur Add.

  2. Saisissez un nom pour le webhook.

  3. Sélectionnez la connexion que vous souhaitez utiliser pour votre webhook.

    Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, consultez l’article Connecter Jira Software à Workfront Fusion.

  4. Sélectionnez le type d’enregistrement que vous souhaitez que le logiciel surveille :

    • Comment
    • Issue
    • Project
    • Sprint

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.

Connection
Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, consultez l’article Connecter Jira Software à Workfront Fusion.
Sprint ID
Saisissez ou mappez l’ID du sprint auquel vous souhaitez ajouter un problème.
Issue ID or Keys
Ajoutez un ID ou une clé de problème pour chaque problème que vous souhaitez ajouter au sprint.

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.

Connection
Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement que vous souhaitez que le module crée. Lorsque vous sélectionnez un type d’enregistrement, d’autres champs spécifiques à ce type d’enregistrement apparaissent dans le module.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
  • Worklog

Appel API personnalisé

Ce module d’action vous permet d’effectuer un appel personnalisé et authentifié à l’API Jira Software. Cela vous permet de créer une automatisation du flux de données qui ne peut pas être réalisé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 dans Adobe Workfront Fusion.

Connection
Pour obtenir des instructions sur la connexion de votre compte Jira Software à Workfront Fusion, consultez la section Connecter Jira Software à Workfront Fusion de cet article.
URL
Saisir un chemin relatif à<Instance URL>/rest/api/2/
Method
Headers

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.

Query String

Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.

Par exemple : {"name":"something-urgent"}

Body

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 un enregistrement particulier.

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.

Connection
Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement que vous souhaitez que le module supprime.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
Saisissez ou mappez l’ID ou la clé de l’enregistrement que vous souhaitez supprimer.

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.

Connection
Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
ID
Saisissez ou mappez l’ID de la pièce jointe que vous souhaitez télécharger.

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.

Connection
Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement Jira que vous souhaitez que le module lise.

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
Sélectionnez les sorties que vous souhaitez recevoir. Les options de sortie sont disponibles en fonction du type d’enregistrement sélectionné dans le champ Record Type.
ID
Saisissez ou mappez l’identifiant unique Jira Software de l’enregistrement que vous souhaitez que le module lise.

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.

Connection
Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement que vous souhaitez que le module mette à jour. Lorsque vous sélectionnez un type d’enregistrement, d’autres champs spécifiques à ce type d’enregistrement apparaissent dans le module.

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
Saisissez ou mettez en correspondance l’ID ou la clé de l’enregistrement que vous souhaitez mettre à jour.

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.

Connection
Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement que vous souhaitez voir figurer dans le module. Lorsque vous sélectionnez un type d’enregistrement, d’autres champs spécifiques à ce type d’enregistrement apparaissent dans le module.

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
Saisissez ou mappez le nombre maximum d’enregistrements que vous souhaitez que le module récupère au cours de chaque cycle d’exécution du scénario.

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.

Connection
Pour savoir comment connecter votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement que vous souhaitez que le module recherche. Lorsque vous sélectionnez un type d’enregistrement, d’autres champs spécifiques à ce type d’enregistrement apparaissent dans le module.

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

    Pour plus d’informations sur JQL, consultez l’article JQL sur le site d’aide d’Atlassian.

  • Project

  • Project by issue

  • User

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43