DOCUSIGNSEND

Aperçu

L'application de workflow DOCUSIGNSEND vous permet d'envoyer un ou plusieurs documents à DocuSign pour signature électronique.

Mode de fonctionnement

  • L'application DOCUSIGNSEND crée une enveloppe unique et l'envoie à un ou plusieurs signataires.

  • Vous pouvez spécifier un ou plusieurs fichiers par action DOCUSIGNSEND. Pour ce faire, utilisez le paramètre FILEx, où x correspond au numéro de fichier (p.ex. FILE1). Au moins un fichier est requis.

  • Vous pouvez spécifier un ou plusieurs signataires. Pour ce faire, utilisez la combinaison de SIGNER_NAME_LIST et SIGNER_EMAIL_LIST. Vous pouvez également utiliser SIGNER_NAMEx et SIGNER_EMAILx, où x correspond au numéro du signataire.

  • Vous pouvez spécifier un code d'accès par signataire. Pour ce faire, selon la méthode que vous utilisez pour spécifier les signataires (avec ou sans _LIST), vous pouvez utiliser SIGNER_ACCESS_CODE_LIST ou SIGNER_ACCESS_CODEx, où x correspond au numéro du signataire.

  • Vous pouvez spécifier les positions des balises DocuSign pour le nom du signataire, l'emplacement de la signature et la date de signature. DocuSign reconnaîtra automatiquement les balises.

  • Des logs d'application sont disponibles. Ceux-ci peuvent être spécifiés en définissant la valeur du paramètre DocuSignSendLogLevel dans le fichier web.config sur 0 pour désactiver la journalisation, 1 pour les logs d'erreur, 2 pour des logs d'informations ou 3 pour les logs de débogage; la valeur par défaut est 0.

Paramètres requis

Vous pouvez utiliser l'une des configurations suivantes : avec une liste de signataires ou avec des numéros de signataires.

Les signataires sont traités séquentiellement, qu'ils soient configurés avec une liste ou avec des numéros.

Avec une liste de signataires

Paramètre

Type

Direction

Description

SIGNER_NAME_LIST

TEXT

IN

Noms des signataires, séparés par la valeur définie dans le paramètre DATA_SEPARATOR

SIGNER_EMAIL_LIST

TEXT

IN

Adresses email des signataires, séparées par la valeur définie dans le paramètre DATA_SEPARATOR

FILEx

FILE

IN

Fichier(s) à envoyer, où x correspond au numéro de fichier; vous pouvez ajouter un ou plusieurs fichiers

Avec des numéros de signataires

Paramètre

Type

Direction

Description

SIGNER_NAMEx

TEXT

IN

Nom(s) du ou des signataires, où x correspond au numéro du signataire; vous pouvez ajouter un ou plusieurs signataires

SIGNER_EMAILx

TEXT

IN

Adresse(s) email du ou des signataires, où x correspond au numéro du signataire; vous pouvez ajouter un ou plusieurs signataires

FILEx

FILE

IN

Fichier(s) à envoyer, où x correspond au numéro de fichier; vous pouvez ajouter un ou plusieurs fichiers

Paramètres facultatifs

Configuration DocuSign

Il existe deux façons de configurer les informations de compte DocuSign : vous pouvez définir la configuration dans le fichier web.config ou dans le panneau de configuration, ou vous pouvez gérer la configuration sur chaque action DOCUSIGNSEND.

Ces paramètres doivent être associés à un compte et une application DocuSign.

Il est nécessaire d'avoir autorisé votre application DocuSign à être utilisée. Pour ceci rendez-vous sur l'adresse: <SERVER>/oauth/auth?response_type=code&scope=signature%20impersonation&client_id=<CLIENT_ID>&redirect_uri=<REDIRECT_URI>

  • <SERVER> : https://account.docusign.com (production) ou https://account-d.docusign.com (demo).

  • <CLIENT_ID> : Correspond à la valeur de Integration Key de votre application DocuSign

  • <REDIRECT_URI> : Adresse de redirection (ex: https://docusign.com)

Paramètres

Type

Direction

Description

DOCUSIGN_CLIENT_ID

TEXT

IN

ID client DocuSign Correspond à la valeur de Integration Key de votre application DocuSign Par défaut, cette valeur provient du paramètre DocuSignClientId dans le fichier web.config.

DOCUSIGN_USER_GUID

TEXT

IN

GUID utilisateur DocuSign Correspond à la valeur de ID Utilisateur dans le panneau de configuration de DocuSign Par défaut, cette valeur provient du paramètre DocuSignUserGuid dans le fichier web.config.

DOCUSIGN_AUTH_SERVER

TEXT

IN

Serveur d'authentification DocuSign

Valeurs de DocuSign :

  • account.docusign.com (production)

  • account-d.docusign.com (demo)

Par défaut, cette valeur provient du paramètre DocuSignAuthServer dans le fichier web.config.

DOCUSIGN_RSA_KEY

TEXT

IN

Clé RSA DocuSign

Correspond à la valeur de Private Key de votre application DocuSign

Par défaut, cette valeur provient du fichier /Files/DocuSign/rsaKey.pem.

DOCUSIGN_HOST_SERVER

TEXT

IN

Serveur hôte DocuSign Valeurs de DocuSign :

  • https://docusign.net (production)

  • https://demo.docusign.net (demo)

Par défaut, cette valeur provient du paramètre DocuSignHostServer dans le fichier web.config.

Général

Paramètres

Type

Direction

Description

DATA_SEPARATOR

TEXT

IN

Séparateur utilisé pour séparer les contenus de SIGNERS_NAME_LIST, SIGNERS_EMAIL_LIST et SIGNER_ACCESS_CODE_LIST Par défaut : ,

SIGNER_ACCESS_CODE_LIST

TEXT

IN

Code d'accès des signataires, séparés par la valeur définie dans le paramètre DATA_SEPARATOR

SIGNER_ACCESS_CODEX

TEXT

IN

Code d'accès pour le signataire X

EMAIL_SUBJECT

TEXT

IN

Objet de l'email utilisé pour l'enveloppe DocuSign Par défaut :Please sign this document sent from WorkflowGen

PREFIX_SIGNHERE

TEXT

IN

Préfixe de la balise SignHere Par défaut : /s

SUFFIX_SIGNHERE

TEXT

IN

Suffixe de la balise SignHere Par défaut : /

X_OFFSET_SIGNHERE

TEXT

IN

Alignement vertical de la balise SignHere en pixels Par défaut : 0

Y_OFFSET_SIGNHERE

TEXT

IN

Alignement horizontal de la balise SignHere en pixels Par défaut : 0

PREFIX_FULLNAME

TEXT

IN

Préfixe de la balise Full name Par défaut : /f

SUFFIX_FULLNAME

TEXT

IN

Suffixe de la balise Full name Par défaut : /

X_OFFSET_FULLNAME

NUMERIC

IN

Alignement vertical de la balise Full name en pixels Par défaut : 0

Y_OFFSET_FULLNAME

NUMERIC

IN

Alignement horizontal de la balise Full name en pixels Par défaut : 0

PREFIX_DATE

TEXT

IN

Préfixe de la balise Date Par défaut : /d

SUFFIX_DATE

TEXT

IN

Suffixe de la balise Date Par défaut : /

X_OFFSET_DATE

NUMERIC

IN

Alignement vertical de la balise Date en pixels Par défaut : 0

Y_OFFSET_DATE

NUMERIC

IN

Alignement horizontal de la balise Date en pixels Par défaut : 0

Paramètre de retour

Paramètre

Type

Direction

Description

DOCUSIGN_ENVELOPE_ID

TEXT

OUT

Exemples

Avec liste de signataires

Paramètre

Type

Direction

Valeur

SIGNER_NAME_LIST

TEXT

IN

Jean Dupont,Bernard Martin

SIGNER_EMAIL_LIST

TEXT

IN

jean.dupont@email.fr,bernard.martin@email.fr

SIGNER_ACCESS_CODE_LIST

TEXT

IN

abc123,def456

FILE1

FILE

IN

contrat.pdf

DOCUSIGN_ENVELOPE_ID

TEXT

OUT

xxxxx-xxxxx-xxxxx-xxxxx

Avec numéros de signataire

Paramètre

Type

Direction

Valeur

SIGNER_NAME1

TEXT

IN

Jean Dupont

SIGNER_NAME2

TEXT

IN

Bernard Martin

SIGNER_EMAIL1

TEXT

IN

jean.dupont@email.fr

SIGNER_EMAIL2

TEXT

IN

bernard.martin@email.fr

SIGNER_ACCESS_CODE1

TEXT

IN

abc123

SIGNER_ACCESS_CODE2

TEXT

IN

def456

FILE1

FILE

IN

contrat.pdf

DOCUSIGN_ENVELOPE_ID

TEXT

OUT

xxxxx-xxxxx-xxxxx-xxxxx

Envoi d'un document avec des balises

DocuSign vous permet de spécifier l'emplacement où vous souhaitez que votre signataire signe. Par défaut, les balises sont /fx/ pour le nom complet du signataire, /dx/ pour la date et /sx/ pour le bouton Sign Here; x correspond au numéro du signataire.

Ajoutez des balises à votre document, comme indiqué ci-dessous :

DocuSign ne supprime pas les caractères du document et ajoute simplement une surcharge sur les balises, vous pouvez donc définir les couleurs des balises sur la même couleur que votre arrière-plan (blanc, dans l'exemple suivant) :

Résultat dans DocuSign :

PrécédentDocuSignSuivantDOCUSIGNCHECK