Modules DocuSign

Les modules Adobe Workfront Fusion DocuSign vous permettent de surveiller et de récupérer le statut des enveloppes, de rechercher et de récupérer des enveloppes, ou de télécharger et d’envoyer un document pour vous connecte à votre compte DocuSign.

Si vous avez besoin d’instructions sur la création d’un scénario, consultez 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 de licence héritées : Workfront Fusion for Work Automation and Integration

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.

Conditions préalables

Pour utiliser les modules DocuSign, vous devez disposer d’un compte DocuSign.

Informations sur l’API DocuSign

Le connecteur DocuSign utilise les méthodes suivantes :

Balise API
1.18.11

Connecter DocuSign à Workfront Fusion connect-docusign-to-workfront-fusion

Pour créer une connexion pour vos modules DocuSign, procédez comme suit :

  1. Cliquez sur Ajouter en regard de la case Connexion lorsque vous commencez à configurer le premier module DocuSign.
  2. Saisissez les informations suivantes :
Connection name
Saisir un nom pour la nouvelle connexion DocuSign
Account type
Indiquez si le compte auquel vous souhaitez vous connecter est un compte de production ou de démonstration.

Modules DocuSign et leurs champs

Lorsque vous configurez les modules DocuSign, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs DocuSign 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

Surveiller les enveloppes

Ce module de déclenchement lance un scénario lorsqu’une enveloppe est envoyée, diffusée, signée, terminée ou refusée.

Connection
Pour obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter l’application ou le service web du module à Workfront Fusion dans l’article Créer un scénario dans Adobe Workfront Fusion.
Account
Sélectionnez le compte qui contient les enregistrements à surveiller.
Event type

Sélectionnez le type d’événement à surveiller.

  • Document completed
  • Document declined
  • Document sent
  • Document signed
  • New document in Inbox
Output fields
Sélectionnez les champs que vous souhaitez inclure dans la sortie du module.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que vous souhaitez que le module utilise lors de chaque cycle d’exécution du scénario.

Actions

Appel API personnalisé

Ce module d’action vous permet d’effectuer un appel API personnalisé.

Connection
Pour obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter DocuSign à Workfront Fusion dans cet article.
Account
Saisissez ou mappez le compte que vous souhaitez utiliser pour accéder à l’API DocuSign.
URL

Saisissez l’adresse sur le serveur web avec lequel le module doit interagir.

Vous pouvez saisir une URL relative, ce qui signifie que vous n’avez pas besoin d’inclure le protocole (comme http://) au début. Cela indique au serveur web que l’interaction se produit sur le serveur.

Par exemple : /api/conversations.create

Method
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP dans Adobe Workfront Fusion.
Headers

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard. Cela détermine le type de contenu de la requête.

Par exemple, {"Content-type":"application/json"}

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

Query String

Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.

Par exemple : {"name":"something-urgent"}

Body

Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.

Note :

Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, placez des guillemets à l’extérieur de l’instruction conditionnelle.

Limit
Saisissez ou mappez le nombre maximal de résultats à utiliser au cours d’un cycle d’exécution.
INFO
Exemple : répertorier les enveloppes
L’appel API suivant renvoie des enveloppes à partir de la date spécifiée dans votre compte DocuSign :
URL  : /v2.1/accounts/{accountId}/envelopes/
Méthode  : GET
Chaîne de requête  :
  • Clé  : from_date

  • Valeur  : YYYY-MM-DD

Indique le moment où la requête commence à vérifier les modifications de statut des enveloppes du compte.
Le résultat se trouve dans la sortie du module sous Lot > Corps > Enveloppes.
Dans notre exemple, six enveloppes ont été renvoyées :

Télécharger un document

Ce module d’action télécharge un seul document.

Connection
Pour obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter DocuSign à Workfront Fusion dans cet article.
Account
Sélectionnez le compte contenant le document que vous souhaitez télécharger.
Envelope ID
Saisissez ou mappez l’ID de l’enveloppe que vous souhaitez télécharger.
Document ID
Saisissez ou mappez l’ID du document que vous souhaitez télécharger.
Certificate
Sélectionnez Yes si vous souhaitez inclure le certificat de signature d’enveloppe dans le téléchargement.
Documents by User ID
Sélectionnez Yes si vous souhaitez permettre aux personnes destinataires de récupérer des documents par ID d’utilisateur ou d’utilisatrice. Par exemple, si une personne est incluse dans deux ordres de transmission différents avec des visibilités différentes, l’utilisation de cette option renvoie tous les documents des deux transmissions.
Encrypt
Sélectionnez Yes si vous souhaitez que les octets de PDF renvoyés dans la réponse soient chiffrés pour tous les gestionnaires de clés configurées sur votre compte DocuSign.
Language
Sélectionnez la langue.
Show Changes
Lorsque la variable est définie sur Yes, les champs modifiés du PDF renvoyé sont mis en surbrillance en jaune et les signatures ou initiales facultatives sont indiquées en rouge.
Watermark
Sélectionnez No pour supprimer le filigrane des documents du PDF.

Lire une enveloppe

Ce module d’action lit des informations sur une enveloppe dans DocuSign en utilisant l’ID d’enveloppe.

Connection
Pour obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter DocuSign à Workfront Fusion dans cet article.
Account
Sélectionnez le compte contenant le document à partir duquel vous souhaitez lire les informations.
Envelope ID
Saisissez ou mappez l’ID du document à partir duquel vous souhaitez lire les informations.
Outputs
Sélectionnez les propriétés à afficher dans la sortie du module.

Charger un fichier vers une enveloppe

Ce module charge un fichier spécifié dans une enveloppe existante dans DocuSign.

Connection
Pour obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter DocuSign à Workfront Fusion dans cet article.
Account
Sélectionnez le compte contenant l’enveloppe dans laquelle vous souhaitez charger un fichier.
Envelope ID
Saisissez ou mappez l’ID de l’enveloppe dans laquelle vous souhaitez charger un fichier.
Source file
Sélectionnez un fichier source à partir d’un module précédent ou saisissez le nom et les données du fichier source.

Créer une enveloppe

Ce module d’action crée une enveloppe à partir d’un modèle. Il renvoie l’ID et le statut de la nouvelle enveloppe.

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter l’application ou le service web du module à Workfront Fusion dans l’article Créer un scénario dans Adobe Workfront Fusion.
Account
Sélectionnez le compte contenant l’enveloppe dans laquelle vous souhaitez charger un fichier.
Template
Sélectionnez le modèle à partir duquel vous souhaitez créer l’enveloppe. Les modèles sont disponibles en fonction du Account que vous avez sélectionné.
After creation
Indiquez si vous souhaitez enregistrer l’enveloppe en tant que brouillon ou l’envoyer pour signature.
Template recipients
Sélectionner la personne destinataire de cette enveloppe

Ajouter une personne destinataire à l’enveloppe

Ce module d’action ajoute une ou plusieurs personnes destinataires à une enveloppe existante. Si l’enveloppe a déjà été envoyée, la personne destinataire reçoit un e-mail. Ce module n’est pas valide pour les enveloppes déjà terminées.

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter l’application ou le service web du module à Workfront Fusion dans l’article Créer un scénario dans Adobe Workfront Fusion.
Account
Sélectionnez le compte contenant l’enveloppe à laquelle vous souhaitez ajouter des personnes destinataires.
Envelope ID
Sélectionnez ou mappez l’ID de l’enveloppe à laquelle vous souhaitez ajouter la personne destinataire.
Recipient type

Sélectionnez le type de personne destinataire à ajouter à l’enveloppe.

  • Agent

  • Carbon copy

  • Certified delivery

  • In-person signer

  • Intermediary

  • Signer

Email
Saisissez ou mappez l’adresse e-mail de la personne destinataire à ajouter à l’enveloppe.
Name
Saisissez ou mappez le nom de la personne destinataire à ajouter à l’enveloppe.
Routing order
Saisissez ou mappez le numéro de routage de la personne destinataire. Le numéro de routage détermine l’ordre dans lequel les personnes destinataires reçoivent et signent vos documents.
Email body
Saisissez ou mappez le corps (contenu) de l’e-mail à envoyer à la personne destinataire.
Email subject
Saisissez ou mappez l’objet de l’e-mail à envoyer à la personne destinataire.
Private message
  • Seule la personne destinataire sélectionnée voit le message privé, ainsi que le message général. Le message privé est limité à 1 000 caractères.
Authentication

Sélectionnez la méthode d’authentification à utiliser pour confirmer l’identité de la personne destinataire.

  • None

  • Access code

    Saisissez ou mappez le code d’accès.

  • Phone

    Saisissez ou mappez le numéro de téléphone.

  • SMS

    Saisissez ou mappez le numéro de téléphone.

Ajouter un champ personnalisé

Ce module d’action ajoute un champ personnalisé au document.

Connection
Pour obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter DocuSign à Workfront Fusion dans cet article.
Account
Sélectionnez le compte contenant le document auquel vous souhaitez ajouter un champ personnalisé.
Envelope ID
Saisissez ou mappez l’ID de l’enveloppe qui contient le document auquel vous souhaitez ajouter un champ personnalisé.
Field name
Saisissez ou mappez un nom pour le nouveau champ à ajouter.
Required
Activez cette option si vous souhaitez que le champ ajouté soit un champ obligatoire.
Show field
Activez cette option si vous souhaitez que le champ soit visible.
Value
Saisissez ou mappez la valeur (contenu) du champ ajouté.

Modifier un champ personnalisé

Ce module d’action modifie un champ personnalisé à l’aide du nom du champ.

Connection
Pour obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter DocuSign à Workfront Fusion dans cet article.
Account
Sélectionnez le compte contenant le document dont vous souhaitez modifier un champ personnalisé.
Envelope ID
Saisissez ou mappez l’ID de l’enveloppe qui contient le document dont vous souhaitez modifier un champ personnalisé.
Field ID
Saisissez ou mappez l’ID du champ à modifier.
Field name
Saisissez ou mappez le nom du champ à modifier.
Required
Activez cette option si vous souhaitez que le champ modifié soit un champ obligatoire.
Show field
Activez cette option si vous souhaitez que le champ soit visible.
Value
Saisissez ou mappez la valeur (contenu) du champ modifié.

Envoyer une enveloppe

Ce module d’action envoie un brouillon d’enveloppe à ses personnes destinataires.

Connection
Pour obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connecter DocuSign à Workfront Fusion dans cet article.
Account
Sélectionnez le compte contenant le brouillon d’enveloppe à envoyer à ses personnes destinataires.
Envelope ID
Saisissez ou mappez l’ID du brouillon d’enveloppe à envoyer à ses personnes destinataires.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43