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

Conditions préalables

Pour accéder à Workfront Planning, vous devez disposer des éléments suivants :

Informations sur l’API Adobe Workfront Planning

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

https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/

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

Connexion à Workfront Planning à l’aide d’une connexion serveur à serveur

Modules Adobe Workfront Planning version 2 et leurs champs

Lorsque vous configurez les modules de planification 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.

Espaces de travail (V2)

Créer un espace de travail (V2)

Ce module d’action crée un espace de travail dans Planning.

Suppression d’un espace de travail (V2)

Ce module d’action supprime un seul espace de travail, spécifié par l’ID.

Obtenir tous les espaces de travail (V2)

Ce module récupère une liste de tous les espaces de travail.

Obtenir un espace de travail (V2)

Ce module récupère un espace de travail par son identifiant.

Mise à jour d’un espace de travail (V2)

Ce module d’action met à jour un nouvel espace de travail dans Planning.

Types d’enregistrement (V2)

Création d’un type d’enregistrement (V2)

Ce module d’action crée un nouveau type d’enregistrement dans l’espace de travail sélectionné.

Suppression d’un type d’enregistrement (V2)

Ce module d’action supprime un seul type d’enregistrement, spécifié par l’ID.

Obtention des types d’enregistrements globaux (V2)

Ce module récupère une liste des types d’enregistrements dans un compte Adobe Workfront Planning.

Obtenir un type d’enregistrement (V2)

Ce module récupère un type d’enregistrement par son identifiant.

Obtenir les types d’enregistrements (V2)

Ce module récupère une liste des types d’enregistrements disponibles dans un espace de travail donné.

Mise à jour d’un type d’enregistrement (V2)

Ce module met à jour un type d’enregistrement.

Enregistrements (V2)

Création d’un enregistrement (V2)

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

Suppression d’un enregistrement (V2)

Ce module d’action supprime un seul enregistrement, spécifié par l’ID.

Obtenir un enregistrement (V2)

Ce module d’action récupère un enregistrement, spécifié par son identifiant.

Obtention des enregistrements par type d’enregistrement (V2)

Ce module récupère une liste de tous les enregistrements du type d’enregistrement donné.

Déplacer des enregistrements (V2)

Ce module réorganise un ou plusieurs enregistrements dans un type d’enregistrement en spécifiant où les placer.

Rechercher des enregistrements (V2)

Retourner les enregistrements selon les critères que vous spécifiez

Mise à jour d’un enregistrement (V2)

Ce module met à jour l’enregistrement spécifié.

Champs (V2)

Créer un champ (V2)

Ce module d’action crée un champ sur le type d’enregistrement spécifié.

Suppression d’un champ (V2)

Ce module d’action supprime un seul champ, spécifié par l’ID.

Obtenir un champ (V2)

Ce module récupère un champ par son identifiant.

Obtenir les champs par type d’enregistrement (V2)

Ce module récupère une liste de champs pour un type d’enregistrement spécifique.

Mise à jour d’un champ (V2)

Ce module met partiellement à jour un champ par son identifiant.

Vues (V2)

Création d’une vue (V2)

Ce module d’action crée une vue pour le type d’enregistrement sélectionné.

Suppression d’une vue (V2)

Ce module d’action supprime une vue unique, spécifiée par l’ID.

Obtenir une vue (V2)

Ce module récupère une vue par son identifiant.

Obtention des vues par type d’enregistrement (V2)

Ce module récupère une liste de vues pour le type d’enregistrement spécifique.

Mise à jour d’une vue (V2)

Ce module d’action met à jour la vue spécifiée.

Autorisations (V2)

Ignorer les demandes d’accès (V2)

Ce module d’action rejette une ou plusieurs demandes d’accès, spécifiées par l’ID.

Récupérer tous les membres et leurs rôles pour une ressource (V2)

Ce module répertorie tous les utilisateurs, groupes et équipes qui ont une relation de partage explicite sur la ressource. Les informations d’identification utilisées dans la connexion pour ce module doivent disposer de l’autorisation Gérer sur la ressource.

Obtenir les autorisations effectives de l’utilisateur actuel sur une ressource (V2)

Ce module renvoie les autorisations d’affichage, de modification, de suppression et d’ajout de l’utilisateur actuel pour une ressource donnée.

Liste des demandes d’accès en attente pour une ressource (V2)

Ce module renvoie toutes les demandes d’accès en attente pour la ressource donnée.

Demande d’accès à une ressource (V2)

Ce module crée ou met à jour une demande d’accès pour l’utilisateur actuel sur la ressource donnée.

Autres (V2)

Obtention de l’ID d’authentification à partir de l’ID Workfront (V2)

Ce module prend un ID utilisateur Workfront et renvoie l’ID d’autorisation correspondant utilisé par Planning.

Effectuer un appel API personnalisé (V2)<table

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

Événements Espion (V2)

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.

Pour un exemple d’utilisation de la logique avancée sur ce module, voir Exemple de logique avancée dans le module Événements de montre.

Modules Adobe Workfront Planning version 1 et leurs champs

Lorsque vous configurez les modules de planification 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.

Pour un exemple d’utilisation de la logique avancée sur ce module, voir Exemple de logique avancée dans le module Événements de montre.

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 effectue 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.

Exemple de logique avancée dans le module watch Events

Il s’agit d’un exemple du format pris par une logique avancée lors de l’utilisation du module Workfront Planning > Événements Espion .

[
  {
    "fieldName": "recordTypeId",
    "fieldValue": "Rt68c886502d4b5554ee80896b",
    "comparison": "eq",
    "state": "newState"
  },
  {
    "fieldName": "data",
    "fieldValue": {
      "F68c886502d4b5554ee808975": "planning"
    },
    "comparison": "eq",
    "state": "newState"
  },
  {
    "fieldName": "data",
    "fieldValue": {
      "F68c886502d4b5554ee808975": "active"
    },
    "comparison": "eq",
    "state": "newState"
  }
]

Tenez compte des points suivants lors de l’utilisation d’une logique avancée dans le module Événement de contrôle :