Création d’expériences de signature électronique et de document intégrées

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

Partie 1 : Ce dont vous avez besoin

Dans la partie 1, découvrez comment prendre en main tout ce dont vous avez besoin pour les parties 2 à 4. Commençons par obtenir les identifiants d’API.

Voir les détails sur la façon d’obtenir des identifiants d’API

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

Dans la deuxième partie, explorez l’option de codage faible/sans code de l’utilisation des formulaires web. Il est toujours bon de voir si vous pouvez éviter d’écrire du code au début.

Afficher des détails sur la création d’un formulaire web
  1. Accédez à Acrobat Sign avec votre compte développeur.

  2. Sélectionnez Publish un formulaire web sur la page d’accueil.

    Page d’accueil Acrobat Sign de capture d’écran

  3. Créez votre accord.

    Capture d’écran expliquant comment créer un formulaire web

  4. Incorporer votre accord sur une page de HTML plat.

  5. Testez l’ajout dynamique de paramètres de requête.

    Capture décran de lajout des paramètres de requête

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.

Afficher 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 une API. Jetons et clés d’intégration OAuth. À moins d’avoir 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électionnez Clé d'intégration dans le menu Informations sur l'API sous l'onglet Compte dans Acrobat Sign.

    Capture décran de lemplacement de la clé dintégration

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

  1. Accédez aux méthodes de l’API REST Acrobat Sign version 6.

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

  2. Utilisez le jeton comme valeur « porteur ».

    Capture décran de bearer value

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

  1. Créer un document temporaire et l’envoyer.
note note
NOTE
Les appels de requête JSON disposent d’une option « Modèle » et « Schéma de modèle minimal ». Vous obtenez ainsi des spécifications et une charge utile minimale.

Capture décran de la création dun document temporaire

Après avoir envoyé un accord pour la première fois, vous pouvez ajouter la logique. Il est toujours bon d'établir des aides pour minimiser les répétitions. En voici quelques exemples :

Validation

Capture décran de la logique de validation

En-têtes/Auth

Capture décran des en-têtes/logique dauthentification

URI de base

Capture décran de la logique URI de base

Sachez où les documents temporaires atterrissent 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 du document. Il s’agit généralement du meilleur moyen, à moins que vous n’ayez une raison sérieuse de générer dynamiquement des documents pour signature (par exemple, un code hérité ou une génération de document).

Le code est assez simple : il utilise un document de bibliothèque (modèle) comme source du document. Les premier et deuxième signataires sont attribués dynamiquement. L'état IN_PROCESS signifie que le document est envoyé immédiatement. En outre, mergeFieldInfo est utilisé pour remplir les champs de manière dynamique.

Capture d’écran du code pour ajouter des signatures de manière dynamique

Partie 4 : Intégration de l’expérience de signature, des redirections et plus encore

Dans de nombreux scénarios, vous pouvez autoriser le participant déclencheur à signer immédiatement un accord. Ceci est utile pour les applications et les kiosques orientés client.

Voir les détails sur l’intégration de l’expérience de signature

Si vous ne souhaitez pas que le premier e-mail envoyé se déclenche, une façon simple de gérer le comportement consiste à modifier l’appel API.

Capture décran du code pour ne pas déclencher lenvoi dun e-mail

Voici comment contrôler la redirection post-signature :

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

Après la mise à jour du 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 pour générer une URL de signataire

note note
NOTE
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 toute autre méthode adaptée à votre environnement.

Capture décran indiquant quil est recommandé détablir une boucle de nouvelle tentative

Lorsque tout est mis ensemble, 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

recommendation-more-help
ac8d3f8e-a625-4146-84f3-0eb730a583a3