Integrierte Erlebnisse für elektronische Unterschriften und Dokumente erstellen
Erfahrt, wie ihr mit Acrobat Sign-APIs Erlebnisse für elektronische Unterschriften und Dokumente in eure Web-Plattformen sowie in Content- und Dokumentenmanagementsysteme einbettet. Dieses praktische Tutorial besteht aus vier Teilen.
Teil 1: Was du brauchst
Im ersten Teil lernst du, wie du mit allem anfängst, was du für die Teile 2-4 brauchst. Wir beginnen mit dem Abrufen von API-Zugangsberechtigungen.
-
Python 3.x
- Mac - Homebrew
- Linux - Integriertes Installationsprogramm
- Windows - Chocolatey
- Alle — https://www.python.org/downloads/
Teil 2: Wenig Code/kein Code - die Leistungsfähigkeit von Webformularen
Im zweiten Teil des Tutorials lernst du die Optionen kennen, mit denen du Web-Formulare mit wenig oder ohne Code ausfüllen kannst. Es ist immer eine gute Idee, zu sehen, ob man es vermeiden kann, zuerst Code zu schreiben.
-
Über das Entwicklerkonto auf Acrobat Sign zugreifen
-
Wählen Sie auf der Startseite Publish a web form aus.
-
Vereinbarung erstellen.
-
Betten Sie den Vertrag in eine einfache HTML-Seite ein.
-
Experimentieren Sie mit dynamischem Hinzufügen von Abfrageparametern.
Teil 3: Vereinbarung mit einem Formular senden und Daten zusammenführen
Im dritten Teil werden Vereinbarungen dynamisch erstellt.
Zuerst müssen Sie den Zugriff einrichten. Mit Acrobat Sign gibt es zwei Möglichkeiten, eine Verbindung über API herzustellen. OAuth-Token und Integrationsschlüssel. Sofern Sie nicht einen ganz bestimmten Grund haben, OAuth mit Ihrer Anwendung zu verwenden, sollten Sie zuerst die Integrationsschlüssel überprüfen.
-
Wählen Sie im Menü API-Informationen auf der Registerkarte Konto in Acrobat Sign Integrationsschlüssel aus.
Nachdem Sie nun Zugriff haben und mit der API interagieren können, sehen Sie, was mit der API möglich ist.
-
Navigieren Sie zu den Acrobat Sign REST API Version 6-Methoden.
-
Verwenden Sie das Token als "Bearer"-Wert.
Um Ihre erste Vereinbarung zu senden, sollten Sie wissen, wie Sie die API verwenden.
- Erstellen Sie ein temporäres Dokument und senden Sie es.
note note |
---|
NOTE |
JSON-basierte Anforderungsaufrufe verfügen über die Optionen "Model" und "Minimal Model Schema". Dadurch erhalten Sie Spezifikationen und einen minimalen Nutzlastsatz. |
Nachdem Sie eine Vereinbarung zum ersten Mal gesendet haben, können Sie die Logik hinzufügen. Es ist immer eine gute Idee, ein paar Helfer einzurichten, um Wiederholungen zu minimieren. Im Folgenden finden Sie einige Beispiele:
Validierung
Header/Auth
Basis-URI
Achten Sie darauf, wo temporäre Dokumente innerhalb des Gesamtplans des Sign-Ökosystems landen.
Vorübergehend -> Vereinbarung
Temporär -> Vorlage -> Vereinbarung
Transient -> Widget -> Vereinbarung
In diesem Beispiel wird eine Vorlage als Dokumentquelle verwendet. Dies ist in der Regel der beste Weg, es sei denn, Sie haben einen guten Grund, Dokumente dynamisch zum Signieren zu generieren (z. B. älterer Code oder Dokumentgenerierung).
Der Code ist recht einfach. Er verwendet ein Bibliotheksdokument (Vorlage) als Dokumentquelle. Der erste und der zweite Unterzeichner werden dynamisch zugewiesen. Der Status "IN_PROCESS
" bedeutet, dass das Dokument sofort gesendet wird. Außerdem wird mergeFieldInfo
zum dynamischen Ausfüllen von Feldern verwendet.
Teil 4: Einbetten von Signaturerlebnissen, Umleitungen und mehr
In vielen Fällen möchten Sie möglicherweise zulassen, dass der auslösende Teilnehmer eine Vereinbarung sofort signiert. Dies ist nützlich für kundenorientierte Anwendungen und Terminals.
Wenn Sie nicht möchten, dass die erste sendende E-Mail ausgelöst wird, können Sie das Verhalten einfach verwalten, indem Sie den API-Aufruf ändern.
So steuern Sie die Umleitung nach Signatur:
Nach dem Aktualisieren des Vereinbarungserstellungsprozesses wird im letzten Schritt die Signatur-URL generiert. Dieser Aufruf ist ebenfalls ziemlich einfach und generiert eine URL, die ein Unterzeichner verwenden kann, um auf seinen Teil des Signiervorgangs zuzugreifen.
note note |
---|
NOTE |
Beachten Sie, dass der Aufruf zur Vereinbarungserstellung technisch asynchron ist. Dies bedeutet, dass eine POST-Vereinbarungsaufforderung erfolgen kann, aber die Vereinbarung ist noch nicht fertig. Es empfiehlt sich, einen Wiederholungskreis einzurichten. Verwenden Sie einen Wiederholungsversuch oder eine andere Best Practice für Ihre Umgebung. |
Wenn alles zusammengestellt ist, ist die Lösung ziemlich einfach. Sie treffen eine Vereinbarung und generieren dann eine Signatur-URL, auf die der Unterzeichner klicken und mit dem Signaturritual beginnen kann.
Weitere Themen
-
Webhook-Ereignisse
-
Benutzerdefinierte Erinnerungen
-
Mit der ersten Erstellung
-
Oder fügen Sie einen in Bearbeitung hinzu.
-