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.

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	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	[e-mail],[e-mail]
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	[e-mail]
SIGNER_EMAIL2	TEXT	IN	[e-mail]
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