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 utilisent uniquement l’application Workfront Proof, sont comptabilisés dans le nombre total de scénarios de votre entreprise.

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é : Workfront Fusion pour l’automatisation et l’intégration du travail

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.

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 un module de Workfront Fusion, cliquez sur Ajouter en regard du champ Connection

  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
    Environment Sélectionnez s’il s’agit d’un environnement de production ou d’un environnement de non-production tel que Prévisualisation ou Sandbox.
    Type 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 Environnement de production, d’aperçu ou personnalisé auquel vous souhaitez vous connecter.
  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 Mappage des informations d’un module à un autre.

Basculement de carte

Déclencheurs

Watch for PDF Summary

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.

Webhook name
Saisissez ou mappez un nom pour le nouveau webhook
Connection
Pour obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base.

Watch Proof Activity

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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base.
Activity type
Choisissez si vous souhaitez observer une nouvelle décision (y compris les modifications du statut de l’épreuve) ou des modifications générales du statut de l’épreuve uniquement.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Watch Proofs

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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base.
Type d’enregistrement
Choisissez si vous souhaitez rechercher de nouvelles épreuves ou de nouvelles décisions globales relatives aux épreuves.
Limite
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.
Éléments par page
Pour paginer les résultats, saisissez ou mappez le nombre de résultats renvoyés qui doivent apparaître sur chaque page de résultats. Ce nombre doit être inférieur ou égal à 100.

Actions

Create Proof

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’identifiant de la nouvelle épreuve ou version de l’épreuve. 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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer 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 du BAT.
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.
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 [élément]
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

Custom API Call

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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer 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 :
Exemple de module d’API de BAT

Download Proof

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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base.
Proof ID
Saisissez l’identifiant unique du BAT, qui se trouve sur la page Proof Details.

Read a Record

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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer 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.

Request PDF Summary

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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer 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 : « You do not have privilege to perform this request. The stage must contain at least one recipient. »
  • 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.

Update Proof

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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base.
Proof ID
Saisissez l’identifiant unique du BAT, qui se trouve sur la page Proof Details.
Deadline
Indiquez la date d’échéance pour la relecture de l’épreuve créée. Utilisez le format de date 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 une option dans le champ Default Role .
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.
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

Upload File

Ce module d’action charge un fichier à utiliser avec le module d’Create Proof 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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer 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

List Workflow Templates

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.

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 obtenir des instructions sur la connexion de votre compte Workfront Proof à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base.
Search for

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

  • 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 recherchera All Matching Records ou uniquement le 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.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3