Ingesloten ervaringen voor elektronische handtekeningen en documenten creëren

Leer hoe u Acrobat Sign API's kunt gebruiken om ervaringen voor elektronische ondertekening en documenten in te sluiten in uw webplatforms en content- en documentbeheersystemen. Deze praktische zelfstudie bevat vier onderdelen.

Deel 1: Wat u nodig hebt

In deel 1 leert u hoe u aan de slag kunt gaan met alles wat u nodig hebt voor onderdelen 2-4. Laten we beginnen met het ophalen van API-referenties.

Bekijk details over het ophalen van API-referenties

Deel 2: Weinig/Geen code — de kracht van webformulieren

In deel 2 verkent u de optie voor het gebruik van webformulieren met een lage of geen code. Het is altijd een goed idee om te zien of je kunt voorkomen dat je eerst code schrijft.

Bekijk details over het maken van een webformulier
  1. Open Acrobat Sign met uw ontwikkelaarsaccount.

  2. Selecteren Een webformulier publiceren op de startpagina.

    Schermafbeelding Acrobat Sign-startpagina

  3. Maak uw overeenkomst.

    Screenshot van hoe u een webformulier kunt maken

  4. Sluit uw overeenkomst in op een platte HTML-pagina.

  5. Experimenteer met het dynamisch toevoegen van queryparameters.

    Screenshot van het toevoegen van queryparameters

Deel 3: Overeenkomst verzenden met een formulier en gegevens samenvoegen

In deel 3 maakt u dynamisch overeenkomsten.

Bekijk details over het dynamisch maken van overeenkomsten

Ten eerste moet u toegang tot de computer tot stand brengen. Met Acrobat Sign kunt u op twee manieren verbinding maken via een API. OAuth-tokens en integratietoetsen. Tenzij u een zeer specifieke reden hebt om OAuth met uw toepassing te gebruiken, zou u de Sleutels van de Integratie eerst moeten onderzoeken.

  1. Selecteren Integratiesleutel op de API-informatie onder het menu Account in Acrobat Sign.

    Screenshot van de integratiesleutel

Nu u toegang hebt tot de API en deze kunt gebruiken, kunt u zien wat u kunt doen met de API.

  1. Ga naar de Methoden voor Acrobat Sign REST API versie 6.

    Screenshot van navigatie Acrobat Sign REST API versie 6 Methods

  2. Gebruik het token als een "toonder"-waarde.

    Schermafbeelding van waarde toonder

Om uw eerste overeenkomst te verzenden, is het beter om te begrijpen hoe u de API kunt gebruiken.

  1. Maak een document van voorbijgaande aard en verzend het.
note note
NOTE
Op JSON gebaseerde aanvraagaanroepen hebben een optie "Model" en "Minimaal Modelschema". Dit geeft specs en een minimale ladingsreeks.

Screenshot van het maken van een tijdelijk document

Nadat u een overeenkomst voor de eerste keer hebt verzonden, kunt u de logica toevoegen. Het is altijd een goed idee om wat hulpverleners op te richten om herhaling te minimaliseren. Hier volgen enkele voorbeelden:

Validatie

Screenshot van validatielogica

Kopteksten/auth

Schermafbeelding van kopteksten/auth-logica

Basis-URI

Screenshot van de Base URI-logica

Houd rekening met de plaats waar overgangsdocs aankomen binnen het grootse schema van het Sign-ecosysteem.
Overgang -> Overgangsovereenkomst -> Sjabloon -> Overgangsovereenkomst -> Widget -> Overeenkomst

In dit voorbeeld wordt een sjabloon als documentbron gebruikt. Dit is meestal de beste manier, tenzij u een solide reden hebt om documenten dynamisch te genereren ter ondertekening (bijvoorbeeld het genereren van verouderde code of documenten).

De code is vrij eenvoudig; er wordt een bibliotheekdocument (sjabloon) gebruikt voor de documentbron. De eerste en tweede ondertekenaars worden dynamisch toegewezen. De IN_PROCESS staat betekent dat het document onmiddellijk wordt verzonden. Ook: mergeFieldInfo wordt gebruikt om velden dynamisch te vullen.

Screenshot van code om handtekeningen dynamisch toe te voegen

Deel 4: Ondertekeningservaring insluiten, omleidingen en meer

In veel gevallen kunt u de activerende deelnemer toestaan om onmiddellijk een overeenkomst te ondertekenen. Dit is handig voor klantgerichte toepassingen en kiosken.

Bekijk details over het insluiten van de ondertekeningservaring

Als u niet wilt dat de eerste verzendende e-mail wordt geactiveerd, kunt u het gedrag eenvoudig beheren door de API-aanroep aan te passen.

Screenshot van code die het verzenden van e-mail niet activeert

Hieronder wordt beschreven hoe u de omleiding na ondertekening kunt beheren:

Screenshot van code voor controle over omleiding na ondertekening

Na het bijwerken van het maken van de overeenkomst genereert de laatste stap de URL voor ondertekening. Deze aanroep is ook vrij eenvoudig en genereert een URL die een ondertekenaar kan gebruiken om toegang te krijgen tot zijn deel van het ondertekeningsproces.

Screenshot van code om een ondertekenaar-URL te genereren

note note
NOTE
De aanroep van de overeenkomst is technisch asynchroon. Dit betekent dat er een 'POST'-overeenkomst kan worden aangeroepen, maar de overeenkomst is nog niet gereed. De beste manier is om een herhalingslus te creëren. Gebruik opnieuw proberen of wat dan ook de beste werkwijze voor je omgeving is.

Screenshot zegt dat het de beste manier is om een herhalingslus te creëren

Als alles samengebracht is, is de oplossing vrij eenvoudig. U maakt een overeenkomst en genereert vervolgens een ondertekenings-URL waarmee de ondertekenaar op het ondertekeningsritueel kan klikken en beginnen.

Aanvullende onderwerpen

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