Modules Adobe Workfront Planning

Avec les modules Adobe Workfront Planning, vous pouvez déclencher un scénario lorsque des événements se produisent dans Workfront Planning. Vous pouvez également créer, lire, mettre à jour et supprimer des enregistrements, ou effectuer un appel API personnalisé vers votre compte Adobe Workfront Planning.

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 accéder à Workfront Planning, vous devez disposer des éléments suivants :

  • Un nouveau package et une nouvelle licence Workfront. Workfront Planning n’est pas disponible pour les packages ou licences Workfront hérités.
  • Un package Workfront Planning.
  • L’instance de Workfront de votre organisation doit être intégrée à l’expérience unifiée Adobe.

Informations sur l’API Adobe Workfront Planning

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

URL de base
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
Balise API
v1.13.7

Créer une connexion à Adobe Workfront Planning create-a-connection-to-adobe-workfront-planning

Vous pouvez créer une connexion à votre compte Workfront Planning directement depuis un module Workfront Fusion.

  1. Dans un module Adobe Workfront Planning, 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

    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 Adobe Workfront Planning et leurs champs

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

Surveiller les événements

Ce module de déclenchement démarre un scénario lorsqu’un enregistrement, un type d’enregistrement ou un espace de travail est créé, mis à jour ou supprimé dans Workfront Planning.

Webhook
Sélectionnez le webhook à utiliser ou cliquez sur Ajouter pour en créer un nouveau.
Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Object type
Indiquez si vous souhaitez surveiller des enregistrements, des types d’enregistrement ou des espaces de travail.
State

Indiquez si vous souhaitez surveiller l’ancien ou le nouvel état.

  • New state

    Déclenchez un scénario lorsque l’enregistrement prend une valeur donnée.

  • Old state

    Déclenchez un scénario lorsque l’enregistrement quitte une valeur donnée.

Workspace
Si vous observez des enregistrements, sélectionnez le Workspace que vous souhaitez observer pour les enregistrements.
Record type
Si vous observez des enregistrements, sélectionnez le type d’enregistrement à observer.
Events filters

Vous pouvez définir des filtres pour ne surveiller que les enregistrements qui répondent aux critères sélectionnés.

Pour chaque filtre, saisissez le champ que le filtre doit évaluer, l’opérateur et la valeur que le filtre doit autoriser. Vous pouvez utiliser plusieurs filtres en ajoutant des règles ET.

Remarque : vous ne pouvez pas modifier les filtres dans les Webhooks Workfront existants. Pour configurer différents filtres pour les abonnements aux événements Workfront, supprimez le webhook actif et créez-en un.

Pour plus d’informations sur les filtres d’événement, consultez la section Filtres d’abonnement aux événements dans les modules Workfront > Watch Events dans l’article Modules Workfront .

Objects to watch
Indiquez si vous souhaitez surveiller les enregistrements. nouveaux, mis à jour, nouveaux et mis à jour ou supprimés.
Exclude updates made by this connection
Activez cette option pour empêcher le déclenchement du scénario lorsqu’une modification est effectuée par la connexion utilisée par ce module. Cela empêche qu’une autre instance du scénario soit déclenchée si ce scénario exécute une action de déclenchement.

Actions

Supprimer un type d’enregistrement

Ce module d'action supprime un seul type d'enregistrement dans Workfront Planning par son identifiant.

WARNING
La suppression d’un type d’enregistrement dans Workfront Planning entraîne la suppression de tous les enregistrements de la table des types d’enregistrement.
Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Record type ID
Saisissez ou mappez l’identifiant du type d’enregistrement à supprimer.

Effectuer un appel API personnalisé.

Ce module lance un appel API personnalisé à l’API Adobe Workfront Planning.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
URL
Saisir un chemin relatif à https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
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.
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 automatiquement des en-têtes d’autorisation.

Query String
Pour chaque paire clé/valeur à ajouter à la chaîne de requête, cliquez sur Ajouter un élément et saisissez la clé et la valeur.
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 autour de l’instruction conditionnelle.

Recherches

Rechercher des enregistrements

Ce module d’action récupère une liste d’enregistrements en fonction des critères que vous spécifiez.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Workspace
Saisissez ou mappez le Workspace contenant les enregistrements que vous souhaitez rechercher.
Record type
Sélectionnez le type d’enregistrement à rechercher.
Record Fields
Pour chaque champ à utiliser dans votre recherche, localisez ce champ, sélectionnez l’opérateur et saisissez ou mappez la valeur à rechercher. Les champs sont disponibles en fonction du type d’enregistrement sélectionné.
Condition pour les filtres

Sélectionnez la condition de vos filtres :

  • ET

    Le module renvoie les enregistrements qui respectent toutes les valeurs de champ que vous avez sélectionnées.

  • OU

    Le module renvoie les enregistrements qui correspondent à l’une valeurs de champ que vous avez sélectionnées.

Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Non classée

Créer un enregistrement

Cette action crée un enregistrement unique dans Workfront Planning.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Record type ID
Saisissez ou mappez le type d’enregistrement que vous souhaitez créer. Les types d’enregistrements disponibles dépendent de votre compte Workfront Planning.
Autres champs
Saisissez les valeurs que vous souhaitez attribuer au nouvel enregistrement. Ces champs sont basés sur le type d’enregistrement que vous avez sélectionné.

Supprimer un enregistrement

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

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Record ID
Saisissez ou mappez l’ID de l’enregistrement que vous souhaitez supprimer.

Obtenir un enregistrement

Ce module d’action récupère un seul enregistrement d’Adobe Workfront Planning spécifié par son ID.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Record ID
Saisissez ou mappez l’ID de l’enregistrement que vous souhaitez récupérer.

Obtenir des enregistrements par type d’enregistrement

Ce module d’action récupère tous les enregistrements du type spécifié.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Workspace
Sélectionnez ou mappez l’espace de travail qui contient les enregistrements que vous souhaitez récupérer.
Record type
Sélectionnez le type d’enregistrement que vous souhaitez récupérer.

Obtenir des types d’enregistrement

Ce module d’action récupère une liste de types d’enregistrement dans un compte Adobe Workfront Planning.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Workspace
Sélectionnez ou mappez l’espace de travail contenant les types d’enregistrements à récupérer.

Mettre à jour l’enregistrement

Cette action met à jour un seul enregistrement dans Workfront Planning.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Workfront Planning, voir Créer une connexion à Adobe Workfront Planning dans cet article.
Record ID
Saisissez ou mappez le type d’enregistrement que vous souhaitez mettre à jour. Les types d’enregistrements disponibles dépendent de votre compte Workfront Planning.
Autres champs
Saisissez les nouvelles valeurs que vous souhaitez attribuer à l'enregistrement. Ces champs sont basés sur le type d’enregistrement que vous avez sélectionné.

Utiliser JSONata pour la répartition lisible des record-types

L’expression JSONata suivante crée une sortie lisible par l’utilisateur de la requête Planning qui vous donne la répartition des types d’enregistrements. Le nom du type d’enregistrement, les noms des champs et les noms des options de champ (le cas échéant) sont ainsi lisibles par un nom et le reste de la structure reste intact.

(
    $s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
    $s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
    $s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
    $s2.data{displayName:$}
)

Pour plus d’informations sur l’utilisation des modules JSONata, voir Modules JSONata.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3