Modules Jira

NOTE
Ces instructions s’appliquent à la nouvelle version du connecteur Jira, qui est simplement étiquetée Jira. Pour plus d’informations sur les connecteurs hérités de Jira Cloud et Jira Server, voir Modules logiciels Jira.

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

Le connecteur Jira peut être utilisé pour Jira Cloud et le serveur de données Jira.

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

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.

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 :

  • Sélectionnez ou le package Prime Workfront : votre entreprise doit acheter Adobe Workfront Fusion.
  • Package Ultimate Workfront : Workfront Fusion est inclus.

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.

Connecter Jira à Workfront Fusion

Créer les informations d’identification nécessaires

Pour créer des connexions à Jira, vous aurez besoin des éléments suivants :

Type de connexion
Type de compte
Informations d’identification nécessaires
OAuth 2
Tous
ID client et secret client
De base
Jira Cloud
Jeton API Jira
De base
Centre de données Jira
Jeton d’accès personnel Jira (PAT)

Pour obtenir des instructions sur la création de l’un de ces éléments, consultez la documentation Jira.

Lors de la création de ces informations d’identification, vous aurez besoin des informations suivantes :

  • Pour OAuth 2 :

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Centre de données Fusion URL de redirection
    US https://app.workfrontfusion.com/oauth/cb/workfront-jira2
    UE https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2
  • Pour les jetons d’accès personnel (PAT) :

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Centre de données Fusion URL de redirection
    US https://app.workfrontfusion.com/oauth/cb/workfront-jira
    UE https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira
    note important
    IMPORTANT
    Pour utiliser un PAT, vous devez activer les éléments suivants dans le jira/bin/WEB-INF/classes Fichiers, dans le jira-config.properties de fichiers :
    • jira.rest.auth.allow.basic = true
    • jira.rest.csrf.disabled = true
    Si ce fichier n’existe pas, vous devez le créer.

Création d’une connexion à Jira dans Workfront Fusion

Pour créer la connexion dans Workfront Fusion :

  1. Dans n’importe quel module Jira, cliquez sur Ajouter en regard du champ Connexion .

  2. Configurez les champs suivants :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header
    Type de connexion Choisissez si vous créez une connexion de base ou une connexion OAuth 2.
    Nom de la connexion Saisissez un nom pour la nouvelle connexion.
    URL du service Saisissez l’URL de votre instance Jira. Il s’agit de l’URL d’accès à Jira.
    Type de compte Jira Indiquez si vous vous connectez à Jira Cloud ou à Jira Data Center.
    ID client Si vous créez une connexion OAuth 2, saisissez votre identifiant client Jira
    Clé secrète client Si vous créez une connexion OAuth 2, saisissez votre secret client Jira
    E-mail Si vous créez une connexion de base à Jira Cloud, saisissez votre adresse e-mail.
    Jeton API Si vous créez une connexion de base à Jira Cloud, saisissez votre jeton API.
    Jeton d’accès personnel Si vous créez une connexion de base au centre de données Jira, saisissez votre jeton d’accès personnel.
    Version de l’API Sélectionnez la version de l’API Jira à laquelle vous souhaitez que cette connexion se connecte.
  3. Cliquez sur Continuer pour créer la connexion et retourner au module.

Modules Jira et leurs champs

Lorsque vous configurez des modules Jira, Workfront Fusion affiche les champs répertoriés ci-dessous. Selon des facteurs tels que votre niveau d’accès dans l’application ou le service, d’autres champs Jira peuvent s’afficher en plus de ceux-ci. 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

Rechercher 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 ou créez un webhook.

Pour créer un webhook :

  1. Cliquez sur Ajouter

  2. Saisissez un nom pour le webhook.

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

    Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à Workfront Fusion dans cet article.

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

    • Problème
    • Commentaire
    • Journal de travail
    • Projet
    • Sprint
    • Pièce jointe
  5. Sélectionnez un ou plusieurs types d’événements qui déclencheront ce scénario.

  6. Saisissez un filtre Jira Query Language pour ce module.

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

  7. Cliquez sur Enregistrer pour enregistrer le webhook.

Actions

Ajouter un problème au sprint

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

Connexion
Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à Workfront Fusion dans cet article.
ID de sprint
Saisissez ou mappez l’ID du sprint auquel vous souhaitez ajouter un problème.
ID ou clés de l'événement
Pour chaque événement ou clé à ajouter au sprint, cliquez sur Ajouter un élément et saisissez l’ID d’événement ou la clé. Vous pouvez saisir jusqu’à 50 dans un seul module.

Créer un enregistrement

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

Connexion
Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à Workfront Fusion dans cet article.
Type d’enregistrement

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

  • Pièce jointe
  • Commentaire
  • Problème
  • Projet
  • Sprint
  • Journal de travail
  • l’utilisateur ou de l’utilisatrice
  • Panorama
  • Catégorie
  • Filtre
Autres champs
Renseignez les autres champs. Les champs sont disponibles en fonction du type d’enregistrement sélectionné.

Appel API personnalisé

Ce module d’action vous permet d’effectuer un appel authentifié personnalisé vers l’API Jira.

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.

Connexion
Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à Workfront Fusion dans cet article.
URL
Saisir un chemin relatif à<Instance URL>/rest/api/2/
Méthode
En-têtes

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.

Chaîne de requête

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

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

Corps

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.

Supprimer un enregistrement

Ce module d'action supprime l'enregistrement spécifié.

Connexion
Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à Workfront Fusion dans cet article.
Type d'enregistrement

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

  • Commentaire
  • Problème
  • Projet
  • Sprint
  • Journal de travail
  • Pièce jointe
  • Panorama
  • Catégorie
  • Filtre
(Type d’enregistrement)ID
Saisissez ou mappez l’identifiant ou la clé de l’enregistrement à supprimer.

Télécharger une pièce jointe

Ce module d’action télécharge la pièce jointe spécifiée.

Connexion
Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à 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 de l’enregistrement spécifié dans Jira.

Connexion
Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à Workfront Fusion dans cet article.
Type d’enregistrement

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

  • Pièce jointe
  • Commentaire
  • Problème
  • Projet
  • Sprint
  • Journal de travail
  • l’utilisateur ou de l’utilisatrice
  • Panorama
  • Catégorie
  • Filtre
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 « Type d’enregistrement ».
(Type d’enregistrement) ID
Saisissez ou mappez l’ID Jira unique de l’enregistrement que le module doit lire.

Mettre à jour un enregistrement

Ce module d'action met à jour un enregistrement existant, tel qu'un événement ou un projet.

Connexion
Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à Workfront Fusion dans cet article.
Type d’enregistrement

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.

  • Commentaire
  • Problème
  • Projet
  • Sprint
  • Problème de transition
  • Catégorie
  • Filtre
ID ou clé
Saisissez ou mappez l’identifiant ou la clé de l’enregistrement que vous souhaitez mettre à jour.
Autres champs
Renseignez les autres champs. Les champs sont disponibles en fonction du type d’enregistrement sélectionné.

Recherches

Rechercher des enregistrements

Ce module de recherche recherche les enregistrements d’un objet dans Jira qui correspondent à la requête que vous spécifiez.

Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connexion
Pour plus d’informations sur la connexion de votre compte Jira à Workfront Fusion, voir Connexion de Jira à Workfront Fusion dans cet article.
Type d’enregistrement

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.

  • Problème
  • Projet
  • l’utilisateur ou de l’utilisatrice
  • Sprint
  • Panorama
  • Journal de travail
  • Commentaire
  • Problème de transition
  • Catégorie
Nbre max. de résultats
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.
Offset
Saisissez ou mappez l’ID du premier élément pour lequel vous souhaitez récupérer des détails. Il s’agit d’une méthode de pagination des enregistrements. Si vous saisissez le 5000e élément comme décalage, le module renvoie les éléments 5000-9999.
Autres champs
Renseignez les autres champs. Les champs sont disponibles en fonction du type d’enregistrement sélectionné.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3