DocumentationAdobe Workfront Fusion

Modules Adobe Workfront

Dernière mise à jour : 25 août 2026
IMPORTANT
Cet article contient des instructions pour la nouvelle version du connecteur Workfront, publiée le 22 octobre 2025. Ce nouveau connecteur reflète les modifications apportées à l’API Workfront.
Le nouveau connecteur s’appelle « Workfront » et le connecteur précédemment disponible s’appelle « Workfront (hérité) ».
Nous vous recommandons ce qui suit :
  • utiliser le nouveau connecteur lors de la création ou de la mise à jour d’un scénario ;
  • mettre à niveau des modules existants vers le nouveau connecteur.
L’ancien connecteur Workfront utilise la version 20 de l’API Workfront, dont l’abandon est prévu avec la version 28.4 (avril 2028). Les modules du connecteur hérité continueront à fonctionner jusqu’à cette date.
Pour obtenir des instructions sur la mise à niveau de modules existants, consultez Mettre à niveau un module Workfront vers une nouvelle version dans l’article Mettre à niveau un module vers une nouvelle version.
Pour plus d’informations sur les raisons pour lesquelles un nouveau connecteur est parfois nécessaire, consultez Vue d’ensemble des API dans Fusion.

Vous pouvez utiliser le connecteur Adobe Workfront Fusion d’Adobe Workfront pour automatiser vos processus dans Workfront. Vous pouvez également connecter Workfront à d’autres applications et services.

Pour obtenir des instructions sur la création d’un scénario, consultez les articles sous Créer des scénarios : index des articles. Pour plus d’informations sur les modules, consultez les articles sous Modules : index des articles.

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

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.

Connecter Workfront à Workfront Fusion

Le connecteur Workfront utilise OAuth 2.0 pour se connecter à Workfront.

Vous pouvez créer une connexion à votre compte Workfront directement à partir d’un module Workfront Fusion.

Se connecter Workfront à l’aide de l’ID client et du secret client

  1. Dans un module Adobe Workfront, cliquez sur Ajouter en regard du champ 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 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/oauth2
    Host prefix Dans la plupart des cas, cette valeur doit être origin.

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

    Si vous n’avez pas encore effectué votre connexion à Workfront, on vous redirige vers un écran de connexion. Une fois la connexion effectuée, vous pouvez autoriser la connexion.

NOTE
  • 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 à l’aide d’une connexion de serveur à serveur

  1. Dans un module Adobe Workfront, cliquez sur Ajouter en regard du champ 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 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, saisissez example.
    Instance lane

    Indiquez le type d’environnement auquel cette connexion doit se connecter.

    Exemple : si votre URL est https://example.my.workfront.com, saisissez my.
    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.

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

    Si vous n’avez pas encore effectué votre connexion à Workfront, on vous redirige vers un écran de connexion. Une fois la connexion effectuée, vous pouvez autoriser la connexion.

NOTE
  • 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 Workfront 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.

Bouton (bascule) de mappage

NOTE
  • Si vous ne voyez pas les champs les plus à jour dans un module Workfront, cela peut être dû à des problèmes de mise en cache. Patientez une heure et réessayez.
  • Les codes d’état HTTP 429 d’Adobe Workfront ne doivent pas provoquer de désactivations, mais déclencher une courte pause dans l’exécution du scénario.

Déclencheurs

Surveiller les événements

Ce module de déclenchement exécute un scénario en temps réel lorsque des objets d’un type spécifique sont ajoutés, mis à jour ou supprimés dans Workfront.

Le module affiche tous les abonnements aux événements liés au webhook. Cela inclut les abonnements aux événements créés via Fusion ainsi que les abonnements aux événements créés directement via l’API. Cette vue d’abonnement aux événements n’est pas disponible dans la version héritée du module Surveiller les événements.

Le module renvoie tous les champs standard associés à l’enregistrement, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

IMPORTANT
Vous pouvez modifier ce module ultérieurement. Le webhook sera modifié.
Tenez compte des points suivants lors de la mise à jour d’un webhook :
  • Le webhook modifié est traité par les abonnements aux événements de Workfront comme un nouvel abonnement. L’historique des abonnements aux événements n’est pas conservé pour la configuration webhook précédente, car il est considéré comme un abonnement aux événements distinct.
  • Le passage de l’ancien au nouvel abonnement à un événement peut ne pas être parfaitement synchronisé. Il est donc possible de recevoir un événement deux fois (si le nouvel abonnement commence à s'exécuter avant l'arrêt de l'ancien) ou de manquer un événement (si l'ancien abonnement s'arrête avant que le nouveau ne commence à s'exécuter).
Pour plus d’informations sur la modification des Webhooks, voir Modifier les Webhooks.

  1. Cliquez sur Ajouter à droite de la zone Webhook.

  2. Configurez le webhook dans la zone Ajouter un hook qui s’affiche.

    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
    Webhook name Saisissez un nom pour le webhook.
    Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
    Record Type Sélectionnez le type d’enregistrement Workfront que le module doit surveiller.
    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.

      Par exemple, si l’état est défini sur New State et que le filtre est défini sur Status Equals In Progress, le webhook déclenche un scénario lorsque le Status passe à In Progress, quel que soit le statut antérieur.

    • Old state

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

      Par exemple, si l’état est défini sur Old State et que le filtre est défini sur Status Equals In Progress, le webhook déclenche un scénario lorsqu’un Status, qui est actuellement In Progress passe à un autre statut.
    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.

    NOTE : 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 actuel et créez-en un nouveau.

    Pour plus d’informations sur les filtres d’événements, consultez Filtres d’abonnement aux événements dans les modules Workfront > Watch Events dans cet article.
    Exclure les événements créés par cette connexion

    Activez cette option pour exclure les événements créés ou mis à jour à l’aide du même connecteur que celui utilisé par ce module de déclenchement. Cela peut empêcher qu’un scénario se déclenche lui-même et se répète en une boucle sans fin.

    NOTE : le type d’enregistrement Affectation n’inclut pas cette option.
    Record Origin

    Choisissez si vous souhaitez que le scénario surveille les New Records Only, les Updated Records Only, les New and Updated Records ou les Deleted Records Only.

    NOTE : si vous choisissez les New and Updated Records, la création du webhook entraîne la création de deux abonnements à des événements (pour la même adresse de webhook).
    Activer les hooks sécurisés

    Choisissez si vous souhaitez activer la sécurité basée sur authToken pour ce webhook.

    REMARQUE : à compter du 23 août 2026, Fusion active la sécurité basée sur authToken par défaut pour tous les modules Workfront > Événement de contrôle, y compris les modules existants. Si un webhook spécifique est rompu ou si vous devez le désactiver pour des raisons de compatibilité, vous pouvez désactiver l’option Activer les hooks sécurisés .

Une fois le webhook créé, vous pouvez afficher l’adresse du point d’entrée auquel les événements sont envoyés.

Pour plus d’informations, consultez la section Exemples de payloads d’événement dans l’article API d’abonnement aux événements dans la documentation de Workfront.

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Champ de contrôle

Ce module de déclenchement exécute un scénario lorsqu’un champ que vous spécifiez est mis à jour. Le module renvoie l’ancienne et la nouvelle valeur du champ que vous spécifiez. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement Workfront que le module doit surveiller.

Par exemple, sélectionnez Task si vous souhaitez commencer à exécuter le scénario chaque fois qu’un champ d’enregistrement est mis à jour dans une tâche.

Field
Sélectionnez le champ que le module doit surveiller pour les mises à jour. Ces champs reflètent ceux que votre administrateur ou administratrice Workfront a configurés pour le suivi.
Outputs
Sélectionnez les champs d’objet que vous souhaitez inclure dans le bundle de sortie pour ce module.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans les types d’objet Workfront disponibles pour chaque module Workfront.

Enregistrement de contrôle

Ce module déclencheur exécute un scénario lorsque des objets d’un type spécifique sont ajoutés, mis à jour ou les deux. Le module renvoie tous les champs standard associés à l’enregistrement ou aux enregistrements, ainsi que les champs et valeurs personnalisés auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Dans la sortie, le module indique si chaque enregistrement est nouveau ou mis à jour.

Les enregistrements qui ont été ajoutés et mis à jour depuis la dernière exécution du scénario sont renvoyés en tant que nouveaux enregistrements.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Filter
Choisissez si vous souhaitez que le scénario surveille les New Records Only, les Updated Records Only ou les New and Updated Records.
Record Type

Sélectionnez le type d’enregistrement Workfront que le module doit surveiller.

Par exemple, si vous souhaitez lancer le scénario chaque fois qu’un nouveau projet est créé, sélectionnez Project.

Outputs
Sélectionnez les champs que vous souhaitez inclure dans le bundle de sortie pour ce module.
Reference
Sélectionnez les champs de référence que vous souhaitez inclure dans le bundle de sortie pour ce module.
Outputs
Sélectionnez les champs de collection que vous souhaitez inclure dans le bundle de sortie pour ce module.
Optional Filter
(Avancé) Saisissez une chaîne de code API pour définir des paramètres ou du code supplémentaires qui affineront vos critères.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans les types d’objet Workfront disponibles pour chaque module Workfront.

Actions

Convertir un objet

Ce module d’action effectue l’une des conversions suivantes :

  • Convertir un problème en projet
  • Convertir un problème en tâche
  • Convertir une tâche en projet
NOTE
Depuis juillet 2024, les formulaires personnalisés peuvent être inclus lors de la conversion d’un objet.
Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connexion de Workfront à Workfront Fusion dans cet article.
Object type
Sélectionnez le type d’objet à convertir. Il s’agit du type dont dispose l’objet avant la conversion.
Convert to
Sélectionnez l’objet dans lequel vous souhaitez le convertir. Il s’agit du type de l’objet après la conversion.
<Object> ID

Saisissez l’ID de l’objet.

Remarque : lorsque vous saisissez l’identifiant d’un objet, vous pouvez commencer à saisir son nom, puis le sélectionner dans la liste. Le module saisit ensuite l’ID approprié dans le champ.

Template ID

Si vous effectuez une conversion vers un projet, sélectionnez l’ID de modèle à utiliser pour le projet.

Remarque : lorsque vous saisissez l’identifiant d’un objet, vous pouvez commencer à saisir son nom, puis le sélectionner dans la liste. Le module saisit ensuite l’ID approprié dans le champ.

Custom forms
Sélectionnez les formulaires personnalisés à ajouter à l’objet nouvellement converti, puis saisissez les valeurs des champs du formulaire personnalisé.
Options
Activez les options souhaitées lors de la conversion de l’objet. Des options sont disponibles selon l’objet que vous convertissez ou à partir duquel vous effectuez cette conversion.
Copy native fields
Activez cette option pour copier les champs natifs de l’objet d’origine vers le nouvel objet.
Copy custom forms
Activez cette option pour copier les champs natifs de l’objet d’origine vers le nouvel objet.

Créer un enregistrement

Ce module d’action crée un objet tel qu’un projet, une tâche ou un problème dans Workfront et vous permet d’ajouter un formulaire personnalisé au nouvel objet. Le module vous permet de sélectionner les champs de l’objet disponibles dans le module.

Vous indiquez l’ID de l’enregistrement.

Le module renvoie l’ID de l’enregistrement et tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Veillez à indiquer le nombre minimum de champs de saisie. Par exemple, si vous souhaitez créer un problème, vous devez fournir un identifiant de projet parent valide dans le champ d’identifiant de projet pour indiquer l’emplacement du problème dans Workfront. Vous pouvez utiliser le panneau de mappage pour mapper ces informations à partir d’un autre module dans votre scénario, ou vous pouvez les saisir manuellement en saisissant le nom, puis en le sélectionnant dans la liste.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement Workfront que le module doit créer.

Par exemple, si vous souhaitez créer un projet, sélectionnez Project dans la liste déroulante.

Select fields to map

Sélectionnez les champs qui doivent être disponibles pour la saisie de données. Vous pouvez ainsi accéder rapidement aux champs pertinents sans devoir tous les parcourir. Vous pouvez ensuite saisir ou mapper des données dans ces champs.

Pour les champs des formulaires personnalisés, utilisez le champ Attach Custom Form.

Attach Custom Form
Sélectionnez les formulaires personnalisés que vous souhaitez ajouter au nouvel objet, sélectionnez les champs pour lesquels vous souhaitez saisir des valeurs, puis saisissez ou mappez des valeurs pour ces champs.

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

NOTE
  • Lorsque vous saisissez l’ID d’un objet, vous pouvez commencer à saisir son nom, puis le sélectionner dans la liste. Le module saisit ensuite l’ID approprié dans le champ.
  • Lors de la saisie du texte d’un champ personnalisé ou d’un objet Note (commentaire ou réponse), vous pouvez utiliser des balises HTML dans le champ Texte de la note pour créer du texte enrichi, comme du texte en gras ou en italique.
NOTE
Les utilisateurs et utilisatrices sont créés avec un statut Désactivé et En attente d’approbation. Si votre organisation a été migrée vers l’Adobe Admin Console et que le badge En attente d’approbation n’est pas supprimé dans les minutes qui suivent, vous pouvez approuver l’utilisateur ou l’utilisatrice.

  • Valider les utilisateurs et utilisatrices individuels

    Vous pouvez valider des utilisateurs et utilisatrices individuels dans la liste Utilisateurs et utilisatrices.

    1. Sélectionnez la ou les personnes dans la liste Utilisateurs et utilisatrices.
    2. Cliquez sur le menu à trois points dans l’en-tête de la liste.
    3. Sélectionnez Approuver.
    4. Après quelques minutes, actualisez la page.

  • Valider les utilisateurs et utilisatrices ajoutés dans un lot volumineux

    Pour valider les utilisateurs et utilisatrices ajoutés dans un lot volumineux, vous pouvez ajouter ce lot de personnes directement dans Adobe Admin Console.

    Pour obtenir des instructions, voir la section Gérer plusieurs utilisateurs et utilisatrices | Chargement CSV en masse dans la documentation Adobe.

Appel API personnalisé

Ce module d’action vous permet d’effectuer un appel personnalisé et authentifié à l’API Workfront. Vous pouvez ainsi créer une automatisation du flux de données que les autres modules Workfront ne peuvent pas réaliser.

Le module renvoie les informations suivantes :

  • Code d’état (nombre) : indique la réussite ou l’échec de votre requête HTTP. Ce sont des codes standard que vous pouvez consulter sur Internet.

  • En-têtes (objet) : contexte plus détaillé pour le code de réponse/d’état qui ne se rapporte pas au corps de sortie. Tous les en-têtes qui apparaissent dans un en-tête de réponse ne sont pas des en-têtes de réponse. Certains peuvent donc ne pas vous être utiles.

    Les en-têtes de réponse dépendent de la requête HTTP que vous avez choisie lors de la configuration du module.

  • Corps (objet) : selon la requête HTTP que vous avez choisie lors de la configuration du module, vous pouvez recevoir des données en retour. Ces données, telles que les données d’une requête GET, sont contenues dans cet objet.

Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
URL
Saisissez un chemin relatif vers https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.
API Version
Sélectionnez la version de l’API Workfront que vous souhaitez que le module utilise.
Method
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, consultez Méthodes de requête HTTP dans Adobe Workfront Fusion.
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"}

Note : si vous obtenez des erreurs et qu’il est difficile de déterminer leur origine, envisagez de modifier les en-têtes en fonction de la documentation Workfront. Si votre appel API personnalisé renvoie une erreur de requête HTTP 422, essayez d’utiliser un en-tête "Content-Type":"text/plain".

Query String

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

Par exemple : {"name":"something-urgent"}

Conseil : nous vous recommandons d’envoyer des informations via le corps JSON plutôt que sous forme de paramètres de requête.

Body

Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.

Note :

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

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans les types d’objet Workfront disponibles pour chaque module Workfront.

Supprimer l’enregistrement

Ce module d’action supprime un objet, tel qu’un projet, une tâche ou un problème dans Workfront.

Vous indiquez l’ID de l’enregistrement.

Le module renvoie l’ID de l’enregistrement et tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Force delete
Activez cette option pour assurer la suppression de l’enregistrement, et ce même si l’interface d’utilisation de Workfront demande la confirmation de la suppression.
Async delete
Activez cette option pour permettre au module d’effectuer une suppression asynchrone.
ID

Saisissez l’identifiant Workfront unique de l’enregistrement que le module doit supprimer.

Pour obtenir l’ID, ouvrez l’objet Workfront dans votre navigateur et copiez le texte à la fin de l’URL après « ID= ». Par exemple : https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Record Type
Sélectionnez le type d’enregistrement Workfront que le module doit supprimer.

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans les types d’objet Workfront disponibles pour chaque module Workfront.

NOTE
Nous vous recommandons de configurer le scénario suivant pour éviter que les enregistrements ne soient supprimés en raison d’opérations asynchrones.
  1. Supprimez l’enregistrement de manière synchrone.
  2. Ajoutez la gestion des erreurs au module Supprimer l’enregistrement pour ignorer l’erreur provoquée par le délai d’expiration de 40 secondes.

Télécharger un document

Ce module d’action permet de télécharger un document à partir de Workfront.

Vous indiquez l’ID de l’enregistrement.

Le module renvoie le contenu, le nom, l’extension et la taille de fichier du document. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Document ID

Mappez ou saisissez manuellement l’ID Workfront unique du document que le module doit télécharger.

Pour obtenir l’ID, ouvrez l’objet Workfront dans votre navigateur et copiez le texte à la fin de l’URL après « ID= ». Par exemple : https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Obtenir une URL de fichier prédéfinie

Ce module d’action reçoit des URL de fichier prédéfinies qui peuvent être utilisées ultérieurement par d’autres API.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Document ID

Mappez ou saisissez manuellement l’ID Workfront unique du document pour lequel vous souhaitez obtenir une URL présignée.

Pour obtenir l’ID, ouvrez l’objet Workfront dans votre navigateur et copiez le texte à la fin de l’URL après « ID= ». Par exemple : https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Time to URL expiration

Saisissez ou mappez le nombre de minutes pendant lesquelles cette URL existera avant son expiration. La valeur par défaut est 1 minute.

Pour modifier cette valeur, ce paramètre doit être activé par l’équipe Workfront Fusion. S’il n’est pas activé, la valeur reste égale à 1 minute, quel que soit le nombre que vous avez saisi.

Actions diverses

Ce module d’action vous permet d’effectuer des actions sur l’API.

NOTE
Depuis juillet 2024, l’action convertToProject inclut le champ copyCategories. Lorsque la valeur est définie sur TRUE, tous les formulaires personnalisés sont inclus dans le projet vers lequel le problème est converti.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Record Type
Sélectionnez le type d’enregistrement Workfront avec lequel le module doit interagir.
Action

Sélectionnez l’action que le module doit exécuter.

Vous devrez peut-être remplir des champs supplémentaires, en fonction du Record Type et de l’Action que vous choisissez. Certaines combinaisons de ces deux paramètres peuvent ne nécessiter qu’un ID d’enregistrement, tandis que d’autres (telles que Projet pour le Record Type et le Attach Template pour l’Action) requièrent des informations supplémentaires (comme un ID d’objet et un ID de modèle).

Pour connaître les options disponibles pour certaines actions, reportez-vous à la section Options d’action diverses dans cet article.

Pour plus d’informations sur les champs individuels, consultez la section Documentation destinée à l’équipe de développement de Workfront.

Note : le site de documentation destinée à l’équipe de développement contient uniquement des informations jusqu’à la version 14 de l’API. Il inclut néanmoins des informations précieuses pour les appels API.

  1. Sélectionnez le type d’enregistrement dans le volet de navigation de gauche de la page de documentation relative au développement de Workfront. Les types suivants possèdent leurs propres pages :

    • Projects

    • Tasks

    • Issues

    • Users

    • Documents

    Pour tous les autres types d’enregistrement, sélectionnez Other objects and endpoints et recherchez le type d’enregistrement sur les pages triées par ordre alphabétique.

  2. Sur la page du type d’enregistrement approprié, recherchez l’action (Ctrl+F ou Cmd+F).

  3. Affichez les descriptions des champs disponibles sous l’action sélectionnée.

Note :

Lorsque vous créez une épreuve avec le module Misc Action de Workfront, il est recommandé de créer une épreuve sans options avancées, puis de la mettre à jour à l’aide de l’API SOAP Workfront Proof.

Pour plus d’informations sur la création d’une épreuve avec l’API Workfront (que ce module utilise), consultez Ajouter des options avancées lors de la création d’une épreuve avec l’API Adobe Workfront.

ID

Saisissez ou mappez l’ID Workfront unique de l’enregistrement avec lequel le module doit interagir.

Pour obtenir l’ID, ouvrez l’objet Workfront dans votre navigateur et copiez le texte à la fin de l’URL après « ID= ». Par exemple : https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Options d’action diverses
Tâche
Action
Options
Copier

  • clearApprovers

  • clearAssignments

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Effacer les données financières

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Effacer les notifications de rappel

Déplacer

  • clearApprovers

  • clearAssignments

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    Effacer les données financières

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Effacer les notifications de rappel

Problème
Action
Options
Copier
  • clearApprovers
  • clearAssignments
  • clearCustomData
  • clearDocuments
  • clearPermissions
  • clearProgress
Convertir en une tâche

  • preserveIssue

    Conserver le problème d’origine et lier sa résolution à cette tâche

  • preservePrimaryContact

    Autoriser le contact principal du problème à accéder à cette tâche

  • preserveCompletionDate

    Conserver la date d’achèvement prévue du problème

Convertir en projet

  • preserveIssue

    Conserver le problème d’origine et lier sa résolution à cette tâche

  • preservePrimaryContact

    Autoriser le contact principal du problème à accéder à cette tâche

Projet
Action
Options
Copier

  • clearApprovers

  • clearAssignments

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Effacer les données financières

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Effacer les notifications de rappel

Joindre un modèle / Enregistrer comme modèle

  • clearApprovers

  • clearAssignments

  • clearBillingRates

  • clearConstraints

  • clearDeliverables

    Efface les objectifs.

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Effacer les données financières

  • clearHourTypes

  • clearIssueSetup

    Efface les propriétés de file d’attente et la configuration des problèmes.

  • clearPredecessors

  • clearRisks

  • clearSharingOptions

  • clearTimedNotifications

    Effacer les notifications de rappel

Lire un enregistrement

Ce module d’action récupère les données d’un seul enregistrement.

Vous indiquez l’ID de l’enregistrement. Vous pouvez également spécifier les enregistrements associés que le module doit lire.

Par exemple, si l’enregistrement que le module est en train de lire est un projet, vous pouvez spécifier que vous souhaitez que les tâches du projet soient lues.

Le module renvoie un tableau de données des champs de sortie que vous avez spécifiés.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Record Type
Choisissez le type d’objet Workfront que le module doit lire.
Outputs
Sélectionnez les informations que vous souhaitez inclure dans le bundle de sortie pour ce module.
Output Custom Form
Sélectionnez les formulaires personnalisés à inclure dans le bundle de sortie pour ce module, puis sélectionnez les champs spécifiques à partir des formulaires personnalisés à inclure dans la sortie.
References
Sélectionnez les champs de référence que vous souhaitez inclure dans la sortie.
Collections
Sélectionnez les champs de référence que vous souhaitez inclure dans la sortie.
ID

Saisissez l’ID Workfront unique de l’enregistrement que le module doit lire.

Pour obtenir l’ID, ouvrez l’objet Workfront dans votre navigateur et copiez le texte à la fin de l’URL après « ID= ». Par exemple : https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Mettre à jour la version de la payload des événements

Workfront a récemment publié une nouvelle version de son service d’abonnement aux événements. La nouvelle version ne constitue pas une modification de l’API Workfront, mais plutôt une modification de la fonctionnalité d’abonnement aux événements. Ce module d’action met à jour la version de la payload de l’événement utilisée pour ce scénario.

Pour plus d’informations sur la nouvelle version de l’abonnement aux événements, consultez Contrôle de version des abonnements aux événements dans la documentation de Workfront.

Pour obtenir des ressources sur la conservation de vos scénarios Workfront Fusion pendant la mise à niveau des abonnements aux événements, y compris un enregistrement de webinaire, consultez Conservation de vos scénarios Fusion pendant la mise à niveau de la version V2 des abonnements aux événements.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connexion de Workfront à Workfront Fusion dans cet article.
Version
Sélectionnez la version de l’abonnement aux événements à utiliser pour cette payload.

Mettre à jour un enregistrement

Ce module d’action met à jour un objet, tel qu’un projet, une tâche ou un problème. Le module vous permet de sélectionner les champs de l’objet disponibles dans le module.

Vous indiquez l’ID de l’enregistrement.

Le module renvoie l’ID de l’objet et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connexion de Workfront à Workfront Fusion dans cet article.
ID

Saisissez l’ID Workfront unique de l’enregistrement que le module doit mettre à jour.

Pour obtenir l’ID, ouvrez l’objet Workfront dans votre navigateur et copiez le texte à la fin de l’URL après « ID= ». Par exemple : https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Record Type
Sélectionnez le type d’enregistrement Workfront que le module doit mettre à jour.
Select fields to map
Sélectionnez les champs qui doivent être disponibles pour la saisie de données. Vous pouvez ainsi accéder rapidement aux champs pertinents sans devoir tous les parcourir. Vous pouvez ensuite saisir ou mapper des données dans ces champs.
Attach Custom Form

Sélectionnez les formulaires personnalisés pour lesquels vous souhaitez fournir des valeurs de champ dans le nouvel enregistrement. Après avoir sélectionné le formulaire, saisissez les données des champs de ce formulaire.

Pour fournir les valeurs de champ d’un formulaire que vous joignez dans ce module, incluez l’ID du formulaire personnalisé dans la section Champs à mapper.

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans les types d’objet Workfront disponibles pour chaque module Workfront.

NOTE
Lors de la saisie du texte d’un champ personnalisé ou d’un objet Note (commentaire ou réponse), vous pouvez utiliser des balises HTML dans le champ Texte de la note pour créer du texte enrichi, comme du texte en gras ou en italique.

Charger le document

Ce module d’action charge un document vers un objet Workfront, comme un projet, une tâche ou un problème. Ce module charge le document par blocs, ce qui rend le processus de chargement plus fluide pour Workfront.

Ce module peut gérer des fichiers plus volumineux que le module hérité et fait partie d’un déploiement échelonné destiné aux organisations qui disposent d’un package Ultimate Workfront.

Indiquez l’emplacement du document, le fichier à charger et éventuellement un nouveau nom pour le fichier.

Le module renvoie l’ID du document et des champs associés, ainsi que les valeurs et les champs personnalisés auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connexion de Workfront à Workfront Fusion dans cet article.
Related Record ID
Saisissez l’ID Workfront unique de l’enregistrement dans lequel charger le document.
Related Record Type
Sélectionnez le type d’enregistrement Workfront où le module doit charger le document.
Folder ID
Selon le type d’enregistrement associé, vous devrez peut-être saisir ou mapper un ID de dossier.
Source file
Sélectionnez un fichier source à partir d’un module précédent ou mappez le nom et les données du fichier source.

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Recherches

Lire les enregistrements associés

Ce module de recherche lit les enregistrements correspondant à la requête de recherche que vous spécifiez, dans un objet parent particulier.

Vous spécifiez les champs à inclure dans la sortie. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement parent (objet Workfront) dont vous souhaitez lire les enregistrements associés.

Consultez la liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans les types d’objet Workfront disponibles pour chaque module Workfront dans cet article.

Parent Record ID

Saisissez ou mappez l’identifiant de l’enregistrement parent dont vous souhaitez lire les enregistrements associés.

Pour obtenir l’ID, ouvrez l’objet Workfront dans votre navigateur et copiez le texte à la fin de l’URL après « ID= ». Par exemple : https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Collections
Sélectionnez ou mappez le type d’enregistrement enfant que le module doit lire.
Outputs
Sélectionnez les informations que vous souhaitez inclure dans le bundle de sortie pour ce module.

Rechercher

Ce module recherche les enregistrements dans un objet de Workfront correspondant à la requête que vous spécifiez.

Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Record Type
Sélectionnez le type d’enregistrement Workfront que le module doit rechercher.
Custom forms list
Sélectionnez au moins un formulaire personnalisé. Les champs de ces formulaires personnalisés seront disponibles pour la requête.
Result Set
Sélectionnez une option pour indiquer si vous souhaitez que le module obtienne le premier résultat correspondant à vos critères de recherche ou tous les résultats correspondants.
Maximal
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.
Search criteria fields
Sélectionnez les champs que vous souhaitez utiliser pour vos critères de recherche. Ces champs seront ensuite disponibles dans la liste déroulante Critères de recherche.
Search criteria

Renseignez le champ avec lequel vous souhaitez effectuer une recherche, l’opérateur que vous souhaitez utiliser dans votre requête et la valeur que vous recherchez dans le champ.

Note : n’utilisez pas username dans vos critères de recherche. L’inclusion de username dans une requête API à Workfront connecte l’utilisateur ou l’utilisatrice à Workfront, et la recherche échoue.

Note : In et NotIn fonctionnent avec des tableaux. Les entrées doivent être au format de tableau.

Outputs
Sélectionnez les champs que vous souhaitez inclure dans la sortie de ce module.
References
Sélectionnez les champs de référence à inclure dans la recherche.
Collections
Sélectionnez les collections à ajouter à la recherche.

Recherche (hérité)

IMPORTANT
Ce module a été remplacé par le module Rechercher des enregistrements. Nous vous recommandons d’utiliser ce module dans les nouveaux scénarios.
Les scénarios existants qui utilisent ce module continueront à fonctionner comme prévu. Ce module sera supprimé du sélecteur de modules en mai 2025.

Ce module recherche les enregistrements dans un objet de Workfront correspondant à la requête que vous spécifiez.

Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, consultez Connecter Workfront à Workfront Fusion dans cet article.
Record Type
Sélectionnez le type d’enregistrement Workfront que le module doit rechercher.
Result Set
Sélectionnez une option pour indiquer si vous souhaitez que le module obtienne le premier résultat correspondant à vos critères de recherche ou tous les résultats correspondants.
Maximal
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.
Search criteria fields
Sélectionnez les champs que vous souhaitez utiliser pour vos critères de recherche. Ces champs seront ensuite disponibles dans la liste déroulante Critères de recherche.
Search criteria

Renseignez le champ avec lequel vous souhaitez effectuer une recherche, l’opérateur que vous souhaitez utiliser dans votre requête et la valeur que vous recherchez dans le champ.

Note : n’utilisez pas username dans vos critères de recherche. L’inclusion de username dans une requête API à Workfront connecte l’utilisateur ou l’utilisatrice à Workfront, et la recherche échoue.

Note : In et NotIn fonctionnent avec des tableaux. Les entrées doivent être au format de tableau.

Outputs
Sélectionnez les champs que vous souhaitez inclure dans la sortie de ce module.
References
Sélectionnez les champs de référence à inclure dans la recherche.
Collections
Sélectionnez les collections à ajouter à la recherche.

Types d’objet Workfront disponibles pour chaque module Workfront

Types d’objet disponibles pour chaque module de déclenchement Workfront

Watch Record
Watch Field
Watch Events
Processus d’approbation
✓
Affectation
✓
✓
Niveau de référence
✓
Enregistrement de facturation
✓
Taux de facturation
✓
Entreprise
✓
✓
✓
Tableau de bord
✓
Document
✓
✓
✓
Dossier de documents
✓
✓
Demande de document
✓
Version du document
✓
✓
Frais
✓
✓
✓
Type de frais
Groupe
✓
✓
Heure
✓
✓
Type d’heure
✓
Problème
✓
✓
✓
Itération
✓
✓
Fonction
✓
✓
Entrée au journal
✓
Jalon
✓
Chemin jalonné
✓
✓
Note
✓
✓
✓
Balise de note
✓
Portfolio
✓
✓
✓
Programme
✓
✓
✓
Projet
✓
✓
✓
Utilisateur du projet
✓
Approbation d'épreuve
✓
Temps réservé*
✓
Rapport
✓
Risque
Type de risque
Personne approbatrice d’étape
✓
Tâche
✓
✓
✓
Equipe
✓
Modèle
✓
✓
✓
Tâche de modèle
✓
✓
Feuille de temps
✓
✓
✓
l’utilisateur ou de l’utilisatrice
✓
✓
✓
Mettre à jour

Types d’objet disponibles pour chaque module d’action Workfront

NOTE
Le module Télécharger un document n’est pas inclus dans ce tableau, car les types d’objets Workfront ne font pas partie de sa configuration.
Create a record
Update a record
Delete a record
Upload Document
Read a record
Custom API Call
Misc Action
Processus d’approbation
✓
✓
✓
✓
✓
✓
✓
Affectation
✓
✓
✓
✓
✓
✓
Niveau de référence
✓
✓
✓
✓
Enregistrement de facturation
✓
✓
✓
✓
Taux de facturation
✓
✓
✓
✓
✓
Entreprise
✓
✓
✓
✓
✓
✓
✓
Document
✓
✓
✓
✓
✓
✓
✓
Dossier de documents
✓
✓
✓
✓
✓
✓
✓
Version du document
✓
✓
✓
✓
✓
✓
Taux de change
✓
✓
✓
✓
Frais
✓
✓
✓
✓
✓
✓
✓
Type de frais
✓
✓
✓
✓
Document externe
✓
Groupe
✓
✓
✓
✓
✓
✓
✓
Heure
✓
✓
✓
✓
✓
Type d’heure
✓
✓
✓
✓
Problème
✓
✓
✓
✓
✓
✓
✓
Itération
✓
✓
✓
✓
✓
Fonction
✓
✓
✓
✓
✓
Entrée au journal
✓
✓
✓
✓
✓
✓
Jalon
✓
✓
✓
✓
✓
Chemin jalonné
✓
✓
✓
✓
✓
Note
✓
✓
✓
✓
✓
✓
✓
Balise de note
✓
✓
✓
✓
✓
Portfolio
✓
✓
✓
✓
✓
✓
✓
Programme
✓
✓
✓
✓
✓
✓
✓
Projet
✓
✓
✓
✓
✓
✓
✓
Utilisateur du projet
✓
✓
✓
✓
✓
Temps réservé*
✓
✓
✓
✓
✓
Risque
✓
✓
✓
✓
✓
Type de risque
✓
✓
✓
✓
Personne approbatrice d’étape
✓
✓
✓
✓
✓
Tâche
✓
✓
✓
✓
✓
✓
✓
Equipe
✓
✓
✓
✓
Modèle
✓
✓
✓
✓
✓
Tâche de modèle
✓
✓
✓
✓
✓
✓
✓
Feuille de temps
✓
✓
✓
✓
✓
l’utilisateur ou de l’utilisatrice
✓
✓
✓
✓
✓
✓
✓
Mettre à jour
✓

Types d’objet disponibles pour chaque module de recherche Workfront

Search
Read Related Records
Processus d’approbation
✓
✓
Affectation
✓
✓
Enregistrement de facturation
✓
Taux de facturation
✓
Entreprise
✓
✓
Document
✓
✓
Dossier de documents
✓
✓
Version du document
✓
Frais
✓
Type de frais
✓
Groupe
✓
✓
Heure
✓
Type d’heure
✓
Problème
✓
✓
Itération
✓
Fonction
✓
Entrée au journal
✓
Jalon
✓
Chemin jalonné
✓
Note
✓
Balise de note
✓
Portfolio
✓
✓
Programme
✓
Projet
✓
✓
Utilisateur du projet
✓
Temps réservé*
✓
Risque
✓
Type de risque
✓
Personne approbatrice d’étape
✓
Tâche
✓
✓
Equipe
✓
Modèle
✓
Tâche de modèle
✓
Feuille de temps
✓
✓
l’utilisateur ou de l’utilisatrice
✓
✓
Délégation d'utilisateur
✓

Nous vous recommandons de vérifier deux fois pour vous assurer que cela fonctionne comme prévu.

Filtres d’abonnement aux événements dans les modules Workfront > Surveiller les événements

Les filtres dans les abonnements aux événements vous permettent de vous assurer que vos scénarios s’exécutent uniquement lorsque certains paramètres sont remplis.

Bonnes pratiques relatives au filtre d’abonnement aux événements

NOTE

  • Il est vivement recommandé d’utiliser des filtres d’abonnement aux événements dans vos modules Surveiller les événements.

  • Workfront a récemment publié une nouvelle version de son service d’abonnement aux événements. La nouvelle version ne constitue pas une modification de l’API Workfront, mais plutôt une modification de la fonctionnalité d’abonnement aux événements. Ce module d’action met à jour la version de la payload de l’événement utilisée pour ce scénario.

    Pour plus d’informations sur la nouvelle version de l’abonnement aux événements, consultez Contrôle de version des abonnements aux événements dans la documentation de Workfront.

    Pour obtenir des ressources sur la conservation de vos scénarios Workfront Fusion pendant la mise à niveau des abonnements aux événements, y compris un enregistrement de webinaire, consultez Conservation de vos scénarios Fusion pendant la mise à niveau de la version V2 des abonnements aux événements.

Le module Surveiller les événements de Workfront déclenche des scénarios basés sur un webhook qui crée un abonnement à un événement dans l’API Workfront. L’abonnement à un événement est un ensemble de données qui détermine les événements envoyés au webhook. Par exemple, si vous configurez un module Surveiller les événements qui recherche les problèmes, alors l’abonnement à l’événement envoie uniquement les événements liés aux problèmes.

En utilisant des filtres d’abonnement aux événements, les utilisateurs et utilisatrices de Fusion peuvent créer des abonnements aux événements qui conviennent mieux à leurs cas d’utilisation. Par exemple, vous pouvez configurer un abonnement à un événement dans l’API Workfront pour n’envoyer au webhook que les problèmes qui se trouvent dans un projet spécifique, ce qui garantit que le module Surveiller les événements ne se déclenchera que pour les problèmes de ce projet. La possibilité de créer des déclencheurs plus étroits améliore la conception des scénarios en réduisant le nombre de déclencheurs non pertinents.

Cela diffère de la configuration d’un filtre dans le scénario Workfront Fusion. Sans filtre d’abonnement à un événement, votre webhook reçoit tous les événements liés au type d’objet sélectionné. La plupart de ces événements seraient hors de propos dans le scénario et doivent être filtrés avant que le scénario puisse continuer.

Les opérateurs suivants sont disponibles dans le filtre Workfront > Surveiller les événements :

  • Est égal à

  • Non égal à

  • Supérieur à

  • Inférieur à

  • Est supérieur ou égal à

  • Est inférieur ou égal à

  • Contient

  • Existe

    • Cet opérateur ne nécessite pas de valeur et le champ de valeur est absent.

  • N’existe pas

    • Cet opérateur ne nécessite pas de valeur et le champ de valeur est absent.

  • Modifié

    • Cet opérateur ne nécessite pas de valeur et le champ de valeur est absent.
    • Cet opérateur ignore le champ État.
    • Lorsque vous utilisez Changed, sélectionnez Événements mis à jour uniquement dans le champ Origine de l’enregistrement.
IMPORTANT
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 actuel et créez-en un nouveau.
INFO
Exemple : supposons un scénario de traitement de nouveaux problèmes affectés à une utilisatrice spécifique, Ana.

Filtrer les événements à l’aide d’un filtre d’abonnement aux événements (recommandé)

En utilisant le filtre d’événement, vous pouvez configurer le webhook pour qu’il déclenche le scénario lorsqu’un problème est affecté à Ana lors de la création du problème. L’ID d’utilisatrice d’Ana est b378489d8f7cd3cee0539260720a84b7.
Filtre d’événement
Si 100 problèmes sont créés en une journée, mais que seuls deux d’entre eux sont affectés à Ana, le scénario s’exécutera deux fois.

Filtrer les événements au sein du scénario (non recommandé)

Pour filtrer les événements afin que seuls les problèmes affectés à Ana soient traités, vous pouvez créer un filtre après le module Événements de contrôle.
Sans filtre d’événement
Si 100 problèmes sont créés en une journée, mais que seuls deux d’entre eux sont affectés à Ana, le scénario s’exécutera 100 fois. Le filtre arrêtera 98 exécutions, mais le module déclencheur continuera à consommer des données et à effectuer des opérations dans toutes les exécutions.

Pour plus d’informations sur les abonnements aux événements Workfront, consultez Questions fréquentes - Abonnements aux événements.

Pour plus d’informations sur les webhooks, consultez Déclencheurs instantanés (webhooks) dans Adobe Workfront Fusion.

Pour plus d’informations sur les filtres dans les scénarios, consultez Ajouter un filtre à un scénario.

Utilisation de filtres avancés

Le module Workfront > Événements Espion propose deux types de filtres.

  • Simple : ce filtre fournit une interface qui vous permet de sélectionner des champs, des opérateurs et des valeurs, ainsi que des opérateurs ET et OU pour créer un filtre.
  • Avancé : ce filtre vous permet de télécharger un fichier JSON qui représente votre filtre.

Filtres simples ou avancés

La principale différence entre les deux types est l’état du filtre.

  • Simple : lors de la configuration d’un filtre simple, vous choisissez de filtrer selon l’ancien état ou le nouvel état d’un champ. En d’autres termes, vous décidez si vous souhaitez activer le scénario lorsque le champ passe de à une valeur donnée ou s’il faut l’activer lorsqu’il passe à à une valeur donnée. L’utilisation des opérateurs AND et OR permet d’inclure plusieurs champs et valeurs, mais ils doivent partager le même état. Vous ne pouvez pas utiliser l’ancien état pour certains champs et le nouvel état pour d’autres.
  • Avancé : vous pouvez configurer le fichier JSON dans un filtre avancé afin de spécifier des valeurs pour les anciens et les nouveaux états d’un même filtre. Par exemple, vous pouvez indiquer que vous souhaitez déclencher un scénario lorsqu’un projet passe d’un statut Planification à un statut Actuel. Cela exclurait les projets qui passent de Planification à Immobilisations ou qui passent de En attente à Actuels.
recommendation-more-help
workfront-fusion-help-workfront-fusion