DocumentationWorkfrontGuide Workfront

Jira Software modules

Last update: Tue Jun 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

Dans un Adobe Workfront Fusion , vous pouvez automatiser les workflows qui utilisent Jira Software, ainsi que de la connecter à plusieurs applications et services tiers.

Si vous avez besoin d’instructions sur la création d’un scénario, reportez-vous à la section Création d’un scénario dans Adobe Workfront Fusion.

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

Exigences d’accès

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

Adobe Workfront plan*
Pro ou version ultérieure
Adobe Workfront license*
Plan, Work
Adobe Workfront Fusion license**

Exigences de licence actuelles : Non Workfront Fusion conditions requises pour obtenir une licence.

Ou

Exigences de licence héritées : Workfront Fusion pour l’automatisation et l’intégration du travail

Produit

Exigences actuelles du produit : Si vous disposez de Select ou Prime Adobe Workfront Planifiez, 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 l’Ultimate Workfront planifiez.

Ou

Exigences de produit héritées : Votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître le plan, le type de licence ou l’accès dont vous disposez, contactez votre Workfront administrateur.

Pour plus d’informations sur Adobe Workfront Fusion licences, voir Adobe Workfront Fusion licences

Conditions préalables

Pour utiliser Jira vous devez disposer d’un Jira compte .

Connexion Jira Software to Workfront Fusion

Votre méthode de connexion est basée sur l’utilisation ou non de Jira Cloud ou Jira Server.

Connexion Jira Cloud to Workfront Fusion

Connexion Jira Cloud to Workfront Fusion

Pour se connecter Jira Software to Workfront Fusion, vous devez créer un jeton API et l’insérer avec votre URL de service et votre nom d’utilisateur dans la variable Création d’une connexion champ dans Workfront Fusion.

Création d’un jeton API dans Jira

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

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

  3. Saisissez le nom du jeton, par exemple Workfront Fusion.

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

    note important
    IMPORTANT
    Vous ne pouvez plus afficher le jeton après avoir fermé cette boîte de dialogue.

    1. Stockez le jeton généré en lieu sûr.

  5. Passez à la Configurez la variable Jira Jeton API dans Workfront Fusion.

Configurez la variable Jira Jeton API dans Workfront Fusion

  1. Dans Workfront Fusion, ajoutez une Jira à un scénario pour ouvrir la Création d’une connexion de la boîte.

  2. Indiquez les informations suivantes :

  3. Cliquez sur Continuer pour créer la connexion et revenir au module.

Connexion Jira Server to Workfront Fusion

Pour autoriser une connexion entre Workfront Fusion et Jira Server, vous avez besoin de votre clé de client, de votre clé privée et de votre URL de service. Vous devrez peut-être contacter votre Jira pour ces informations.

Générer des clés publiques et privées pour votre Jira connection

Pour acquérir une clé privée pour votre Workfront Fusion Jira connexion, vous devez générer des clés publiques et privées.

  1. Dans votre terminal, exécutez ce qui suit : openssl des commandes.

    • openssl genrsa -out jira_privatekey.pem 1024

      Cette commande génère une clé privée 1024 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) vers le jira_privatekey.pcks8
      fichier .

    • openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem

      Cette commande extrait la clé publique du certificat vers le jira_publickey.pem fichier .

      note note
      NOTE
      Si vous utilisez Windows, vous devrez peut-être enregistrer la clé publique dans la variable jira_publickey.pem fichier manuellement :

      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. Passez à la Configuration de l’application cliente en tant que client dans Jira

Configuration de l’application cliente en tant que client dans Jira

  1. Connectez-vous à Jira instance.

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

  3. Dans le Saisissez l’URL de l’application que vous souhaitez lier. champ, entrer

    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 le Lier des applications , saisissez les valeurs dans la fenêtre Clé du client et Secret partagé champs.

    Vous pouvez choisir les valeurs de ces champs.

  6. Copiez les valeurs de la variable Clé du client et Secret partagé à un emplacement sécurisé.

    Vous aurez besoin de ces valeurs plus tard dans le processus de configuration.

  7. Renseignez les champs 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. Sélectionnez la Créer un lien entrant .

  9. Cliquez sur Continuer.

  10. Dans le Lier des applications , renseignez les champs suivants :

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    Consumer Key Collez la clé du consommateur que vous avez copiée vers un emplacement sécurisé.
    Nom du consommateur Saisissez le nom de votre choix. Ce nom est à titre de référence.
    Clé publique Collez la clé publique à partir de votre jira_publickey.pem fichier .

  11. Cliquez sur Continuer.

  12. Passez à la Créer une connexion à Jira Server ou Jira Data Center in Workfront Fusion

Créer une connexion à Jira Server ou Jira Data Center in Workfront Fusion

NOTE
Utilisez la variable Jira Server pour se connecter à l’application Jira Server ou Jira Data Center.
  1. Dans n’importe quel Jira Server module dans Workfront Fusion, cliquez sur Ajouter en regard de connection champ .
  2. Dans le Création d’une connexion , renseignez les champs suivants :
Nom de la connexion
Saisissez un nom pour la connexion.
Consumer Key
Collez la clé du client que vous avez copiée vers un emplacement sécurisé dans Configuration de l’application cliente en tant que client dans Jira
Private Key
Collez dans la clé privée à partir de la propriété jira_privatekey.pcks8 fichier que vous avez créé dans Générer des clés publiques et privées pour votre Jira connection.
Service URL
Saisissez votre Jira URL de l’instance.
  1. Cliquez sur Continuer pour créer la connexion et revenir au module .

Jira Software modules et leurs champs

Lorsque vous configurez Jira Software modules, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces Jira Software peut 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 de mappage situé au-dessus d’un champ ou d’une fonction s’affiche, 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 dans Adobe Workfront Fusion.

Triggers

Surveiller les enregistrements

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

Webhook

Sélectionnez le webhook que vous souhaitez utiliser pour rechercher des enregistrements.

Pour ajouter un nouveau webhook :

  1. Cliquez sur Ajouter

  2. Saisissez le nom du webhook.

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

    Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.

  4. Sélectionnez le type d’enregistrement que le logiciel doit surveiller :

    • Comment
    • Problème
    • Project
    • Sprint

Actions

Ajout d’un problème au sprint

Ce module d’action ajoute un ou plusieurs problèmes à un sprint.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
Sprint ID
Saisissez ou mappez l’ID d’impression du sprint auquel vous souhaitez ajouter un problème.
ID ou clés de problème
Ajoutez un ID ou une clé de problème pour chaque problème que vous souhaitez ajouter au sprint.

Création d’un enregistrement

Ce module d’action crée un nouvel enregistrement dans Jira.

Le module renvoie les champs standard associés à l’enregistrement, ainsi que les champs et valeurs personnalisés auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
Record Type

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

  • Pièce jointe
  • Comment
  • Problème
  • Project
  • Sprint
  • Worklog

Appel API personnalisé

Ce module d’action vous permet d’effectuer un appel authentifié personnalisé vers le Jira Software API. Ainsi, vous pouvez créer une automatisation du flux de données qui ne peut pas être réalisée par l’autre Jira Software modules.

Lors de la configuration de 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 à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
URL
Saisissez un chemin relatif à<Instance URL>/rest/api/2/
Méthode
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.

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:

Lorsque vous utilisez des instructions conditionnelles telles que if dans votre fichier JSON, placez les guillemets en dehors de l’instruction conditionnelle.

Suppression d’un enregistrement

Ce module d’action supprime un enregistrement particulier.

Vous spécifiez l’identifiant de l’enregistrement.

Le module renvoie l’identifiant de l’enregistrement et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement que le module doit supprimer.

  • Pièce jointe
  • Comment
  • Problème
  • Project
  • Sprint
ID ou clé
Saisissez ou mappez l’identifiant ou la clé de l’enregistrement que vous souhaitez supprimer.

Téléchargement d’une pièce jointe

Ce module d’action télécharge une pièce jointe particulière.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
ID
Saisissez ou mappez l’identifiant de la pièce jointe à télécharger.

Lire un enregistrement

Ce module d’action lit les données d’un seul enregistrement dans Jira Software.

Vous spécifiez l’identifiant de l’enregistrement.

Le module renvoie les champs standard associés à l’enregistrement, ainsi que les champs et valeurs personnalisés auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
Record Type

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

  • Pièce jointe
  • Problème
  • Project
  • Sprint
  • User
Sorties
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’unique Jira Software Identifiant de l’enregistrement que vous souhaitez que le module lise.

Mettre à jour un enregistrement

Ce module d’action met à jour un enregistrement existant, tel qu’un problème ou un projet.

Vous spécifiez l’identifiant de l’enregistrement.

Le module renvoie l’identifiant de l’enregistrement et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
Record Type

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

  • Comment
  • Problème
  • Project
  • Sprint
  • Problème de transition
ID ou clé
Saisissez ou mappez l’identifiant ou la clé de l’enregistrement que vous souhaitez mettre à jour.

Recherches

Lister des enregistrements

Ce module de recherche récupère tous les éléments d’un type spécifique correspondant à votre requête de recherche.

Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
Record Type

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

  • Comment
  • Problème
  • Project
  • Problème Sprint
  • Worklog
Résultats max.
Saisissez ou mappez le nombre maximum d'enregistrements que le module doit récupérer au cours de chaque cycle d'exécution de scénario.

Recherche d’enregistrements

Ce module de recherche recherche recherche des enregistrements dans un objet de la section Jira Software qui correspondent à la requête de recherche que vous spécifiez.

Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion à Jira Software compte à Workfront Fusion, voir Connexion Jira Software to Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement que le module doit rechercher. 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 Language)

    Pour plus d’informations sur JQL, voir JQL sur le site d’aide d’Atlassian.

  • Project

  • Projet par numéro

  • User

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