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.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Package Adobe Workfront

Tout package de workflow Adobe Workfront et tout package d’automatisation et d’intégration Adobe Workfront

Workfront Ultimate

les packages Workfront Prime et Select, avec un achat supplémentaire de Workfront Fusion.

Licences Adobe Workfront

Standard

Travail ou supérieur

Produit Si votre entreprise dispose d’un package Select ou Prime Workfront qui n’inclut pas l’automatisation et l’intégration de Workfront, elle 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.

accordion
## Prérequis

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 :

table 0-row-2 1-row-2 layout-auto html-authored no-header
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.

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 layout-auto html-authored no-header
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.

note warning
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.
table 0-row-2 1-row-2 layout-auto html-authored no-header
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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
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.

table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header
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.

table 0-row-2 1-row-2 layout-auto html-authored no-header
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.

table 0-row-2 1-row-2 layout-auto html-authored no-header
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é.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
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.

table 0-row-2 1-row-2 layout-auto html-authored no-header
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.

table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header
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.

code language-none
(
    $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