# Application de workflow DOCUSIGNCHECK

## Aperçu

L'application de workflow **DOCUSIGNCHECK** vous permet de vérifier le statut d'une enveloppe et de télécharger son fichier associé, qui est une concaténation de fichiers joints.

## Mode de fonctionnement

* Vous pouvez vérifier le statut d'une enveloppe et télécharger le fichier depuis DocuSign en fonction de vos critères de statut.<br>
* Des logs d'application sont disponibles. Ceux-ci peuvent être spécifiés en définissant la valeur du paramètre `DocuSignCheckLogLevel` 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ètre requis

| **Paramètre**          | **Type** | **Direction** | **Description**                    |
| ---------------------- | -------- | ------------- | ---------------------------------- |
| `DOCUSIGN_ENVELOPE_ID` | TEXT     | IN            | ID d'enveloppe DocuSign à vérifier |

## 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 DOCUSIGNCHECK.

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

{% hint style="warning" %}
Il est nécessaire d'avoir autorisé l'utilisation de votre application DocuSign. Pour cela, rendez-vous à 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</p><p></p><p>Correspond à la valeur de <code>Private Key</code> de votre application DocuSign<br><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**                                                                                                                  |
| ------------------- | -------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `VALID_STATUS_LIST` | TEXT     | IN            | <p>Statut valide pour télécharger le document<br><strong>Par défaut :</strong> <code>signed,completed,voided,declined</code></p> |
| `DOCUSIGN_DOCUMENT` | FILE     | OUT           | Document DocuSign                                                                                                                |
| `DOCUSIGN_STATUS`   | TEXT     | OUT           | Statut de l'enveloppe                                                                                                            |

## Exemple avec DOCUSIGNSEND

Dans l'exemple suivant, l'action [DOCUSIGNSEND](https://docs.workflowgen.com/admin-fr/8.4/application-de-workflow-docusignsend) est directement suivie par l'action DOCUSIGNCHECK. Cette action reviendra sur elle-même jusqu'à ce que le statut passe à `signed`, `completed`, `voided` ou `declined`.

Si le statut renvoyé remplit la condition, le document sera téléchargé à partir de DocuSign.

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

Avec la fonction d'action de boucle système, l'action DOCUSIGNCHECK sera exécutée toutes les `x` secondes jusqu'à ce que la condition OUT soit remplie.

<div align="center"><img src="https://content.gitbook.com/content/pSR0FJub3VUec6MbQZNw/blobs/zPDazAwszo83zIiMdxAa/image.png" alt="Configuration d&#x27;une action DOCUSIGNCHECK"></div>