Comment utiliser IBM® App Connect avec DocuSign
DocuSign est un logiciel de signature électronique et d'approbation de documents qui vous permet d'envoyer, de signer et de gérer des accords sur plusieurs appareils.
- App Connect connecteur
Connecteur local dans les conteneurs (version Continuous Delivery) 12.0.7.0-r1 ou ultérieure
Connecteur local dans les conteneurs (version Long Term Support Cycle-2 )
Se connecter à DocuSign
Remplissez les champs de connexion que vous voyez dans la page App Connect Designer (anciennement la page Catalogue ) ou dans l'éditeur de flux. Si nécessaire, travaillez avec votre administrateur pour obtenir ces valeurs DocuSign l'administrateur pour obtenir ces valeurs.
- Fournir les informations d'identification à utiliser par App Connect (KEY API) - App Connect in containers et App Connect
- Fournir des informations d'identification à App Connect (OAUTH BASIC) - App Connect in containers et App Connect
- Utiliser le site web de l'application pour se connecter (OAUTH 2.0 AUTH CODE) App Connect
| Fournir les informations d'identification à utiliser par App Connect (KEY API) | Fournir des informations d'identification à App Connect (OAUTH DE BASE) | Utiliser le site web de l'application pour se connecter (OAUTH 2.0 AUTH CODE) |
|---|---|---|
| URL du point de terminaison | URL du point de terminaison | URL du point de terminaison Astuce : Autorisez la connexion à DocuSign en vous connectant à votre compte.
|
| Clé d'intégration | ID de client | |
| ID utilisateur | Secret client | |
| Clé privée RSA | Jeton d'accès | |
| Jeton d'actualisation |
| Champ de connexion | Descriptif |
|---|---|
| URL du point de terminaison | Pour l'environnement de développement, le point de terminaison URL est : account-d.docusign.com. Pour la plate-forme de production, le point de terminaison URL est : account.docusign.com. |
| Clé d'intégration | Clé d'intégration permettant d'identifier votre application auprès de DocuSign pour communiquer avec les API de DocuSign. |
| ID utilisateur | L'identifiant de l'utilisateur pour accéder à votre compte DocuSign. |
| Clé privée RSA | La clé privée RSA utilisée pour chiffrer votre jeton dans le flux d'authentification JSON Web Token (JWT). |
| ID de client | La clé du consommateur qui est générée lorsque vous créez une application connectée pour App Connect dans DocuSign. |
| Secret client | Le secret du consommateur qui est généré lorsque vous créez une application connectée pour App Connect dans DocuSign. |
| Jeton d'accès | Le jeton d'accès généré à partir de l'identifiant et du secret du client de l'application. |
| Jeton d'actualisation | Le jeton de rafraîchissement généré à partir de l'identifiant et du secret du client de l'application. |
Pour obtenir les valeurs de connexion (clé d'intégration, clé privée RSA, ID client, secret client, jeton d'accès et jeton d'actualisation) pour DocuSign, voir Obtention des valeurs de connexion pour DocuSign.
Pour vous connecter à un point de terminaison DocuSign à partir de la page Applications et API de App Connect Designer pour la première fois, développez DocuSign, puis cliquez sur Connecter. Pour plus d'informations, voir Gestion des comptes.
Avant d'utiliser le compte créé dans App Connect dans un flux, renommez le compte en quelque chose de significatif qui vous aidera à l'identifier. Pour renommer le compte sur la page Applications et API, sélectionnez le compte, ouvrez son menu d'options (⋮), puis cliquez sur Renommer le compte.
Considérations générales
Avant d'utiliser App Connect Designer avec DocuSign, prenez note des considérations suivantes :
- (Considération générale) Vous pouvez consulter les listes des événements déclencheurs et des actions disponibles sur la page Applications et API du concepteur App Connect.
Pour certaines applications, les événements et les actions dépendent de l'environnement et de la prise en charge par le connecteur des événements configurables et de la découverte dynamique des actions. Si l'application prend en charge les événements configurables, un lien Afficher plus d'événements configurables apparaît sous la liste des événements. Si l'application prend en charge la découverte dynamique des actions, un lien Afficher plus apparaît sous la liste des actions.
- (Considération générale) Si vous utilisez plusieurs comptes pour une application, l'ensemble des champs affichés lorsque vous sélectionnez une action pour cette application peut varier d'un compte à l'autre. Dans l'éditeur de flux, certaines applications fournissent toujours un ensemble de champs statiques pour une action. D'autres applications utilisent la découverte dynamique pour récupérer l'ensemble des champs configurés sur l'instance à laquelle vous êtes connecté. Par exemple, si vous avez deux comptes pour deux instances d'une application, le premier compte peut utiliser des paramètres prêts à être utilisés immédiatement. Cependant, le deuxième compte peut être configuré avec des champs personnalisés supplémentaires.
Événements et actions
DocuSign événements
Ces événements concernent les modifications apportées à l'application qui déclenchent l'exécution des actions prévues dans le flux.
DocuSign actions
Votre flux accomplit ces actions sur cette application.
| Objet | Opération | Descriptif |
|---|---|---|
| Pièces jointes | Créer une association | Crée une pièce jointe dans DocuSign |
| Supprimer la pièce jointe | Supprime une ou plusieurs pièces jointes d'un projet d'enveloppe | |
| Récupérer les pièces jointes | Renvoie une liste de pièces jointes associées à l'enveloppe spécifiée | |
| Mettre à jour l'association | Mise à jour d'une pièce jointe à un brouillon ou à une enveloppe en cours de traitement | |
| Documents | Création ou mise à jour en masse d'un document | Mettre à jour ou créer une pièce jointe à un brouillon ou à une enveloppe en cours de traitement |
| Supprimer un document | Supprime un ou plusieurs documents d'une enveloppe existante qui n'a pas été complétée | |
| Récupérer des documents | Récupère un seul document ou tous les documents d'une enveloppe | |
| Destinataires des enveloppes | Création ou mise à jour en masse d'un destinataire | Mise à jour ou création d'un destinataire pour un projet d'enveloppe ou correction des informations relatives à un destinataire pour une enveloppe en cours de traitement |
| Supprimer le destinataire | Supprime un destinataire d'un brouillon ou d'une enveloppe envoyée | |
| Récupérer les destinataires | Récupère le statut de tous les destinataires dans une seule enveloppe et identifie le destinataire actuel dans la liste de routage | |
| Enveloppes | Créer une enveloppe | Création et envoi d'une enveloppe ou création d'un brouillon d'enveloppe |
| Récupérer les enveloppes | Récupère les enveloppes DocuSign | |
| Enveloppe de mise à jour | Mise à jour d'une enveloppe |
Exemples
Utilisez des modèles pour créer rapidement des flux pour DocuSign
Apprenez à utiliser des App Connect pour créer rapidement des flux qui effectuent des actions sur des fichiers DocuSign. Par exemple, ouvrez Discover, puis recherchez DocuSign.