Créer des expériences documentaires et de signature électronique intégrées

Découvrez comment utiliser les API Acrobat Sign pour incorporer la signature électronique et les expériences documentaires dans vos plateformes web et systèmes de gestion de contenu et de documents. Ce tutoriel pratique se divise en quatre parties.

Partie 1 : Ce dont vous avez besoin

Dans la première partie, découvrez comment commencer à utiliser tout ce dont vous avez besoin pour les parties 2 à 4. Commençons par obtenir les identifiants d’API.

 Voir les détails sur l’obtention des identifiants d’API

Partie 2 : Code faible/sans — la puissance des formulaires web

Dans la partie 2, explorez l’option low/no-code de l’utilisation de formulaires web. Il est toujours judicieux d’éviter d’écrire du code au début.

 Affichage des détails sur la création d’un formulaire web

  1. Accédez à Acrobat Sign avec votre compte développeur.

  2. Sélectionner Publication d’un formulaire web sur la page d’accueil.

    Capture d'écran page d'accueil Acrobat Sign

  3. Créez votre accord.

    Capture d’écran de la création d’un formulaire web

  4. Incorporez votre accord dans une page de HTML plate.

  5. Essayez d'ajouter des paramètres de requête de manière dynamique.

    Capture d'écran de l'ajout de paramètres

Partie 3 : Envoi d’un accord avec un formulaire et fusion des données

Dans la partie 3, créez des accords de manière dynamique.

 Affichage des détails sur la création dynamique d’accords

Tout d’abord, vous devez établir l’accès. Avec Acrobat Sign, il existe deux façons de se connecter via l’API. Jetons OAuth et clés d’intégration. À moins que vous n’ayez une raison très spécifique d’utiliser OAuth avec votre application, vous devez d’abord explorer les clés d’intégration.

  1. Sélectionner Clé d’intégration dans le Informations API sous le menu Compte dans Acrobat Sign.

    Capture d’écran indiquant où trouver la clé d’intégration

Maintenant que vous avez accès à l’API et pouvez interagir avec celle-ci, découvrez ce que vous pouvez faire avec elle.

  1. Accédez à l’onglet Méthodes de l’API REST Acrobat Sign version 6.

    Capture d’écran des méthodes de navigation de l’API REST Acrobat Sign version 6

  2. Utilisez le jeton en tant que valeur "porteur".

    Capture d’écran de la valeur du porteur

Pour envoyer votre premier accord, il est préférable de comprendre comment utiliser l’API.

  1. Créez un document temporaire et envoyez-le.
REMARQUE

Les appels de requête basés sur JSON ont une option "Modèle" et "Schéma de modèle minimal". Cela donne des spécifications et une charge utile minimale définie.

Capture d'écran de la création d'un document temporaire

Après avoir envoyé un accord pour la première fois, vous êtes prêt à ajouter la logique. Il est toujours judicieux de créer des assistants pour limiter les répétitions. Voici quelques exemples :

Validation

Capture d'écran de la logique de validation

En-têtes/authentification

Capture d'écran de la logique headers/auth

URI de base

Capture d'écran de la logique URI de base

Soyez conscient de l’emplacement des documents transitoires dans le grand schéma de l’écosystème Sign.
Transitoire -> Accord temporaire -> Modèle -> Accord temporaire -> Widget -> Accord

Cet exemple utilise un modèle comme source de document. C’est généralement le meilleur itinéraire, sauf si vous avez une bonne raison de générer dynamiquement des documents pour signature (par exemple, génération de code hérité ou de documents).

Le code est assez simple ; il utilise un document de bibliothèque (modèle) pour la source du document. Les premier et second signataires sont assignés dynamiquement. La IN_PROCESS état signifie que le document est envoyé immédiatement. En outre, mergeFieldInfo permet de remplir les champs de manière dynamique.

Capture d'écran du code pour ajouter dynamiquement des signatures

Partie 4 : Intégrer l’expérience de signature, les redirections, etc.

Dans de nombreux scénarios, vous pouvez autoriser le participant déclencheur à signer immédiatement un accord. Cette fonction est utile pour les applications orientées client et les bornes interactives.

 Découvrez comment intégrer l’expérience de signature.

Si vous ne souhaitez pas que le premier e-mail d’envoi se déclenche, un moyen simple consiste à gérer le comportement en modifiant l’appel d’API.

Capture d’écran du code pour ne pas déclencher l’envoi du courrier électronique

Voici comment contrôler la redirection post-signature :

Capture d’écran du code pour contrôler la redirection post-signature

Après avoir mis à jour le processus de création de l’accord, l’étape finale consiste à générer l’URL de signature. Cet appel est également assez simple et génère une URL qu’un signataire peut utiliser pour accéder à sa partie du processus de signature.

Capture d’écran du code permettant de générer l’URL du signataire

REMARQUE

Notez que l’appel de création d’accord est techniquement asynchrone. Cela signifie qu’un appel d’accord "POST" peut être effectué, mais que l’accord n’est pas encore prêt. La meilleure pratique consiste à établir une boucle de nouvelle tentative. Utilisez une nouvelle tentative ou n’importe quelle autre bonne pratique pour votre environnement.

Capture d'écran indiquant qu'il est recommandé d'établir une boucle de nouvelle tentative

Quand tout est mis en place, la solution est assez simple. Vous créez un accord, puis générez une URL de signature sur laquelle le signataire peut cliquer pour commencer le rituel de signature.

Rubriques supplémentaires

Sur cette page