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 connecter à votre compte DocuSign.

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.

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 éléments suivants :

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 :

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Connection name Saisissez un nom pour la nouvelle connexion DocuSign.
    Environment Choisissez si vous vous connectez à un environnement de production sur un environnement hors production.
    Connection name Indiquez si vous vous connectez à un compte de service ou à un compte personnel.
    Account type Indiquez si le compte auquel vous souhaitez vous connecter est un compte de production ou de démonstration.
  3. Cliquez sur Continuer pour enregistrer la connexion et revenir au module.

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 Mappage des informations d’un module à un autre.

Basculement de carte

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 plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connexion de Docusign à Workfront Fusion dans cet article.
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
Outputs
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

Ajouter un champ personnalisé

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

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connexion de 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é.

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 obtenir des instructions sur la connexion de votre compte DocuSign à Workfront Fusion, voir Création d’une connexion - Instructions de base.
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 envoyé au destinataire.
Email subject
Saisissez ou mappez l’objet de l’e-mail à envoyer à la personne destinataire.
Private message

Si vous souhaitez envoyer un message privé au destinataire, saisissez ou mappez le texte du 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.

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, consultez les articles sous Créer une connexion - Instructions de base.
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

Pour chaque destinataire que vous souhaitez ajouter à cette enveloppe, cliquez sur Ajouter un élément et saisissez les informations suivantes :

  • Code d’accès

    Saisissez ou mappez le code utilisé par le destinataire pour accéder à l’enveloppe.

  • E-mail

    Saisissez ou mappez l’adresse e-mail du destinataire.

  • Nom

    Saisissez ou mappez le nom du destinataire.

  • Nom du rôle

    Saisissez ou mappez le nom du rôle du destinataire.

  • Ordre de transmission

    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.

Allow Print and Sign
Activez cette option pour permettre au destinataire d’imprimer le document et de signer le papier.
Allow Reassign
Activez cette option si vous souhaitez que le destinataire puisse réaffecter les documents à un autre utilisateur.
Allow Recipient Recursion
Activez cette option pour autoriser la récursivité des destinataires.
Author Copy
Activez cette option pour marquer les documents de cette enveloppe en tant que copies faisant autorité.
Auto Navigation
Activez cette option pour définir la navigation automatique pour le destinataire.
Brand ID
Saisissez ou mappez l’identifiant de la marque.
Markup Enabled
Activez cette option pour activer le balisage du document.
Expire Activé

Activez cette option pour définir une date d'expiration pour cette enveloppe. Si vous activez cette option, renseignez les champs suivants :

  • Expire après

    Entrez ou mappez le nombre de jours après lesquels cette enveloppe expire.

  • Avertissement d'expiration

    Saisissez ou mappez le nombre de jours avant l’expiration auquel un e-mail de rappel est envoyé au destinataire.

Body
Saisissez ou mappez le corps (contenu) de l’e-mail qui accompagne cette enveloppe.
Subject
Saisissez ou mappez l’objet de l’e-mail qui accompagne cette enveloppe.

Appel API personnalisé

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

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connexion de DocuSign à Workfront Fusion dans cet article.
Account
Saisissez ou mappez le compte que vous souhaitez utiliser pour accéder à l’API DocuSign.
URL
Saisir ou mapper un chemin relatif à https://<BASE_URI>/v2/accounts/<ACCOUNT_ID>.
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.
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, pensez à modifier les en-têtes en vous basant sur la documentation de 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.
recommendation-more-help

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.

Exemple de configuration Docusign

Le résultat se trouve dans la sortie du module sous Lot > Corps > Enveloppes.

Dans notre exemple, six enveloppes ont été renvoyées :

Exemple de sortie docusign

Télécharger un document

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

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connexion de 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
Activez cette option pour inclure le certificat de signature d’enveloppe dans le téléchargement.
Documents by User ID
Activez cette option pour permettre aux destinataires de récupérer des documents par ID utilisateur. 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
Activez cette option si vous souhaitez que les octets PDF renvoyés dans la réponse soient chiffrés pour tous les gestionnaires de clés configurés sur votre compte DocuSign.
Language
Sélectionnez la langue.
Show Changes
Activez cette option pour mettre en surbrillance tous les champs modifiés pour le PDF renvoyé, qui sont surlignés en jaune et pour lesquels les signatures ou initiales facultatives sont entourées en rouge.
Watermark
Activez cette option pour activer la fonction de filigrane.

Modifier un champ personnalisé

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

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connexion de 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é.

Lire une enveloppe

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

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connexion de 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'identifiant de l'enveloppe qui contient le document à partir duquel vous souhaitez lire les informations.
Outputs
Sélectionnez les propriétés à afficher dans la sortie du module.

Envoyer une enveloppe

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

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connexion de 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.

Charger un fichier vers une enveloppe

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

Connection
Pour plus d’informations sur la connexion de votre compte DocuSign à Workfront Fusion, voir Connexion de 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.
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3