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 API Username 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
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
SIGNER_EMAIL2
TEXT
IN
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
Dernière mise à jour 4mo ago