DOCUSIGNSEND
Dernière mise à jour
Dernière mise à jour
L'application de workflow DOCUSIGNSEND vous permet d'envoyer un ou plusieurs documents à DocuSign pour signature électronique.
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
.
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.
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
)
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) :
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
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
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
.
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
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
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
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