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
etSIGNER_EMAIL_LIST
. Vous pouvez également utiliserSIGNER_NAMEx
etSIGNER_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 utiliserSIGNER_ACCESS_CODE_LIST
ouSIGNER_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 fichierweb.config
sur0
pour désactiver la journalisation,1
pour les logs d'erreur,2
pour des logs d'informations ou3
pour les logs de débogage; la valeur par défaut est0
.
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 |
| TEXT | IN | Noms des signataires, séparés par la valeur définie dans le paramètre |
| TEXT | IN | Adresses email des signataires, séparées par la valeur définie dans le paramètre D |
| FILE | IN | Fichier(s) à envoyer, où |
Avec des numéros de signataires
Paramètre | Type | Direction | Description |
| TEXT | IN | Nom(s) du ou des signataires, où |
| TEXT | IN | Adresse(s) email du ou des signataires, où |
| FILE | IN | Fichier(s) à envoyer, où |
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) ouhttps://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 |
| TEXT | IN | ID client DocuSign
Correspond à la valeur de |
| TEXT | IN | GUID utilisateur DocuSign
Correspond à la valeur de |
| TEXT | IN | Serveur d'authentification DocuSign Valeurs de DocuSign :
Par défaut, cette valeur provient du paramètre |
| TEXT | IN | Clé RSA DocuSign Correspond à la valeur de
Par défaut, cette valeur provient du fichier |
| TEXT | IN | Serveur hôte DocuSign Valeurs de DocuSign :
Par défaut, cette valeur provient du paramètre |
Général
Paramètres | Type | Direction | Description |
| TEXT | IN | Séparateur utilisé pour séparer les contenus de |
| TEXT | IN | Code d'accès des signataires, séparés par la valeur définie dans le paramètre |
| TEXT | IN | Code d'accès pour le signataire |
| TEXT | IN | Objet de l'email utilisé pour l'enveloppe DocuSign
Par défaut : |
| TEXT | IN | Préfixe de la balise |
| TEXT | IN | Suffixe de la balise |
| TEXT | IN | Alignement vertical de la balise |
| TEXT | IN | Alignement horizontal de la balise |
| TEXT | IN | Préfixe de la balise |
| TEXT | IN | Suffixe de la balise |
| NUMERIC | IN | Alignement vertical de la balise |
| NUMERIC | IN | Alignement horizontal de la balise |
| TEXT | IN | Préfixe de la balise |
| TEXT | IN | Suffixe de la balise |
| NUMERIC | IN | Alignement vertical de la balise |
| NUMERIC | IN | Alignement horizontal de la balise |
Paramètre de retour
Paramètre | Type | Direction | Description |
| 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 |
| TEXT | IN |
|
| TEXT | IN |
|
| TEXT | IN |
|
| FILE | IN |
|
| TEXT | OUT |
|
Avec numéros de signataire
Paramètre | Type | Direction | Valeur |
| TEXT | IN |
|
| TEXT | IN |
|
| TEXT | IN |
|
| TEXT | IN |
|
| TEXT | IN |
|
| TEXT | IN |
|
| FILE | IN |
|
| TEXT | OUT |
|
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) :