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
| 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 Packages Workfront Prime et Select, avec l’achat supplémentaire de Workfront Fusion. |
| Licences Adobe Workfront |
Standard Travail ou supérieur |
| Produit | Si votre organisation dispose d’un package Workfront Select ou Prime qui n’inclut pas l’automatisation et l’intégration de Workfront, elle doit acquérir Adobe Workfront Fusion. |
Pour plus d’informations sur le contenu de ce tableau, consultez Conditions d’accès requises dans la documentation Workfront.
s## 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 :
Connexion de Workfront Planning à Workfront Fusion
Le connecteur Workfront Planning utilise OAuth 2.0 pour se connecter à Workfront Planning.
Vous pouvez créer une connexion à votre compte Workfront Planning directement depuis un module Workfront Planning Fusion.
Se connecter à Workfront Planning à l’aide de l’ID client et du secret client
-
Dans un module Adobe Workfront Planning, cliquez sur Ajouter en regard du champ Connexion .
-
Remplissez les champs suivants :
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 type Sélectionnez Connexion d’authentification Adobe Workfront. Connection name Saisissez un nom pour la nouvelle connexion. Client ID Saisissez votre ID client Workfront. Vous le trouverez dans la zone Applications OAuth2 de la zone Configuration dans Workfront. Ouvrez l’application spécifique à laquelle vous vous connectez pour afficher l’ID client. Client Secret Saisissez votre secret client Workfront. Vous le trouverez dans la zone Applications OAuth2 de la zone Configuration dans Workfront. Si vous ne disposez pas d’un secret client pour votre application OAuth2 dans Workfront, vous pouvez en générer un autre. Pour obtenir des instructions, consultez la documentation de Workfront. Authentication URL Vous pouvez conserver la valeur par défaut ou saisir l’URL de votre instance Workfront, suivie de
/integrations/oauth2.Exemple :
https://mydomain.my.workfront.com/integrations/oauth2Host prefix Dans la plupart des cas, cette valeur doit être origin. -
Cliquez sur Continuer pour enregistrer la connexion et revenir au module.
Si vous n’êtes pas connecté à Workfront Planning, vous êtes redirigé vers un écran de connexion. Une fois la connexion effectuée, vous pouvez autoriser la connexion.
- Les connexions OAuth 2.0 à l’API Workfront ne dépendent plus des clés API.
- Pour créer une connexion à un environnement Sandbox Workfront, vous devez créer une application OAuth2 dans cet environnement, puis utiliser l’ID client et le secret client générés par cette application dans la connexion.
Connexion à Workfront Planning à l’aide d’une connexion serveur à serveur
-
Dans un module Adobe Workfront Planning, cliquez sur Ajouter en regard du champ Connexion .
-
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 7-row-2 layout-auto html-authored no-header Connection type Sélectionnez Connexion Adobe Workfront de serveur à serveur. Connection name Saisissez un nom pour la nouvelle connexion. Instance name Saisissez le nom de votre instance, également appelée domaine.
Exemple : si votre URL est
https://example.my.workfront.com, saisissezexample.Instance lane Indiquez le type d’environnement auquel cette connexion doit se connecter.
Exemple : si votre URL est
https://example.my.workfront.com, saisissezmy.Client ID Saisissez votre ID client Workfront. Vous le trouverez dans la zone Applications OAuth2 de la zone Configuration dans Workfront. Ouvrez l’application spécifique à laquelle vous vous connectez pour afficher l’ID client. Client Secret Saisissez votre secret client Workfront. Vous le trouverez dans la zone Applications OAuth2 de la zone Configuration dans Workfront. Si vous ne disposez pas d’un secret client pour votre application OAuth2 dans Workfront, vous pouvez en générer un autre. Pour obtenir des instructions, consultez la documentation de Workfront. Scopes Saisissez toutes les étendues applicables à cette connexion. Host prefix Dans la plupart des cas, cette valeur doit être origin. -
Cliquez sur Continuer pour enregistrer la connexion et revenir au module.
Si vous n’êtes pas connecté à Workfront Planning, vous êtes redirigé vers un écran de connexion. Une fois la connexion effectuée, vous pouvez autoriser la connexion.
- Les connexions OAuth 2.0 à l’API Workfront ne dépendent plus des clés API.
- Pour créer une connexion à un environnement Sandbox Workfront, vous devez créer une application OAuth2 dans cet environnement, puis utiliser l’ID client et le secret client générés par cette application dans la connexion.
Modules Adobe Workfront Planning et leurs champs
Lorsque vous configurez les modules Workfront, Workfront Fusion affiche les champs répertoriés ci-dessous. Des champs Workfront supplémentaires peuvent s’afficher, selon votre niveau d’accès dans l’application ou le service, par exemple. 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, consultez Mappage d’informations d’un module à l’autre.
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.
Actions
Supprimer un type d’enregistrement
Ce module d'action supprime un seul type d'enregistrement dans Workfront Planning par son identifiant.
Effectuer un appel API personnalisé.
Ce module lance un appel API personnalisé à l’API Adobe Workfront Planning.
Recherches
Rechercher des enregistrements
Ce module d’action récupère une liste d’enregistrements en fonction des critères que vous spécifiez.
Non classée
Créer un enregistrement
Cette action crée un enregistrement unique dans Workfront Planning.
Supprimer un enregistrement
Ce module d'action supprime l'enregistrement spécifié dans Workfront Planning.
Obtenir un enregistrement
Ce module d’action récupère un seul enregistrement d’Adobe Workfront Planning spécifié par son ID.
Obtenir des enregistrements par type d’enregistrement
Ce module d’action récupère tous les enregistrements du type spécifié.
Obtenir des types d’enregistrement
Ce module d’action récupère une liste de types d’enregistrement dans un compte Adobe Workfront Planning.
Mettre à jour l’enregistrement
Cette action met à jour un seul enregistrement dans Workfront Planning.
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.