Adobe Workfront modules

Dernière mise à jour : 2024-02-08
  • Créé pour :
  • User

Vous pouvez utiliser la variable Adobe Workfront Fusion Adobe Workfront connecteur pour automatiser vos processus dans Workfront. Si vous avez une Workfront Fusion pour l’automatisation et l’intégration du travail , vous pouvez également l’utiliser pour vous connecter à des applications et services tiers.

La variable Workfront Le connecteur ne compte pas par rapport au nombre d’applications actives disponibles pour votre organisation. Tous les scénarios, même s’ils utilisent uniquement la variable Workfront , ne comptez pas par rapport au nombre total de scénarios de votre entreprise.

Pour plus d’informations sur les applications et les scénarios disponibles de votre entreprise, voir Organisations in Adobe Workfront Fusion organisations et équipes.

Si vous avez besoin d’instructions sur la création d’un scénario, voir Créez un scénario dans Adobe Workfront Fusion. Pour plus d’informations sur les modules, voir Modules dans Adobe Workfront Fusion.

Exigences d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront plan*

Pro ou version ultérieure

Adobe Workfront license*

Plan, Work

Adobe Workfront Fusion license**

Exigences de licence actuelles : non Workfront Fusion conditions requises pour obtenir une licence.

Ou

Exigences de licence héritées : Workfront Fusion pour l’automatisation et l’intégration du travail, Workfront Fusion pour l’automatisation du travail

Produit

Conditions requises du produit actuel : si vous disposez de l’Select ou de l’Prime Adobe Workfront Planifiez, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans l’Ultimate Workfront planifiez.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître le plan, le type de licence ou l’accès dont vous disposez, contactez votre Workfront administrateur.

Pour plus d’informations sur Adobe Workfront Fusion licences, voir Adobe Workfront Fusion licences.

Connexion Workfront to Workfront Fusion

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

Vous pouvez créer une connexion à votre Workfront compte directement depuis l’intérieur d’un Workfront Fusion module .

  1. Dans n’importe quel Workfront module d’application, cliquez Ajouter en regard de Connexion de la boîte.

  2. Saisissez le nom de votre instance dans l’URL. Exemple : https://<your instance>.my.workfront.com.

  3. Cliquez sur Suivant.

  4. Cliquez sur Connexion SAML pour créer la connexion et revenir au module .

    Ou

    Saisissez votre nom d’utilisateur et votre mot de passe, puis cliquez sur Connexion pour créer la connexion et revenir au module .

    REMARQUE
    • Si vous ne voyez pas de bouton de connexion SAML, votre entreprise n’a pas activé l’authentification unique (SSO). Vous pouvez vous connecter à l’aide de vos nom d’utilisateur et mot de passe.

      Pour plus d’informations sur SSO, voir Présentation de la connexion unique Adobe Workfront

    • Connexions OAuth 2.0 à la Workfront L’API ne dépend plus des clés d’API.

Workfront modules et leurs champs

Lorsque vous configurez Workfront modules, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces Workfront peut 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 de mappage situé au-dessus d’un champ ou d’une fonction s’affiche, 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 dans Adobe Workfront Fusion.

REMARQUE

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.

Triggers

 Événements de contrôle

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 renvoie les champs standard associés à l’enregistrement, ainsi que les champs et valeurs personnalisés auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

  1. Cliquez sur Ajouter à droite du Webhook de la boîte.

  2. Configurez le webhook dans la variable Ajouter un crochet qui s’affiche.

    Lors de la configuration de ce module, les champs suivants s’affichent.

    Nom du webhook (Facultatif) Saisissez un nouveau nom pour le webhook.
    Connection

    Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

    Record Type Sélectionnez le type de Workfront enregistrement que vous souhaitez que le module regarde.
    State Indiquez si vous souhaitez consulter l’ancien état ou le nouvel état.
    • Nouvel état

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

      Par exemple, si l’état est défini sur Nouvel état et que le filtre est défini sur État Égal à En cours, le webhook déclenche un scénario lorsque l’État passe à En cours, quel que soit l’état antérieur.

    • Ancien état

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

      Par exemple, si l’état est défini sur Ancien état et que le filtre est défini sur État Égal À En cours, le webhook déclenche un scénario lorsqu’un État , qui est actuellement En cours passe à un autre état.

    Filtres Événements

    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 Workfront webhooks. Pour configurer différents filtres pour Workfront abonnements aux événements, supprimez le webhook actuel et créez-en un nouveau.

    Pour plus d’informations sur les filtres d’événements, voir Filtres d’abonnement aux événements dans Workfront > Modules Watch Events dans cet article.

    Exclure les événements effectué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, ce qui entraîne sa répétition dans une boucle sans fin.
    Record Origin

    Choisissez si vous souhaitez que le scénario soit regardé Nouveaux enregistrements uniquement, Enregistrements mis à jour uniquement, Enregistrements nouveaux et mis à jour, ou Deleted Records Only.

    Remarque : Si vous choisissez Enregistrements nouveaux et mis à jour, la création du webhook crée 2 abonnements d’événement (pour la même adresse webhook).

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

Pour plus d’informations, voir la section Exemples de payloads d’événement dans le Workfront Article d’aide API d’abonnement à un événement.

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

 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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Record Type

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

Par exemple, sélectionnez Tâche 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 Workfront a été configuré pour le suivi.
Sorties Sélectionnez les informations que vous souhaitez inclure dans le lot de sortie pour ce module.
Limite

Saisissez ou mappez le nombre maximum d'enregistrements que le module doit renvoyer pour chaque cycle d'exécution de scénario.

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

 Surveiller les enregistrements

Ce module de déclenchement 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 mapper 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 au cours de la période donnée sont renvoyés en tant que nouveaux enregistrements.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Filter

Choisissez si vous souhaitez que le scénario soit regardé Nouveaux enregistrements uniquement, Enregistrements mis à jour uniquement, ou Enregistrements nouveaux et mis à jour.

Record Type

(S’affiche une fois que vous avez sélectionné une Filtrer.) Sélectionnez le type de Workfront enregistrement que vous souhaitez que le module regarde.

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

Sorties

Sélectionnez les informations que vous souhaitez inclure dans le lot de sortie pour ce module.

Filtre facultatif

(Avancé) Saisissez une chaîne de code API pour définir des paramètres ou du code supplémentaires qui affineront vos critères.

Limite

Saisissez ou mappez le nombre maximum d'enregistrements que le module doit renvoyer pour chaque cycle d'exécution de scénario.

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

Actions

 Conversion, objet

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

  • Convertir le problème en projet
  • Convertir le problème en tâche
  • Convertir la tâche en projet
Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Type d’objet

Sélectionnez le type d’objet à convertir. Il s’agit du type dont dispose l’objet avant la conversion.

Convertir en 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’identifiant 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’identifiant approprié dans le champ .

ID de modèle

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’identifiant approprié dans le champ .

Formulaires personnalisés 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.

 Créer un enregistrement (joindre des formulaires personnalisés)

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

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

Vous pouvez utiliser ce module pour créer une tâche dans Workfront lorsqu’un client ajoute une nouvelle ligne dans une Google Sheets liste des tâches à effectuer.

Lors de la configuration de ce module, les champs suivants s’affichent.

Veillez à indiquer le nombre minimum de champs de saisie. Par exemple, si vous souhaitez créer un problème, vous devez fournir un ID de projet parent valide dans le champ ID de projet pour indiquer où le problème doit se trouver 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.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Record Type

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

Par exemple, si vous souhaitez créer un projet, sélectionnez Projet dans la liste déroulante, puis assurez-vous que vous avez accès aux données (des modules précédents dans le scénario) qui vont compléter le projet.

Sélectionner les champs à mapper

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.

Pour les champs des formulaires personnalisés, utilisez la méthode Joindre un formulaire personnalisé champ .

Joindre un formulaire personnalisé Sélectionnez les formulaires personnalisés à ajouter au nouvel objet, puis saisissez les valeurs de ces champs.

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

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’identifiant approprié dans le champ .

  • Lors de la saisie du texte d’un champ personnalisé ou d’une Remarque (Commentaire ou Réponse), vous pouvez utiliser des balises de HTML dans la variable Texte de la remarque pour créer du texte enrichi, comme du texte en gras ou en italique.

    Pour plus d’informations sur le texte enrichi dans les mises à jour, voir Ajouter une mise à jour à un élément de travail in Mise à jour du travail.

 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. Le module vous permet de sélectionner les champs de l’objet disponibles dans le module .

Vous spécifiez l’identifiant de l’enregistrement.

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

Vous pouvez utiliser ce module pour créer une tâche dans Workfront lorsqu’un client ajoute une nouvelle ligne dans une liste de tâches à effectuer dans une feuille de calcul Google.

Lors de la configuration de ce module, les champs suivants s’affichent.

Veillez à indiquer le nombre minimum de champs de saisie. Par exemple, si vous souhaitez créer un problème, vous devez fournir un ID de projet parent valide dans le champ ID de projet pour indiquer où le problème doit se trouver 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.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Record Type

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

Par exemple, si vous souhaitez créer un projet, sélectionnez Projet dans la liste déroulante, puis assurez-vous que vous avez accès aux données (des modules précédents dans le scénario) qui vont compléter le projet.

Sélectionner les champs à mapper 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 la liste des Workfront types d’objets pour lesquels vous pouvez utiliser ce module dans Workfront types d’objet disponibles pour chaque Workfront module.

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’identifiant approprié dans le champ .

  • Lors de la saisie du texte d’un champ personnalisé ou d’une Remarque (Commentaire ou Réponse), vous pouvez utiliser des balises de HTML dans la variable Texte de la remarque pour créer du texte enrichi, comme du texte en gras ou en italique.

    Pour plus d’informations sur le texte enrichi dans les mises à jour, voir Ajouter une mise à jour à un élément de travail in Mise à jour du travail.

 Appel API personnalisé

Ce module d’action vous permet d’effectuer un appel authentifié personnalisé vers le Workfront API. Ainsi, vous pouvez créer une automatisation du flux de données qui ne peut pas être réalisée par l’autre Workfront modules.

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 demande de GET, sont contenues dans cet objet.

Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

URL

Saisissez un chemin relatif à https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.

Version de l’API Sélectionnez la version de la Workfront API que vous souhaitez que le module utilise.
Méthode

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, envisagez de modifier les en-têtes en fonction de la variable Workfront la documentation. Si votre appel API personnalisé renvoie une erreur de requête HTTP 422, essayez d’utiliser une "Content-Type":"text/plain" en-tête .

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.

Remarque :

Lors de l’utilisation d’instructions conditionnelles telles que if dans votre fichier JSON, placez les guillemets en dehors de l’instruction conditionnelle.

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

 Supprimer l’enregistrement

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

Vous spécifiez l’identifiant de l’enregistrement.

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

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Forcer la suppression Activez cette option pour vous assurer que l’enregistrement est supprimé, même si la variable Workfront L’interface utilisateur demande la confirmation de la suppression.
ID

Saisissez l’unique Workfront Identifiant de l’enregistrement que vous souhaitez supprimer du module.

Pour obtenir l’identifiant, ouvrez le 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 de Workfront enregistrement que vous souhaitez supprimer du module.

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

REMARQUE

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. Supprimer 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’attente de 40 secondes.
 Télécharger le document

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

Vous spécifiez l’identifiant de l’enregistrement.

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

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

ID du document

Faire correspondre ou saisir manuellement l’unique Workfront ID du document que vous souhaitez que le module télécharge.

Pour obtenir l’identifiant, ouvrez le 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 Workfront types d’objets pour lesquels vous pouvez utiliser ce module dans Workfront types d’objet disponibles pour chaque Workfront module.

 Diverses actions

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

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Record Type

Sélectionnez le type de Workfront enregistrement avec lequel vous souhaitez que le module interagisse.

Action

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

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

Pour plus d’informations sur les champs individuels, voir Documentation destinée aux développeurs Workfront.

Remarque: le site de documentation destinée aux développeurs contient des informations uniquement via la version 14 de l’API, mais contient toujours des informations précieuses pour les appels API.

  1. Sélectionnez le type d’enregistrement dans le volet de navigation de gauche du Workfront page de documentation destinée aux développeurs. Les types suivants possèdent leurs propres pages :

    • Projects

    • Tâches

    • Issues

    • Utilisateurs

    • Documents

    Pour tous les autres types d’enregistrement, sélectionnez Autres objets et points de finet 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.

Remarque :

Lors de la création d’un BAT via Workfront module Divers actes, la bonne pratique consiste à créer un BAT sans options avancées, puis à le mettre à jour à l’aide de la fonction Workfront Proof API SOAP.

Pour plus d’informations sur la création d’un BAT avec la variable Workfront API (que ce module utilise), voir Ajoutez des options de vérification avancées lors de la création d’un BAT via la fonction Adobe Workfront API

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

Pour obtenir l’identifiant, ouvrez le 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 Workfront types d’objets pour lesquels vous pouvez utiliser ce module dans Workfront types d’objet disponibles pour chaque Workfront module.

 Lire un enregistrement

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

Vous spécifiez l’identifiant 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 standard pour la sortie que vous avez spécifiée.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Record Type Choisissez la Workfront type d’objet que le module doit lire.
Sorties

Sélectionnez les informations que vous souhaitez inclure dans le lot de sortie pour ce module.

Références 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’unique Workfront Identifiant de l’enregistrement que vous souhaitez que le module lise.

Pour obtenir l’identifiant, ouvrez le 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 Workfront types d’objets pour lesquels vous pouvez utiliser ce module dans Workfront types d’objet disponibles pour chaque Workfront module.

 Mettre à jour l’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 spécifiez l’identifiant de l’enregistrement.

Le module renvoie l’identifiant 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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

ID

Saisissez l’unique Workfront Identifiant de l’enregistrement que vous souhaitez que le module soit mis à jour.

Pour obtenir l’identifiant, ouvrez le 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 de Workfront enregistrement que vous souhaitez que le module soit mis à 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.

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

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’identifiant approprié dans le champ .

  • Lors de la saisie du texte d’un champ personnalisé ou d’une Remarque (Commentaire ou Réponse), vous pouvez utiliser des balises de HTML dans la variable Texte de la remarque pour créer du texte enrichi, comme du texte en gras ou en italique.

    Pour plus d’informations sur le texte enrichi dans les mises à jour, voir Ajouter une mise à jour à un élément de travail in Mise à jour du travail.

 Télécharger le document

Ce module d’action télécharge un document vers un Workfront (projet, tâche ou problème, par exemple).

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

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

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Identifiant d’enregistrement associé Saisissez l’unique Workfront ID de l’enregistrement auquel vous souhaitez charger le document.
Related Record Type Sélectionnez le type de Workfront enregistrement de l’emplacement où vous souhaitez que le module charge le document.
Fichier source

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

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 que vous souhaitez inclure dans la sortie. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to 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 Workfront types d’objets pour lesquels vous pouvez utiliser ce module dans Workfront types d’objet disponibles pour chaque Workfront module 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’identifiant, ouvrez le 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 vous souhaitez que le module lise.
Sorties

Sélectionnez les informations que vous souhaitez inclure dans le lot de sortie pour ce module.

 Rechercher

Ce module de recherche recherche recherche des enregistrements dans un objet de la section Workfront qui correspondent à la requête de recherche que vous spécifiez.

Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de ce module, les champs suivants s’affichent.

Connection

Pour obtenir des instructions sur la connexion à Workfront app to Workfront Fusion, voir Connexion Workfront to Workfront Fusion dans cet article.

Record Type

Sélectionnez le type de Workfront enregistrement 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 qui correspondent.
Maximal

Saisissez ou mappez le nombre maximum d'enregistrements que le module doit renvoyer pour chaque cycle d'exécution de scénario.

Critères de recherche

Renseignez le champ par 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.

Remarque : Ne pas utiliser username dans vos critères de recherche. Inclusion username dans une requête API à Workfront connecte l’utilisateur à Workfront, et la recherche échoue.

Remarque : In et NotInfonctionne avec des tableaux. Les entrées doivent être au format de tableau.

Sorties

Sélectionnez les champs que vous souhaitez inclure dans la sortie de ce module.

Références Sélectionnez les champs de référence à inclure dans la recherche.
Collections Sélectionnez les collections à ajouter à la recherche.

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

Workfront types d’objet disponibles pour chaque Workfront module

 Types d’objet disponibles pour chaque Workfront module déclencheur
Enregistrement de contrôle Champ de contrôle Événements de contrôle
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
Durée réservée*
Rapport
Risque
Type de risque
Approbateur 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 Workfront module d'action
REMARQUE

La variable Télécharger le document n’est pas inclus dans ce tableau, car Workfront les types d’objets ne font pas partie de sa configuration.

Créer un enregistrement Mettre à jour un enregistrement Supprimer un enregistrement Télécharger le document Lire un enregistrement Appel API personnalisé Diverses actions
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
Durée réservée*
Risque
Type de risque
Approbateur 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 Workfront module de recherche
Search Lire les enregistrements associés
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
Durée réservée*
Risque
Type de risque
Approbateur 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 Workfront > Événements de contrôle modules

REMARQUE

Il est vivement recommandé d’utiliser des filtres d’abonnement aux événements dans votre Événements de contrôle modules.

La variable Workfront Événements de contrôle déclenche des scénarios basés sur un webhook qui crée un abonnement à un événement dans la variable Workfront API. L’abonnement à l’événement est un ensemble de données qui détermine les événements envoyés au webhook. Par exemple, si vous configurez une Événements de contrôle qui recherche les problèmes, puis 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 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 la variable Workfront API pour envoyer uniquement les problèmes qui se trouvent dans un projet spécifique au webhook, en veillant à ce que la variable Événements de contrôle 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 la variable 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 > Evénements de contrôle :

  • Est égal à
  • Non égal à
  • Supérieur à
  • Inférieur à
  • Supérieur ou égal à
  • 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 Etat .
    • Lorsque vous utilisez Changed, sélectionnez Événements mis à jour uniquement dans le Origine de l’enregistrement champ .
IMPORTANT

Vous ne pouvez pas modifier les filtres dans les Workfront webhooks. Pour configurer différents filtres pour Workfront abonnements aux événements, supprimez le webhook actuel et créez-en un nouveau.

INFO

Exemple : Supposons que vous envisagiez de traiter de nouveaux problèmes affectés à un utilisateur spécifique, Ana.

Filtrage des événements à l’aide d’un filtre d’abonnement aux événements (recommandé)

À l’aide du filtre d’événement, vous pouvez configurer le webhook pour déclencher le scénario lorsqu’un problème est affecté à Ana lors de la création du problème. Ana a l’ID utilisateur b378489d8f7cd3cee0539260720a84b7.

Si 100 problèmes sont créés en un jour, mais que deux d’entre eux seulement sont affectés à Ana, le scénario s’exécute deux fois.

Filtrage des événements dans le scénario (non recommandé)

Pour filtrer les événements de sorte que seuls les problèmes affectés à Ana soient traités, vous pouvez créer un filtre après l’événement Événements de contrôle module .

Si 100 problèmes sont créés en un jour, mais que seuls deux d’entre eux sont affectés à Ana, le scénario s’exécute 100 fois. 98 des exécutions s’arrêteraient au filtre, mais le module déclencheur consomme toujours des données et effectue des opérations dans toutes les exécutions.

Pour plus d’informations sur les abonnements aux événements, voir Questions fréquentes - Abonnements à un événement.

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 Ajoutez un filtre à un scénario dans Adobe Workfront Fusion.

Sur cette page