# ADOBESIGNSEND ## Aperçu L'application de workflow **ADOBESIGNSEND** vous permet d'envoyer un ou plusieurs documents à Adobe Sign pour signature électronique. ## Mode de fonctionnement * L'application ADOBESIGNSEND crée une enveloppe unique et l'envoie à un ou plusieurs signataires.
* Vous pouvez spécifier un ou plusieurs fichiers par action ADOBESIGNSEND. 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 rôle par destinataire. Pour ce faire, selon la méthode que vous utilisez pour spécifier les signataires (avec ou sans `_LIST`), vous pouvez utiliser `SIGNER_ROLE_LIST` ou `SIGNER_ROLEx`, où `x` correspond au numéro du signataire.\ Valeurs possibles : `SIGNER` (par défaut), `APPROVER`, `ACCEPTOR`, `CERTIFIED_RECIPIENT`, `FORM_FILLER` ou `DELEGATE_TO_SIGNER`, `DELEGATE_TO_APPROVER`, `DELEGATE_TO_ACCEPTOR`, `DELEGATE_TO_CERTIFIED_RECIPIENT`, `DELEGATE_TO_FORM_FILLER` ou`SHARE`.
* Des logs d'application sont disponibles. Ceux-ci peuvent être spécifiés en définissant la valeur du paramètre `AdobeSignSendLogLevel` 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`. ## Configuration de l'API Adobe Sign ### Création d'une application API Adobe Sign 1. Dans l'interface d'administration Adobe Sign, ajoutez une nouvelle `API Application` puis cliquez sur **Configure OAuth for application**.
2. Activez les portées ci-dessous et sélectionnez `account` sous **Modifier** pour les deux : * `agreement_write` * `agreement_read`
3. Vous pouvez récupérer les `Client ID` et `Client Secret` directement depuis l'onglet de configuration.
4. Insérez une adresse valide dans le champ **Redirect URI;** elle sera utile pour l'étape suivante.
### Obtenir le jeton de rafraîchissement Adobe Sign ne supportant pas l'authentification `client_credentials`, il est nécessaire d'utiliser un jeton de rafraîchissement afin de récupérer un `access_token` valide. Le jeton de rafraîchissement à une durée de validité de 60 jours. Ces 60 jours sont renouvelés à chaque appel d'API, ce qui signifie que lorsque vous exécutez ADOBESIGNSEND ou ADOBESIGNCHECK, la validité est prolongé de 60 jours. #### Consentement et obtention du code à usage unique Afin de pouvoir utiliser votre nouvelle application Adobe Sign, vous devez l'autoriser à accéder aux `scopes` définis. Vous devez executer l'URL ci-dessous dans votre navigateur : ``` /public/oauth?redirect_uri=&client_id=&response_type=code&scope=agreement_read:account+agreement_write:account ``` Remplacez les informations ci-dessous par vos propres valeurs : * `` : Serveur hôte de votre compte Adobe Sign. En général l'URL est composée ainsi : `https://api.naX.adobesign.com`, où `X` est l'identifiant du serveur. * `` : URL que vous avez définie dans votre application Adobe Sign. * `` : Identifiant client de votre application Adobe Sign Après avoir accordé le consentement à votre application, vous serez redirigé vers votre `REDIRECT_URI` avec un paramètre `CODE` dans l'URL. ``` /public/oauth?redirect_uri=&client_id=&response_type=code&scope=agreement_read:account+agreement_send:account ``` Le code ainsi retourné par Adobe Sign est à usage unique et sera utilisé pour obtenir le jeton de rafraîchissement. #### Récupération du jeton de rafraîchissement Afin d'obtenir le jeton de rafraîchissement, exécutez la requête ci-dessous en indiquant vos valeurs : ``` curl --location --request POST '/oauth/token' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'code=' \ --data-urlencode 'client_id=' \ --data-urlencode 'client_secret=' \ --data-urlencode 'redirect_uri=' \ --data-urlencode 'grant_type=authorization_code' ``` * `HOST_SERVER` : Serveur hôte de votre compte Adobe Sign. En général l'URL est composée ainsi : `https://api.naX.adobesign.com` , où `X` est l'identifiant du serveur. * `` : Code à usage unique obtenu sur l'étape précédente ([Consentement et obtention du code à usage unique](/admin-fr/9.1/applications-de-workflow/adobe-sign/application-de-workflow-adobesignsend.md#consentement-et-obtention-du-code-a-usage-unique)). * `` : Identifiant client de votre application Adobe Sign. * `` : Clé secrète client de votre application Adobe Sign. * `` : URL que vous avez définie dans votre application Adobe Sign. Après exécution de la requête, vous obtiendrez une valeur pour le jeton de rafraîchissement contenu dans la donnée `refresh_token`. {% hint style="info" %} Si votre jeton de rafraîchissement est expiré, vous devrez effectuer les manipulations précédentes de nouveau. {% endhint %} ## 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 Adobe Sign | **Paramètres** | **Type** | **Direction** | **Description** | | ------------------------- | -------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ADOBESIGN_CLIENT_ID` | TEXT | IN |

ID client Adobe Sign

Par défaut, cette valeur provient du paramètre AdobeSignClientId dans le fichier web.config.

| | `ADOBESIGN_CLIENT_SECRET` | TEXT | IN |

Clé secrète client Adobe Sign

Par défaut, cette valeur provient du paramètre AdobeSignClientSecret dans le fichier web.config.

| | `ADOBESIGN_REFRESH_TOKEN` | TEXT | IN |

Jeton de rafraîchissement de l'authentification

Par défaut, cette valeur provient du paramètre AdobeSignAuthServer dans le fichier web.config.

Pour l'obtenir référez-vous à la section Configuration de l'API Adobe Sign.

| | `ADOBESIGN_HOST_SERVER` | TEXT | IN |

Serveur hôte Adobe Sign (p.ex. : , où X est l'identifiant du serveur)

Par défaut, cette valeur provient du paramètre AdobeSignHostServer 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\_ROLE\_LIST
Par défaut : , (virgule)

| | `SIGNER_ROLE_LIST` | TEXT | IN | Rôles des signataires, séparés par la valeur définie dans le paramètre `DATA_SEPARATOR` | | `SIGNER_ROLEX` | TEXT | IN | Rôle(s) du ou des signataires, où `x` correspond au numéro du signataire; vous pouvez ajouter un ou plusieurs signataires | | `AGREEMENT_NAME` | TEXT | IN |

Nom de l'agrément, il sera affiché dans l'email envoyé à l'utilisateur
Par défaut :WorkflowGen

| ### Paramètre de retour | **Paramètre** | **Type** | **Direction** | **Description** | | ------------------------ | -------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ADOBESIGN_AGREEMENT_ID` | TEXT | OUT | Contient l'ID de l'agrément Adobe Sign; vous pouvez utiliser cet ID dans l'application de workflow [ADOBESIGNCHECK](/admin-fr/9.1/applications-de-workflow/adobe-sign/application-de-workflow-adobesigncheck.md) | ## 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_ROLE_LIST` | TEXT | IN | `APPROVER,SIGNER` | | `FILE1` | FILE | IN | `contrat.pdf` | | `ADOBESIGN_AGREEMENT_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_ROLE1` | TEXT | IN | `APPROVER` | | `SIGNER_ROLE2` | TEXT | IN | `SIGNER` | | `FILE1` | FILE | IN | `contrat.pdf` | | `ADOBESIGN_AGREEMENT_ID` | TEXT | OUT | `xxxxx-xxxxx-xxxxx-xxxxx` | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.workflowgen.com/admin-fr/9.1/applications-de-workflow/adobe-sign/application-de-workflow-adobesignsend.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.