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.

Details zum Abrufen von API-Zugangsberechtigungen anzeigen

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.

Anzeigen von Details zum Erstellen eines Webformulars
  1. Über das Entwicklerkonto auf Acrobat Sign zugreifen

  2. Wählen Sie auf der Startseite Publish a web form aus.

    Screenshot Acrobat Sign-Startseite

  3. Vereinbarung erstellen.

    Screenshot der Erstellung eines Webformulars

  4. Betten Sie den Vertrag in eine einfache HTML-Seite ein.

  5. Experimentieren Sie mit dynamischem Hinzufügen von Abfrageparametern.

    Screenshot des Hinzufügens von Abfrageparametern

Teil 3: Vereinbarung mit einem Formular senden und Daten zusammenführen

Im dritten Teil werden Vereinbarungen dynamisch erstellt.

Details zur dynamischen Erstellung von Vereinbarungen anzeigen

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.

  1. Wählen Sie im Menü API-Informationen auf der Registerkarte Konto in Acrobat Sign Integrationsschlüssel aus.

    Screenshot des Ortes, an dem der Integrationsschlüssel gefunden wird

Nachdem Sie nun Zugriff haben und mit der API interagieren können, sehen Sie, was mit der API möglich ist.

  1. Navigieren Sie zu den Acrobat Sign REST API Version 6-Methoden.

    Screenshot der Navigation in den Methoden der Acrobat Sign REST-API Version 6

  2. Verwenden Sie das Token als "Bearer"-Wert.

    Screenshot des Trägerwerts

Um Ihre erste Vereinbarung zu senden, sollten Sie wissen, wie Sie die API verwenden.

  1. 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.

Screenshot der Erstellung eines temporären Dokuments

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

Screenshot der Validierungslogik

Header/Auth

Screenshot der Header/Autorenlogik

Basis-URI

Screenshot der Basis-URI-Logik

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.

Screenshot des Codes zum dynamischen Hinzufügen von Signaturen

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.

Details zur Einbettung des Signiererlebnisses anzeigen

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.

Screenshot des Codes, um das Senden von E-Mails nicht auszulösen

So steuern Sie die Umleitung nach Signatur:

Screenshot des Codes zur Steuerung der 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.

Screenshot des Codes zum Generieren einer Unterzeichner-URL

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.

Screenshot, der besagt, dass es sich am besten eignet, eine Wiederholungsschleife einzurichten

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

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