Modules Workfront Proof

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Workfront Proof et le connecter à plusieurs applications et services tiers.

Cette fonction est utile si vous devez exécuter des tâches qui ne sont actuellement pas prises en charge dans le cadre de la relecture dans Workfront ou Workfront Proof, telles que la mise à jour des épreuves en fonction de certains événements et la recherche des destinataires d’une épreuve.

Le connecteur vers Workfront Proof n’est pas pris en compte dans le nombre d’applications actives disponibles pour votre entreprise. Tous les scénarios, même s’ils n’utilisent que l’application Workfront Proof, sont comptabilisés dans le nombre total de scénarios de votre entreprise.

Si vous avez besoin d’instructions sur la création d’un scénario, voir Créer un scénario dans Adobe Workfront Fusion.

Pour plus d’informations sur les modules, voir Modules dans Adobe Workfront Fusion.

Conditions d’accès

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

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences en matière de licences héritées : Workfront Fusion for Work Automation and Integration, Workfront Fusion for Work Automation

Produit

Exigences actuelles du produit : si vous avez le plan Select ou Prime Adobe Workfront, 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 la formule Workfront Ultimate.

Ou

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

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.

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

Informations sur Workfront Proof

Le connecteur Workfront Proof utilise les éléments suivants :

Version de l’API
v21.3.0
Balise API
v1.8.92

Connecter Workfront Proof à Workfront Fusion

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

  1. Dans n’importe quel module Workfront Fusion, cliquez sur Ajouter à côté 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 name Saisir le nom de la connexion
    connections.environmentType Sélectionnez s’il s’agit d’un environnement de production ou d’un environnement de non-production tel que Prévisualisation ou Sandbox.
    connections.authenticationType Sélectionnez s’il s’agit d’un compte de service ou d’un compte personnel.
    Email / Username Saisissez le nom d’utilisateur ou d’utilisatrice de votre compte Workfront Proof.
    Password Saisissez le mot de passe de votre compte Workfront Proof.
    Tenant ID

    Remarque  : les clientes et clients qui n’utilisent pas BYOK doivent laisser ce champ vide.

    Saisissez l’identifiant du locataire pour ce compte. Si vous avez besoin d’aide pour trouver votre identifiant de locataire, contactez le service clientèle de Workfront.

    Domain Extension

    Saisissez l’extension de l’URL que vous utilisez pour accéder à votre compte.

    Exemple : com ou eu

    Production, Preview, or Custom Environment Sélectionnez une connexion à un environnement de production, de prévisualisation ou personnalisé.
  3. Cliquez sur Continuer pour enregistrer la connexion et revenir au module.

Les modules Workfront Proof et leurs champs

Lorsque vous configurez les modules Workfront Proof, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Workfront Proof supplémentaires 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 Mapper des informations d’un module à l’autre dans Adobe Workfront Fusion.

Déclencheurs

Regarder les épreuves

Ce module de déclenchement planifié exécute un scénario lorsque quelqu’un crée ou prend une décision sur une épreuve.

Le module renvoie une liste de tous les enregistrements trouvés au cours de la période spécifiée avec leur type. Il renvoie également les valeurs des champs que vous avez spécifiés. Si le module a trouvé des décisions prises sur l’épreuve, il inclut à la fois la valeur précédente et la valeur actuelle dans des champs séparés. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Cela se produit à un intervalle planifié régulier que vous spécifiez.

Vous devez disposer des autorisations nécessaires pour accéder à la ou aux épreuves dans Workfront Proof afin de pouvoir récupérer ces informations.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Type d’enregistrement
Sélectionnez le type d’enregistrement Workfront Proof que vous voulez que le module regarde.
Sorties
Sélectionnez les informations que vous souhaitez inclure dans le bundle 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 du scénario.

Regarder le résumé PDF

Ce module de déclenchement instantané exécute un scénario lorsque quelqu’un crée un résumé PDF pour une épreuve.

Un webhook est nécessaire pour ce module.

Le module renvoie tous les champs standard associés à l’épreuve, ainsi que tous les champs et valeurs personnalisés auxquels la connexion a accès. Il crée également un nouvel abonnement aux événements pour les résumés PDF et génère le contenu de l’attribut « pdf_url » envoyé dans la payload. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Webhook
Vous pouvez sélectionner un webhook existant ou en créer un nouveau. Pour plus d’informations, voir Déclencheurs instantanés (webhooks) sur Adobe Workfront Fusion.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Regarder l’activité d’une épreuve

Ce module de déclenchement exécute un scénario lorsqu’une activité spécifiée se produit sur une épreuve.

Le module renvoie tous les champs standard associés à l’épreuve, ainsi que tous les champs et valeurs personnalisés auxquels la connexion a accès. Il crée également un nouvel abonnement aux événements pour les résumés PDF et génère le contenu de l’attribut pdf_url envoyé dans la payload. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Activity type
Sélectionnez si vous souhaitez regarder toute nouvelle décision (y compris les changements de statut de l’proof ou uniquement les changements de statut de l’épreuve dans son ensemble.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Actions

Créer une épreuve

Ce module d’action crée une nouvelle épreuve ou une nouvelle version d’une épreuve dans Workfront Proof.

Vous spécifiez les paramètres de la nouvelle épreuve et de l’épreuve source si vous créez une nouvelle version.

Le module renvoie l’ID de la nouvelle épreuve ou de la nouvelle version de l’épreuve. Vous pouvez mapper cette information dans les modules suivants du scénario.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Proof Type

Indiquez si vous souhaitez que l’épreuve créée ait un workflow de base ou un Automated Workflow.

Remplissez ensuite les champs qui s’affichent pour le type d’épreuve que vous avez choisi. Par exemple, si vous avez choisi Automated Workflow, remplissez le champ Workflow Stages pour configurer les étapes.

Allow original file to be downloaded
Indiquez si vous souhaitez autoriser le téléchargement du fichier original à partir duquel l’épreuve a été créée.
Classic Proof Viewer
Indiquez si vous utilisez la visionneuse d’épreuve classique.
Combine all files into single proof
Activez cette option pour combiner tous les fichiers en une seule épreuve multipage.
Create a new proof version
Sélectionnez cette option si vous souhaitez que le module crée une nouvelle version d’une épreuve existante. Ensuite, dans le champ Existing Proof ID qui s’affiche, mappez ou saisissez l’identifiant unique de l’épreuve.
Custom Link Label
Saisissez ou mappez un libellé pour le lien d’épreuve personnalisé.
Custom Link URL
Saisissez ou mappez l’URL du lien personnalisé.
Default email notifications for subscribers

Saisissez l’un des nombres suivants pour indiquer les paramètres de notification par e-mail par défaut que vous souhaitez utiliser pour l’épreuve créée.

  • 1 - Tous les nouveaux commentaires et réponses
  • 2 - Réponses à mes commentaires
  • 3 - Résumé quotidien
  • 4 - Résumé horaire
  • 5 - Décisions uniquement
  • 9 - Désactivé
Disable Excel Summary
Indiquez si vous souhaitez désactiver la possibilité de télécharger les commentaires d’épreuves vers un fichier Excel.
Disable PDF Summary
Indiquez si vous souhaitez désactiver la possibilité de télécharger les commentaires d’épreuves vers un fichier PDF.
Disable Subscription Email
Indiquez si vous souhaitez désactiver l’e-mail d’abonnement pour cette épreuve.
Enable Embed Player
Indiquez si vous souhaitez activer le lecteur incorporé pour cette épreuve.
Enable Subscriptions
Indiquez si les personnes qui ne sont pas inscrites sont autorisées à s’abonner à l’épreuve.
Si vous sélectionnez cette option, vous pouvez également sélectionner le rôle par défaut des personnes abonnées, comme décrit dans ce tableau.
Enable Subscriptions Validation
Indiquez si vous souhaitez activer la validation d’abonnement par e-mail. Si cette option est activée, la personne abonnée doit cliquer sur un lien dans un e-mail pour accéder à une épreuve.
Enable Team URL
Choisissez si vous voulez que l’épreuve créée masque ou affiche l’URL de l’équipe.
File Hash ou File Hashes
Ajoutez l’identifiant du ou des fichiers que vous souhaitez utiliser pour créer une ou plusieurs épreuves.
File Names
Ajoutez le ou les noms de fichiers pour l’épreuve créée. Ce champ est obligatoire.
Lock proof when all required decisions are made
Indiquez si vous souhaitez que l’épreuve créée soit verrouillée une fois que toutes les décisions requises ont été prises.
Notify recipients about this proof
Sélectionnez une option pour indiquer si vous voulez informer les personnes destinataires de la création de l’épreuve.>
Proof name
Saisissez un nom pour l’épreuve créée. Ce champ est obligatoire. Utilisez le symbole barre verticale (|) pour séparer les noms des différentes épreuves.
Proof owner ID
Saisisez ou mappez l’indentifiant de la personne propriétaire de l’épreuve. Si ce champ n’est pas renseigné, la personne actuelle est propriétaire de l’épreuve.
Reference ID
Saisissez l’identifiant de référence de l’épreuve.
Require electronic signature
Indiquez si vous souhaitez demander une signature électronique à toute personne prenant une décision sur une épreuve.
Require login

Indiquez si vous souhaitez utiliser l’option de connexion obligatoire pour l’épreuve créée.

Ce paramètre est identique au paramètre Login Required expliqué à l’adresse Configure Proof Settings dans Workfront Proof.

Resolution ID
Saisissez l’identifiant de la résolution que vous souhaitez utiliser pour votre épreuve. Pour une liste des identifiants de résolution, consultez la documentation de l’API Workfront Proof.
SWF
Saisissez le type d’épreuve SWF.
Show [item]
Indiquez si vous souhaitez afficher chaque élément dans l’épreuve.
Workspace ID
Saisissez l’identifiant de l’espace de travail dans lequel vous souhaitez créer l’épreuve.
Recipients
Ajoutez les adresses e-mail des personnes à qui vous souhaitez affecter l’épreuve créée.
Deadline

Indiquez la date d’échéance pour la relecture de l’épreuve créée. Utilisez le format de date suivant :

YYYY-MM-DD hh:mm

Appel API personnalisé

Ce module d’action vous permet d’effectuer un appel personnalisé et authentifié à l’API Workfront Proof. Vous pouvez ainsi, automatiser le flux de données d’une façon que les autres modules Workfront Proof ne permettent pas.

Le module renvoie le code d’état, les en-têtes et le corps du texte. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Method
Définissez l’action pour l’appel API. Pour connaître les actions disponibles, voir la documentation de l’API Workfront Proof.
Body (XML)

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, mettez les guillemets à l’extérieur de l’instruction conditionnelle.

INFO
Exemple :

Télécharger l’épreuve

Ce module d’action télécharge le fichier source d’une épreuve particulière que vous identifiez à l’aide de son ID.

Vous indiquez l’ID de l’épreuve.

Le module renvoie le contenu du fichier source utilisé pour créer l’épreuve. Vous pouvez mapper cette information dans les modules suivants du scénario.

Vous devez disposer des autorisations nécessaires pour accéder à l’enregistrement dans Workfront Proof afin de pouvoir récupérer ces informations.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Proof ID
Saisissez l’ID unique de l’épreuve qui se trouve sur la page Proof Details. Pour plus d’informations, voir Gérer les détails de l’épreuve dans Workfront Proof.

Lire un enregistrement

Ce module d’action lit les données d’une seule épreuve dans Workfront Proof.

Vous indiquez l’ID de l’épreuve et les informations que vous souhaitez obtenir de l’épreuve.

Le module renvoie les valeurs des champs que vous avez choisis pour l’épreuve, ainsi que leurs types. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Vous devez disposer d’autorisations suffisantes pour accéder à l’enregistrement dans Workfront Proof afin de pouvoir récupérer ces informations.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Record Type
Indiquez si vous souhaitez lire une épreuve, les commentaires d’une épreuve ou les réviseurs ou réviseuses d’une épreuve.
Outputs
Sélectionnez les informations que vous souhaitez inclure dans le bundle de sortie pour ce module.
ID
Saisissez ou mappez l’ID unique Workfront Proof de l’enregistrement que vous souhaitez que le module lise.

Demander le résumé PDF

Ce module d’action demande le résumé PDF d’une épreuve particulière dans Workfront Proof.

Vous indiquez l’ID de l’épreuve.

Le module renvoie les informations du résumé PDF. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Vous devez disposer d’autorisations suffisantes pour accéder à l’enregistrement dans Workfront Proof afin de pouvoir récupérer ces informations.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Proof ID
Saisissez l’ID unique Workfront Proof de l’épreuve pour laquelle vous souhaitez demander un résumé PDF.
Callback URL
Saisissez ou mappez l’URL où vous souhaitez que le résumé PDF soit envoyé.
Erreur possible
  • Erreur  : « Vous n’avez pas les privilèges nécessaires pour effectuer cette demande. L’étape doit contenir au moins une personne destinataire. »
  • Solution  : assurez-vous que vous n’êtes pas la seule personne affectée aux étapes du workflow. Une autre personne doit être affectée aux étapes du workflow.

Mettre à jour l’épreuve

Ce module d’action met à jour une épreuve existante dans Workfront Proof.

Vous indiquez l’identifiant de l’épreuve et le type d’enregistrement, ainsi que les champs que vous souhaitez inclure dans la sortie.

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.

Vous devez disposer d’autorisations suffisantes pour accéder à l’enregistrement dans Workfront Proof afin de pouvoir récupérer ces informations.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Proof ID
Saisissez l’ID unique de l’épreuve qui se trouve sur la page Proof Details. Pour plus d’informations, voir Gérer les détails de l’épreuve dans Workfront Proof.
Deadline

Indiquez la date d’échéance pour la relecture de l’épreuve créée. Utilisez le format de date suivant :

YYYY-MM-DD hh:mm

Default email notifications for subscribers

Sélectionnez l’un des paramètres de notification par e-mail par défaut suivants que vous souhaitez utiliser pour l’épreuve créée.

  • All new comments and replies
  • Replies to my comments
  • Daily summary
  • Hourly summary
  • Decisions only
  • Disabled
Default Role
Sélectionnez le rôle par défaut pour l’épreuve.
Disable Subscription Email
Indiquez si vous souhaitez désactiver l’e-mail d’abonnement pour cette épreuve.
Enable Subscriptions
Indiquez si les personnes qui ne sont pas inscrites sont autorisées à s’abonner à l’épreuve.
Si vous sélectionnez cette option, vous pouvez également sélectionner le Default Role pour les personnes abonnées, comme décrit dans ce tableau.
Enable Subscriptions Validation
Indiquez si vous souhaitez activer la validation d’abonnement par e-mail. Si cette option est activée, la personne abonnée doit cliquer sur un lien dans un e-mail pour accéder à une épreuve.
Enable Team URL
Choisissez si vous voulez que l’épreuve créée masque ou affiche l’URL de l’équipe.
Lock proof when all required decisions are made
Indiquez si vous souhaitez que l’épreuve créée soit verrouillée une fois que toutes les décisions requises ont été prises.
Message
Saisissez ou mappez le message qui doit accompagner l’épreuve.
Proof ID
Saisissez ou mappez l’identifiant de l’épreuve que vous souhaitez mettre à jour.
Proof Name
Saisissez ou affichez le nom de l’épreuve que vous souhaitez mettre à jour.
Require login

Indiquez si vous souhaitez utiliser l’option de connexion obligatoire pour l’épreuve créée.

Ce paramètre est identique au paramètre Login Required expliqué dans Configure Proof Settings dans Workfront Proof.

Show Versions Like
Indiquez si vous souhaitez afficher un lien vers d’autres versions de cette épreuve.
Subject
Saisir ou mapper le sujet de l’épreuve

Charger fichier

Ce module d’action charge un fichier à utiliser avec le module Créer une épreuve dans Workfront Proof.

Le module renvoie un identifiant de hachage pour le fichier chargé. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
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.

Recherches

Répertorier les modèles de workflows

Ce module de recherche répertorie tous les modèles de workflow disponibles.

Connection
Pour savoir comment connecter votre compte Workfront Proof à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base.
Outputs
Sélectionnez les informations que vous souhaitez inclure dans le bundle de sortie pour ce module.
Limit
Saisissez ou mappez le nombre maximum de modèles que vous souhaitez que le module renvoie au cours de chaque cycle d’exécution de scénario.

Rechercher

Ce module de recherche recherche les enregistrements dans un objet dans Workfront Proof qui correspondent à la requête que vous avez spécifiée.

Le module renvoie l’identifiant de l’épreuve s’il recherche une épreuve. Il renvoie également les identifiants, les e-mails, les noms, les postes et les alias des e-mail, s’il recherche des destinataires. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Vous devez disposer d’autorisations suffisantes pour accéder à l’enregistrement dans Workfront Proof afin de pouvoir récupérer ces informations.

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

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Rechercher

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

  • Proof

    Saisissez le nom de l’épreuve que vous souhaitez rechercher.

  • Recipient

    Saisissez l’adresse e-mail de la destinataire ou du destinataire que vous souhaitez rechercher.

Result Set
Indiquez si le module doit rechercher All Matching Records ou seulement First Matching Record.
Sort By
Sélectionnez le champ par lequel vous souhaitez trier les résultats.
Sorting Direction
Sélectionnez si vous souhaitez trier les résultats par ordre croissant ou décroissant.

Répertorier les modèles de workflow

Ce module de recherche répertorie tous les modèles de workflow disponibles.

Connection
Pour plus d'informations sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Outputs
Sélectionnez les informations que vous souhaitez inclure dans le bundle de sortie pour ce module.
Limit
Saisissez ou mappez le nombre maximum de modèles que vous souhaitez que le module renvoie au cours de chaque cycle d’exécution de scénario.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43