Application de workflow 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.
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
Contient l'ID d'enveloppe DocuSign; vous pouvez utiliser cet ID dans l'application de workflow DOCUSIGNCHECK​
Exemples
Avec liste de signataires
Paramètre
Type
Direction
Valeur
SIGNER_NAME_LIST
TEXT
IN
Jean Dupont,Bernard Martin
SIGNER_EMAIL_LIST
TEXT
IN
[email protected],[email protected]
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
[email protected]
SIGNER_EMAIL2
TEXT
IN
[email protected]
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 :
Ajout de balises
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) :
Balises masquées
Résultat dans DocuSign :
Avant la signature
Après la signature