Modules des tableaux Adobe Workfront

NOTE
Le connecteur Boards Fusion est en version bêta. Par conséquent, la prise en charge de ce connecteur est limitée et peut changer en raison du développement futur des tableaux. En outre, des modifications apportées sans préavis à l’API GraphQL peuvent avoir une incidence sur votre processus Fusion Connector.

Les panoramas Adobe Workfront sont des outils flexibles qui permettent aux équipes de collaborer entre elles. Ils permettent d’accéder à un panorama partagé contenant des colonnes et des cartes.

Vous pouvez utiliser les modules des tableaux Adobe Workfront pour lire ou mettre à jour des enregistrements, effectuer un appel API vers l’API des tableaux Workfront ou déclencher un scénario lorsqu’une action se produit sur un tableau.

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

Vous devez avoir configuré un panorama dans Adobe Workfront avant de pouvoir vous y connecter.

Informations sur l’API des tableaux Adobe Workfront

Le connecteur Adobe Workfront Boards utilise les éléments suivants :

Balise API
v1.23.6

Création d’une connexion aux tableaux Workfront

NOTE
Vous pouvez utiliser une connexion Workfront pour vous connecter aux tableaux Workfront ou créer une connexion aux tableaux Workfront distincte.

Pour créer une connexion aux tableaux Workfront :

  1. Dans un module Adobe Workfront Boards, cliquez sur Ajouter en regard de la zone Connexion.

  2. Remplissez 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 layout-auto html-authored no-header
    Connection name Saisissez un nom pour cette connexion.
    Environment Indiquez si vous vous connectez à un environnement de production ou hors production.
    Type Choisissez si vous souhaitez vous connecter à un compte de service ou à un compte personnel.

    Client ID

    (Facultatif)

    Saisissez votre Client ID Adobe. Vous pouvez le trouver dans la section Credentials details d’Adobe Developer Console.

    Client Secret

    (Facultatif)

    Saisissez votre Client Secret Adobe. Vous pouvez le trouver dans la section Credentials details d’Adobe Developer Console.

    Authentication URL

    (Facultatif)

    Saisissez l’URL que votre instance de Workfront utilisera pour authentifier cette connexion.

    La valeur par défaut est https://oauth.my.workfront.com/integrations/oauth2.

    Host prefix

    Saisissez votre préfixe hôte.

    La valeur par défaut est origin-.

  3. Cliquez sur Continuer pour enregistrer la connexion et revenir au module.

Modules des tableaux Adobe Workfront et leurs champs

Lorsque vous configurez les modules des tableaux Workfront, Workfront Fusion affiche les champs répertoriés ci-dessous. D’autres champs de tableaux Workfront peuvent également 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

vignette

Ajouter un élément de la liste de contrôle

Ce module d’action ajoute un élément de liste de contrôle à la vignette spécifiée.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Card ID

Saisissez ou mappez l’identifiant de la carte à laquelle vous souhaitez ajouter un élément de liste de contrôle.

L’ID de la carte se trouve dans l’URL lors de l’affichage de la carte dans Workfront.

Checklist items
Pour chaque élément de la liste de contrôle que vous souhaitez ajouter, cliquez sur Ajouter un élément, saisissez le nom de l’élément de la liste de contrôle et indiquez si l’élément est terminé.

Ajouter une sous-tâche

Ce module d’action ajoute une sous-tâche à une carte dans les tableaux. La carte doit être connectée. La sous-tâche est également ajoutée à la tâche Workfront que la carte représente.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

ID de carte parent

Saisissez ou mappez l’identifiant de la carte à laquelle vous souhaitez ajouter une sous-tâche.

L’ID de la carte se trouve dans l’URL lors de l’affichage de la carte dans Workfront.

Board ID

Saisissez ou mappez l’ID du panorama contenant la carte à laquelle vous souhaitez ajouter une sous-tâche.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Name
Saisissez ou mappez un nom pour la nouvelle sous-tâche.

Création d’une carte

Ce module d’action permet de créer une carte sur un panorama Workfront.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Board ID

Saisissez ou mappez l’ID du panorama auquel vous souhaitez ajouter une carte.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Column ID

Saisissez ou mappez l’identifiant de la colonne à laquelle vous souhaitez ajouter une sous-tâche.

L’ID de colonne se trouve dans les informations renvoyées par le module Lecture de tableau .

Name
Saisissez ou mappez un nom pour la nouvelle carte.

Déplacer une carte

Ce module d’action déplace une carte vers une autre colonne du même panorama.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Card ID

Saisissez ou mappez l’ID de la carte à déplacer.

L’ID de la carte se trouve dans l’URL lors de l’affichage de la carte dans Workfront.

Board ID

Saisissez ou mappez l’ID du panorama contenant la carte à déplacer.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

ID de colonne de destination

Saisissez ou mappez l’identifiant de la colonne vers laquelle vous souhaitez déplacer la carte.

L’ID de colonne se trouve dans les informations renvoyées par le module Lecture de tableau .

To index

Saisissez ou mappez la position que la carte doit avoir dans la nouvelle colonne.

Position supérieure dans la colonne de l'index 0.

Lire une carte

Ce module d’action récupère des informations sur une carte spécifique.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Card ID

Saisissez ou mappez l’identifiant de la carte que vous souhaitez lire.

L’ID de la carte se trouve dans l’URL lors de l’affichage de la carte dans Workfront.

Card ID

Saisissez ou mappez l’identifiant du panorama contenant la carte que vous souhaitez lire.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Mise à jour d’une carte

Ce module d’action met à jour les informations d’une carte que vous spécifiez.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Card ID

Saisissez ou mappez l’identifiant de la carte à mettre à jour.

L’ID de la carte se trouve dans l’URL lors de l’affichage de la carte dans Workfront.

Board ID

Saisissez ou mappez l’ID du panorama contenant la carte à mettre à jour.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Name
Saisissez ou mappez un nouveau nom pour la carte.
Description
Saisissez ou mappez une nouvelle description pour la carte.
Estimation
Saisissez ou mappez une estimation du temps nécessaire pour terminer cette carte.
Due date

Saisissez ou mappez la date d'échéance de cette carte.

Pour obtenir la liste des formats de date et d’heure pris en charge, voir Coercition de type dans Adobe Workfront Fusion.

Status
Sélectionnez un nouveau statut pour la carte.

Panneaux

Créer un panorama

Ce module d’action crée un panorama dans Workfront. Vous pouvez indiquer le type de panorama à créer.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Board name
Saisissez ou mappez un nom pour le nouveau panorama.
Template
Sélectionnez le modèle correspondant au type de panorama que vous souhaitez créer.

Lire un panorama

Ce module d’action renvoie des informations sur un tableau, telles que les cartes, les colonnes, les balises et les membres du tableau.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Board ID

Saisissez ou mappez l’ID du panorama pour lequel vous souhaitez récupérer des informations.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Colonnes

Créer une colonne

Ce module d’action crée une colonne sur le panorama spécifié.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Board ID

Saisissez ou mappez l’identifiant du panorama auquel vous souhaitez ajouter une colonne.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Column ID

Saisissez ou mappez l’identifiant de la colonne à mettre à jour.

L’ID de colonne se trouve dans les informations renvoyées par le module Lecture de tableau .

Nom de colonne
Saisissez ou mappez un nouveau nom pour la colonne.

Rechercher une colonne

Ce module de recherche renvoie des informations sur la colonne portant le nom spécifié.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Board ID

Saisissez ou mappez l’identifiant du panorama contenant la colonne à récupérer.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Nom de colonne
Saisissez ou mappez le nom de la colonne à récupérer.

Mise à jour d’une colonne

Ce module d'action met à jour le nom ou la limite des travaux en cours de la colonne spécifiée.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Board ID

Saisissez ou mappez l’identifiant du panorama contenant la colonne à récupérer.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Nom de colonne
Saisissez ou mappez le nom de la colonne à récupérer.
WIP Limit
Saisissez ou mappez une nouvelle limite de travail en cours pour la colonne.

Balises

Ajouter une balise à une carte

Ce module d’action ajoute une balise à une carte.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Card ID

Saisissez ou mappez l’identifiant de la carte à laquelle vous souhaitez ajouter une balise.

L’ID de la carte se trouve dans l’URL lors de l’affichage de la carte dans Workfront.

Board ID

Saisissez ou mappez l’identifiant du panorama contenant la carte à laquelle vous souhaitez ajouter une balise.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Tag ID

Saisissez ou mappez l’identifiant de la balise que vous souhaitez ajouter.

L’ID de balise se trouve dans les informations renvoyées par le module Lecture de tableau .

Créer une balise

Ce module d’action crée une balise et lui affecte une couleur.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Board ID

Saisissez ou mappez l’identifiant du panorama pour lequel vous souhaitez créer une balise.

L’ID du panorama se trouve dans l’URL lors de l’affichage du panorama dans Workfront.

Tag name
Saisissez ou mappez le nom de la nouvelle balise.
Tag Color
Sélectionnez la couleur de cette balise.

Commentaires

Créer un commentaire

Ce module d’action a créé un commentaire sur la carte spécifiée.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Card ID

Saisissez ou mappez l’identifiant de la carte à laquelle vous souhaitez ajouter un commentaire.

L’ID de la carte se trouve dans l’URL lors de l’affichage de la carte dans Workfront.

Comment
Saisissez ou mappez le texte du commentaire que vous souhaitez ajouter.

Lire les commentaires de la carte

Ce module d’action récupère les commentaires de la carte spécifiée.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Card ID

Saisissez ou mappez l’identifiant de la carte pour laquelle vous souhaitez récupérer les commentaires.

L’ID de la carte se trouve dans l’URL lors de l’affichage de la carte dans Workfront.

Limit
Saisissez le nombre maximal de commentaires que le module doit renvoyer au cours d'un cycle d'exécution.

Autre

Effectuer un appel API personnalisé.

Ce module d’action effectue un appel personnalisé à l’API Workfront Boards.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

URL
Saisissez un chemin relatif vers https://<WORKFRONT_DOMAIN>/boards-service/graphql?.
Method

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.

Pour la plupart des appels de panorama, la méthode est POST.

Headers

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard. Cela détermine le type de contenu de la requête.

Par exemple, { "Content-type":"application/json-stringify()"}

Query String

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

Pour les tableaux Workfront, cette section est généralement laissée vide.

Body

Ajoutez le contenu du corps de l’appel API sous la forme d’un Graphql incorporé JSON

Exemple :

Cet exemple montre comment mettre à jour le nom d'une colonne. Vous pouvez inclure les boardId et columnId en tant que GUID codés en dur ou mappés à partir d’un module précédent.

{
 « query »: « mutation { updateColumn(boardId: \« \ », columnId: \« \ », updateColumnInput: { name: \« \ » }) { id name }} »
}

Note :

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

Effectuer un appel API GraphQL personnalisé

Ce module d’action envoie une requête GraphQL personnalisée à l’API Workfront Boards.

Connection

Vous pouvez utiliser une connexion Workfront existante pour vous connecter aux tableaux Workfront ou une connexion aux tableaux Workfront spécifique.

Pour plus d’informations sur la connexion de votre application Workfront aux Workfront Fusion, voir Création d’une connexion aux tableaux Workfront dans cet article.

Method
Sélectionnez la méthode de cet appel.
Query
Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.
Nom de l’opération
Saisissez un nom pour cette opération. Cela peut faciliter le suivi et le débogage de l’appel .
Source de données des variables
Indiquez si les variables proviennent d’un formulaire ou d’une collection.
Variables
Pour chaque variable à ajouter, cliquez sur Ajouter un élément et saisissez la clé et la valeur de la variable.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3