Modules Adobe Workfront

Vous pouvez utiliser le connecteur Adobe Workfront Fusion 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 d’article. 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.

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ée : n’importe laquelle.

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.

note note
NOTE
  • Si votre entreprise utilise l’ancien package de licence (basé sur les connecteurs), elle doit disposer d’une licence Workfront Fusion for Work Automation and Integration pour se connecter à des applications et services tiers. Le connecteur Workfront n’est pas comptabilisé par rapport au nombre d’applications actives disponibles pour votre organisation. Tous les scénarios, même s’ils utilisent uniquement l’application Workfront, sont comptés par rapport au nombre total de scénarios de votre organisation.

Connexion de Workfront à Workfront Fusion

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

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

  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 layout-auto html-authored no-header
    Connection name Saisissez un nom pour la nouvelle connexion.
    Environment Indiquez si vous vous connectez à un environnement de production ou hors production.
    Connection type Indiquez si vous vous connectez à un compte de service ou à un compte personnel.
    Client ID Saisissez votre identifiant client Workfront. Vous pouvez le trouver dans la zone Applications OAuth2 de la configuration de Workfront. Ouvrez l’application spécifique à laquelle vous vous connectez pour afficher l’ID client.
    Client Secret Saisissez votre identifiant client Workfront. Vous pouvez le trouver dans la zone Applications OAuth2 de la configuration de 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 plus d’informations, 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 Continue pour enregistrer la connexion et revenir au module .

    Si vous n’êtes pas connecté à Workfront, vous êtes redirigé vers un écran de connexion. Après vous être connecté, 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 Workfront Sandbox, 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 votre connexion.

Modules Workfront 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

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

Watch Events

Ce module déclencheur 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 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.

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

  2. Configurez le webhook dans la zone de Add a 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 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, voir Connexion de Workfront à Workfront Fusion dans cet article.
    Record Type Sélectionnez le type d’enregistrement Workfront que vous souhaitez que le module regarde.
    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 l’Status passe à In Progress, quel que soit l’état précédent.

    • 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 actuellement In Progress passe à un autre état.

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

    REMARQUE : le type d'enregistrement Affectation n'inclut pas cette option.

    Record Origin

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

    REMARQUE : si vous choisissez New and Updated Records, la création du webhook crée 2 abonnements aux événements (pour la même adresse webhook).

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 une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Watch Field

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 spécifié. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement Workfront que vous souhaitez que le module regarde.

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 les champs que votre administrateur Workfront a configurés pour le suivi.
Outputs Sélectionnez les champs d’objet à inclure dans le lot 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 une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Watch Record

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.

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 Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Filter Choisissez si vous souhaitez que le scénario regarde New Records Only, Updated Records Only ou New and Updated Records.
Record Type

Sélectionnez le type d’enregistrement Workfront que vous souhaitez que le module regarde.

Par exemple, si vous souhaitez démarrer le scénario à chaque création d’un projet, sélectionnez Project

Outputs Sélectionnez les champs à inclure dans le lot de sortie pour ce module.
Reference Sélectionnez les champs de référence à inclure dans le lot de sortie pour ce module.
Outputs Sélectionnez les champs de collection à inclure dans le lot 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 une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Actions

Convert object

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 note
NOTE
Depuis juillet 2024, les formulaires personnalisés peuvent être inclus lors de la conversion d’un objet.
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
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir 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.
Create a record (attaching custom forms)

Ce module d’action crée un objet, tel qu’un projet, une tâche ou un événement 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.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement Workfront que vous souhaitez que le module crée.

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 utiliser ces champs sans avoir à faire défiler ceux dont vous n’avez pas besoin. 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, puis saisissez ou mappez des valeurs pour ces champs.

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

note note
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 d’HTML dans le champ Note Text pour créer du texte enrichi, tel que du texte en gras ou en italique.
Create Record

Ce module d’action crée un objet, tel qu’un projet, une tâche ou un problème dans Workfront. 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.

Ce module ne joint pas de formulaires personnalisés lors de la création de l’objet . Pour joindre des formulaires personnalisés lors de la création d’un objet, utilisez le module Create a record (attaching custom forms) .

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

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Record Type

Sélectionnez le type d’enregistrement Workfront que vous souhaitez que le module crée.

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 utiliser ces champs sans avoir à faire défiler ceux dont vous n’avez pas besoin.

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

note note
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 d’HTML dans le champ Note Text pour créer du texte enrichi, tel que du texte en gras ou en italique.
Custom API Call

Ce module d’action vous permet d’effectuer un appel authentifié personnalisé vers l’API Workfront. De cette façon, vous pouvez automatiser les flux de données, ce que ne peuvent pas faire les autres modules de Workfront.

Le module renvoie les informations suivantes :

  • Status Code (nombre) : indique le succès ou l’échec de votre requête HTTP. Ce sont des codes standard que vous pouvez consulter sur Internet.

  • Headers (objet) : contexte plus détaillé pour le code de réponse/statut qui n’est pas lié 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.

  • Body (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.

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 Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de 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 le module doit utiliser.
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 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"}

Remarque : si vous obtenez des erreurs et qu’il est difficile de déterminer leur origine, pensez à modifier les en-têtes en vous basant sur la documentation de 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 une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Delete Record

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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Force delete Activez cette option pour vous assurer que l’enregistrement est supprimé, même si l’interface utilisateur de Workfront demande confirmation de la suppression.
Async delete Activez cette option pour permettre au module d’effectuer une suppression asynchrone.
ID

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

Pour obtenir l’identifiant, 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 vous souhaitez que le module supprime.

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

note note
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.
Download 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.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de 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’identifiant, 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 une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Misc Action

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

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

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Record Type Sélectionnez le type d’enregistrement Workfront avec lequel vous souhaitez que le module interagisse.
Action

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

Il se peut que vous deviez remplir d’autres champs, selon la Record Type et la Action que vous avez choisies. 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 Attach Template pour le Action) nécessitent des informations supplémentaires (telles qu’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 de 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 destinée aux développeurs 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 dans 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 :

Lors de la création d’une épreuve par le biais du module de Misc Action Workfront, il est recommandé de créer une épreuve sans option avancée, puis de la mettre à jour à l’aide de l’API SOAP Workfront Proof.

Pour plus d'informations sur la création d'un BAT avec l'API Workfront (que ce module utilise), voir Ajouter des options de relecture avancée lors de la création d'un BAT via l'API Adobe Workfront

ID

Saisissez ou mappez l’ID Workfront unique de l’enregistrement avec lequel vous souhaitez que le module interagisse.

Pour obtenir l’identifiant, 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 une 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
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Action Options
Copier
  • clearApprovers

  • clearAssignments

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Efface les données financières

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Efface les notifications de rappel

Déplacer
  • clearApprovers

  • clearAssignments

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    Efface les données financières

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Efface les notifications de rappel

Problème
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored
Action Options
Copier
  • clearApprovers
  • clearAssignments
  • clearCustomData
  • clearDocuments
  • clearPermissions
  • clearProgress
Convertir en une tâche
  • preserveIssue

    Conserver l'événement d'origine et lier sa résolution à cette tâche

  • preservePrimaryContact

    Autoriser le créateur de l'événement à accéder à cette tâche

  • preserveCompletionDate

    Conserver la date d'achèvement prévue pour l'événement

Convertir en projet
  • preserveIssue

    Conserver l'événement d'origine et lier sa résolution à cette tâche

  • preservePrimaryContact

    Autoriser le créateur de l'événement à accéder à cette tâche

Projet
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Action Options
Copier
  • clearApprovers

  • clearAssignments

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Efface les données financières

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Efface les notifications de rappel

Joindre un modèle / Enregistrer comme modèle
  • clearApprovers

  • clearAssignments

  • clearBillingRates

  • clearConstraints

  • clearDeliverables

    Efface les objectifs

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Efface les données financières

  • clearHourTypes

  • clearIssueSetup

    Efface les propriétés de file d'attente et la configuration des événements

  • clearPredecessors

  • clearRisks

  • clearSharingOptions

  • clearTimedNotifications

    Efface les notifications de rappel

Read a Record

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.

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 plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de 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.
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’identifiant, 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 une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Update Record

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.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir 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’identifiant, 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 utiliser ces champs sans avoir à faire défiler ceux dont vous n’avez pas besoin. Vous pouvez ensuite saisir ou mapper des données dans ces champs.

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

note note
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 d’HTML dans le champ Note Text pour créer du texte enrichi, tel que du texte en gras ou en italique.
Upload Document

Ce module d'action charge un document dans un objet Workfront, tel qu'un projet, une tâche ou un événement. 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é vers les 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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Related Record ID Saisissez l’ID Workfront unique de l’enregistrement dans lequel vous souhaitez charger le document.
Related Record Type Sélectionnez le type d’enregistrement Workfront sur lequel vous souhaitez que le module charge 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 une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Upload Document (Legacy)

Ce module d'action charge un document dans un objet Workfront, tel qu'un projet, une tâche ou un événement. Il télécharge l’intégralité du document en une seule fois.

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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Related Record ID Saisissez l’ID Workfront unique de l’enregistrement dans lequel vous souhaitez charger le document.
Related Record Type Sélectionnez le type d’enregistrement Workfront sur lequel vous souhaitez que le module charge 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 une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Recherches

Read Related Records

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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de 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 dans cet article une liste des types d’objets Workfront pour lesquels vous pouvez utiliser ce module dans Types d’objets Workfront disponibles pour chaque module Workfront.

Parent Record ID

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

Pour obtenir l’identifiant, 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.
Search

Ce module de recherche recherche les enregistrements dans un objet de Workfront qui correspondent à 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.

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
Connection Pour plus d’informations sur la connexion de votre application Workfront à Workfront Fusion, voir Connexion de Workfront à Workfront Fusion dans cet article.
Record Type Sélectionnez le type d’enregistrement Workfront que vous souhaitez que le module recherche.
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 la mention username dans une requête d’API vers Workfront connecte l’utilisateur à 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’objets Workfront disponibles pour chaque module Workfront

Types d’objet disponibles pour chaque module de déclenchement Workfront
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 layout-auto
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 note
NOTE
Le module Download Document n’est pas inclus dans ce tableau, car les types d’objets Workfront ne font pas partie de sa configuration.
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 18-row-8 19-row-8 20-row-8 21-row-8 22-row-8 23-row-8 24-row-8 25-row-8 26-row-8 27-row-8 28-row-8 29-row-8 30-row-8 31-row-8 32-row-8 33-row-8 34-row-8 35-row-8 36-row-8 37-row-8 38-row-8 39-row-8 layout-auto
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
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 35-row-3 36-row-3 layout-auto
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 > Watch Events

NOTE
Nous vous recommandons vivement d’utiliser des filtres d’abonnement aux événements dans vos modules Watch Events.

Le module Watch Events de Workfront déclenche des scénarios basés sur un webhook qui crée un abonnement aux événements 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 Watch Events qui surveille les problèmes, l’abonnement aux événements 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 envoyer au webhook uniquement les problèmes qui se trouvent dans un projet spécifique, en veillant à ce que le module Watch Events ne se déclenche 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 actif et créez-en un.
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é) filtrer-les-%C3%A9v%C3%A9nements-%C3%A0-l%E2%80%99aide-d%E2%80%99un-filtre-d%E2%80%99abonnement-aux-%C3%A9v%C3%A9nements-(recommand%C3%A9)

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.
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é) filtrer-les-%C3%A9v%C3%A9nements-au-sein-du-sc%C3%A9nario-(non-recommand%C3%A9)

Pour filtrer les événements afin que seuls les événements affectés à Ana soient traités, vous pouvez créer un filtre après le module Watch Events.
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, voir FAQ - Abonnements aux événements.

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

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

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