# 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.<br>
* 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.<br>
* 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.<br>
* 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.<br>
* 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.<br>
* 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.

{% hint style="warning" %}
Les signataires sont traités séquentiellement, qu'ils soient configurés avec une liste ou avec des numéros.
{% endhint %}

### 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 D`ATA_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.

{% hint style="info" %}
Ces paramètres doivent être associés à un compte et une application DocuSign.
{% endhint %}

{% hint style="info" %}
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`)
  {% endhint %}

| **Paramètres**         | **Type** | **Direction** | **Description**                                                                                                                                                                                                                                                                                                             |
| ---------------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DOCUSIGN_CLIENT_ID`   | TEXT     | IN            | <p>ID client DocuSign<br><br>Correspond à la valeur de <code>Integration Key</code> de votre application DocuSign<br><br>Par défaut, cette valeur provient du paramètre <code>DocuSignClientId</code> dans le fichier <code>web.config</code>.</p>                                                                          |
| `DOCUSIGN_USER_GUID`   | TEXT     | IN            | <p>GUID utilisateur DocuSign<br><br>Correspond à la valeur de <code>ID Utilisateur</code> dans le panneau de configuration de DocuSign<br><br>Par défaut, cette valeur provient du paramètre <code>DocuSignUserGuid</code> dans le fichier <code>web.config</code>.</p>                                                     |
| `DOCUSIGN_AUTH_SERVER` | TEXT     | IN            | <p>Serveur d'authentification DocuSign</p><p><br>Valeurs de DocuSign :</p><ul><li><code>account.docusign.com</code> (production)</li><li><code>account-d.docusign.com</code> (demo)</li></ul><p>Par défaut, cette valeur provient du paramètre <code>DocuSignAuthServer</code> dans le fichier <code>web.config</code>.</p> |
| `DOCUSIGN_RSA_KEY`     | TEXT     | IN            | <p>Clé RSA DocuSign<br></p><p>Correspond à la valeur de <code>Private Key</code> de votre application DocuSign</p><p><br>Par défaut, cette valeur provient du fichier <code>/Files/DocuSign/rsaKey.pem</code>.</p>                                                                                                          |
| `DOCUSIGN_HOST_SERVER` | TEXT     | IN            | <p>Serveur hôte DocuSign<br><br>Valeurs de DocuSign :</p><ul><li><code><https://docusign.net></code> (production)</li><li><code><https://demo.docusign.net></code> (demo)</li></ul><p>Par défaut, cette valeur provient du paramètre <code>DocuSignHostServer</code> dans le fichier <code>web.config</code>.</p>           |

### Général

| **Paramètres**            | **Type** | **Direction** | **Description**                                                                                                                                                                                                       |
| ------------------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DATA_SEPARATOR`          | TEXT     | IN            | <p>Séparateur utilisé pour séparer les contenus de <code>SIGNERS\_NAME\_LIST</code>, <code>SIGNERS\_EMAIL\_LIST</code> et <code>SIGNER\_ACCESS\_CODE\_LIST</code><br><strong>Par défaut :</strong> <code>,</code></p> |
| `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            | <p>Objet de l'email utilisé pour l'enveloppe DocuSign<br><strong>Par défaut :</strong><code>Please sign this document sent from WorkflowGen</code></p>                                                                |
| `PREFIX_SIGNHERE`         | TEXT     | IN            | <p>Préfixe de la balise <code>SignHere</code><br><strong>Par défaut :</strong> <code>/s</code></p>                                                                                                                    |
| `SUFFIX_SIGNHERE`         | TEXT     | IN            | <p>Suffixe de la balise <code>SignHere</code><br><strong>Par défaut :</strong> <code>/</code></p>                                                                                                                     |
| `X_OFFSET_SIGNHERE`       | TEXT     | IN            | <p>Alignement vertical de la balise <code>SignHere</code> en pixels<br><strong>Par défaut :</strong> <code>0</code></p>                                                                                               |
| `Y_OFFSET_SIGNHERE`       | TEXT     | IN            | <p>Alignement horizontal de la balise <code>SignHere</code> en pixels<br><strong>Par défaut :</strong> <code>0</code></p>                                                                                             |
| `PREFIX_FULLNAME`         | TEXT     | IN            | <p>Préfixe de la balise <code>Full name</code><br><strong>Par défaut :</strong> <code>/f</code></p>                                                                                                                   |
| `SUFFIX_FULLNAME`         | TEXT     | IN            | Suffixe de la balise `Full name` **Par défaut :** `/`                                                                                                                                                                 |
| `X_OFFSET_FULLNAME`       | NUMERIC  | IN            | <p>Alignement vertical de la balise <code>Full name</code> en pixels<br><strong>Par défaut :</strong> <code>0</code></p>                                                                                              |
| `Y_OFFSET_FULLNAME`       | NUMERIC  | IN            | <p>Alignement horizontal de la balise <code>Full name</code> en pixels<br><strong>Par défaut :</strong> <code>0</code></p>                                                                                            |
| `PREFIX_DATE`             | TEXT     | IN            | <p>Préfixe de la balise <code>Date</code><br><strong>Par défaut :</strong> <code>/d</code></p>                                                                                                                        |
| `SUFFIX_DATE`             | TEXT     | IN            | <p>Suffixe de la balise <code>Date</code><br><strong>Par défaut :</strong> <code>/</code></p>                                                                                                                         |
| `X_OFFSET_DATE`           | NUMERIC  | IN            | <p>Alignement vertical de la balise <code>Date</code> en pixels<br><strong>Par défaut :</strong> <code>0</code></p>                                                                                                   |
| `Y_OFFSET_DATE`           | NUMERIC  | IN            | <p>Alignement horizontal de la balise <code>Date</code> en pixels<br><strong>Par défaut :</strong> <code>0</code></p>                                                                                                 |

### 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](https://docs.workflowgen.com/admin-fr/8.4/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            | `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`                      |

### 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            | `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` |

### 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 :

<div align="center"><img src="https://content.gitbook.com/content/pSR0FJub3VUec6MbQZNw/blobs/ZcLarBPluStDgMHdV4AI/image.png" alt="Ajout de balises"></div>

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) :

<div align="center"><img src="https://content.gitbook.com/content/pSR0FJub3VUec6MbQZNw/blobs/fJ45a8iN8MaMnf89KTYY/image.png" alt="Balises masquées"></div>

#### Résultat dans DocuSign :

<div align="center"><img src="https://content.gitbook.com/content/pSR0FJub3VUec6MbQZNw/blobs/RdfmiEnHxcm2hRfarhOj/image.png" alt="Avant la signature"></div>

<div align="center"><img src="https://content.gitbook.com/content/pSR0FJub3VUec6MbQZNw/blobs/VZAnHprSVkFHJZDFxtsw/image.png" alt="Après la signature"></div>