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

Standard

Travail ou supérieur

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

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.

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.

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.

• Déclencheurs
• Actions
• Recherches

Déclencheurs

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.

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.

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.

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.

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.

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.

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

• Valider les utilisateurs et utilisatrices individuels

  code language-none
  Vous pouvez valider des utilisateurs et utilisatrices individuels dans la liste Utilisateurs et utilisatrices.

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

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

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.

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.

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

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.

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

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.

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

• clearApprovers

• clearAssignments

• clearConstraints

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  Effacer les données financières

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Effacer les notifications de rappel

• clearApprovers

• clearAssignments

• clearDocuments

• clearConstraints

• clearExpenses

• clearFinancials

  Effacer les données financières

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Effacer les notifications de rappel

• clearApprovers
• clearAssignments
• clearCustomData
• clearDocuments
• clearPermissions
• clearProgress

• 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

• 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

• clearApprovers

• clearAssignments

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  Effacer les données financières

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Effacer les notifications de rappel

• 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

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

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

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.

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.

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

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.

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.