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 CloudServeur Jira
apiVersion22
apiVersionAgile1,01,0
Balise API1,7,291,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 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

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

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

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

Configurer le jeton d’API Jira dans Workfront Fusion

  1. Dans n’importe quel module de Jira Cloud de Workfront Fusion, cliquez sur Add en regard du champ connection .

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

  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
      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 Jira Settings icône des paramètres Jira > Applications> Application links.

  3. Dans le champ Enter the URL of the application you want to link , saisissez

    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
    
  4. 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 ».

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

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

  7. Remplissez les champs de l’URL comme suit :

    champDescription
    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
  8. Cochez la case Create incoming link .

  9. Cliquez sur Continue.

  10. Dans la fenêtre Link applications, renseignez les champs suivants :

    Consumer KeyCollez la clé de consommateur que vous avez copiée dans un endroit sûr.
    Consumer nameSaisissez le nom de votre choix. Ce nom est destiné à vous servir de référence.
    Public keyCollez la clé publique de votre fichier jira_publickey.pem.
  11. Cliquez sur Continue.

  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 de Jira Server de Workfront Fusion, cliquez sur Add en regard du champ connection .

  2. Dans le panneau Create a connection, renseignez les champs suivants :

    Connection nameSaisir le nom de la connexion
    EnvironmentChoisissez si vous utilisez un environnement de production ou hors production.
    TypeChoisissez si vous utilisez un compte de service ou un compte personnel.
    Consumer KeyCollez 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 KeyCollez 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 URLSaisissez l’URL de votre instance Jira. Exemple : yourorganization.atlassian.net
  3. 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.

Basculement de carte

Déclencheurs

Watch for records

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

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.

ConnectionPour obtenir des instructions sur la connexion de votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
Sprint IDSaisissez ou mappez l’ID du sprint auquel vous souhaitez ajouter un problème.
Issue ID or KeysPour chaque événement ou clé que vous souhaitez voir l’expérience, cliquez sur Add item et saisissez l’ID d’événement ou la clé. Vous pouvez saisir jusqu’à 50 dans un seul module.

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.

ConnectionPour obtenir des instructions sur la connexion de 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 créer par le module, puis renseignez les autres champs spécifiques à ce type d'enregistrement qui apparaîtront dans le module.

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

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.

ConnectionPour obtenir des instructions sur la connexion de votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
URLSaisir 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 :

Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, placez les guillemets à l’extérieur de l’instruction conditionnelle.

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.

ConnectionPour obtenir des instructions sur la connexion de 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 KeySaisissez ou mappez l’ID ou la clé de l’enregistrement que vous souhaitez supprimer.

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.

ConnectionPour obtenir des instructions sur la connexion de votre compte Jira Software à Workfront Fusion, voir Connecter Jira Software à Workfront Fusion dans cet article.
IDSaisissez ou mappez l’ID de la pièce jointe que vous souhaitez télécharger.

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.

ConnectionPour obtenir des instructions sur la connexion de 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
OutputsSé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 ».
IDSaisissez ou mappez l’ID unique Jira Software de l’enregistrement que vous souhaitez que le module lise.

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.

ConnectionPour obtenir des instructions sur la connexion de 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 KeySaisissez ou mappez l'identifiant ou la clé de l'enregistrement à mettre à jour, puis renseignez les autres champs spécifiques à ce type d'enregistrement qui apparaîtront dans le module.

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.

ConnectionPour obtenir des instructions sur la connexion de 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 ResultsSaisissez 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.

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.

ConnectionPour obtenir des instructions sur la connexion de 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

Page précédenteModules Hubspot CRM
Page suivanteModules MariaDB

Workfront