Adobe Acrobat Sign-tekstkoder er spesielt formatert tekst som kan plasseres hvor som helst i innholdet i dokumentet, som angir plassering, størrelse, type tekstfelt, som signatur- og initialfelt, avmerkingsbokser, valgknapper, skjemafelt og avanserte behandlingsregler for valgfrie felt. Tekstkoder kan også brukes ved oppretting av PDF-filer med skjemafelt. Se referansehåndboken for å opprette skjemaer i Acrobat.

Tekstkodeopplæring — Klikk for å se opplæringen

Tekstkoder konverteres til Acrobat Sign-skjemafelt når dokumentet sendes til signering eller lastes opp. Acrobat Sign-tekstkoder kan plasserer i alle dokumenttyper, for eksempel PDF, Microsoft Word, PowerPoint, Excel og tekstfiler (.txt, .rtf).

Eksempel:

{{Sig_es_:signer1:signature}}	Et signaturfelt tilordnet til mottakeren identifisert som signer1.
{{Cmpy_es_:signer2:company}}	Et felt for firmaet for mottakeren identifisert som signer2.
{{address_es_:signer1}}	Et felt for mottakeren identifisert som signer1, der adressen kan angis.
*{{city_es_:signer1}}**	Et obligatorisk felt for mottakeren identifisert som signer1, der poststed kan angis.
{{!price}}	Et skrivebeskyttet felt. Mottakere kan ikke endre verdien i dette feltet.

Acrobat Sign-tekstkoder gir en kraftig mekanisme for konfigurasjon av dokumentmaler som tillater plassering av signatur- og initialfelt, innsamling av data fra flere parter i en avtale, definisjon av valideringsregler for de innsamlede dataene og tilføying av kvalifiserende betingelser. Når et dokument er riktig konfigurert med tekstkoder, kan det brukes som en mal ved sending av dokumenter til signering, noe som sikrer at dataene som samles inn for avtalen er konsekvente og gyldige i hele organisasjonen.

Merk:

Der det er aktuelt, er funksjoner som er spesifikke for Business- og/eller Enterprise-tjenestenivåer, merket med dette.

Hurtigveiledning for tekstkoder

Eksempler på tekstkoder

Alle eksemplene nedenfor antar at kodene brukes i dokumentinnhold. Når du bruker koder som PDF-skjemafeltnavn, utelater du parentesene “{{” og “}}” som omgir teksten.

Signatur- og initialfelt

{{Sig_es_:signer1:signature}}	Et signaturfelt tilordnet til mottakeren identifisert som signer1.
{{Int_es_:signer1:initials}}	Et initialfelt tilordnet til mottakeren identifisert som signer1.
{{SigB_es_:signer1:signatureblock}}	En signaturblokk tilordnet til mottakeren identifisert som signer1.
{{OSig_es_:signer1:optsignature}}	Et valgfritt signaturfelt tilordnet til mottakeren identifisert som signer1.
{{OInt_es_:signer1:optinitials}}	Et valgfritt initialfelt tilordnet til mottakeren identifisert som signer1.
{{SigStamp_es_:signer1:stampimage(25)}}	Et stempelfelt kan brukes som signaturalternativ. Det kreves ikke stempler hvis det ikke er signaturfelt for underskriveren.

Mottakerrollefelt

Signatar- og avsenderfelt brukes for å angi mottakerrollene for en avtale.

Underskriverfelt

Rollen “signer” angir den første mottakeren (underskriver eller godkjenner) som ikke er “sender”. Rollen “signer1” angir den første mottakeren i alle tilfeller. Mottakeren som er angitt som “signer1” kan være avsenderen hvis avsenderen signerer eller godkjenner avtalen først.

{{Cmpy_es_:signer1:company}}	Et felt for mottakeren identifisert som signer1, der firmanavnet kan angis.
{{N_es_:signer2:fullname}}	Et skrivebeskyttet felt for mottakeren identifisert som signer2, der det fulle navnet kan angis.
{{Dte_es_:signer1:date}}	Et skrivebeskyttet felt som inneholder datoen for signaturen. Formatering er tillatt ved å legge til :format-direktivet. f.eks. Dte_es_signner1:date:format(dato,dd-mm-åå)
{{Em_es_:signer1:email}}	Et skrivebeskyttet felt som inneholder underskriverens e-postadresse.

Merk:

I stedet for å bruke rollene “sender” og “signer”, er en annen tilnærming å bruke bare roller som “signer1”, “signer2”, “signer3” og så videre. Pass på at disse deltakerne legges til i riktig rekkefølge ved sending av dokumentet.

Avsenderfelt

Rollen “sender” kan bare brukes når alternativet “Jeg må signere først/sist” angis under sendeprosessen. Rollen “sender” angir alltid et felt tilordnet til “sender” uavhengig av om vedkommende signerer først eller sist.

{{*Ttl_es_:sender:title}}

Et obligatorisk felt for avsenderen for angivelse av vedkommendes stilling.

Alle-felt

Hyperkobling-feltet har en spesiell (valgfri) mottakerrolle: Alle.

Når rollen er på plass, krever den at alle mottakere samhandler med feltet før de kan fullføre sin handling i avtalen.

Et klikk på hyperkoblingen er alt som kreves.

Forhåndsutfylle felt

{{price_es_:prefill}}

Et felt avsenderen fyller ut før dokumentet sendes.

Tekstfelt

{{address_es_:signer1}}	Et valgfritt felt for mottakeren identifisert som signer1, der adressen kan angis.
*{{city_es_:signer1}}**	Et obligatorisk felt for mottakeren identifisert som signer1, der poststed kan angis.

Skrivebeskyttede felt

{{!price}}

Et skrivebeskyttet felt. Underskrivere kan ikke endre verdien i dette.

Avmerkingsbokser

{{[]}}	En avmerkingsboks.
{{[x]}}	En avmerkingsboks, merket av som standard.

Valgknapper

{{(Red)Color}}

En valgknapp som har verdien Rød når valgt.

Bilder

{{Image1_es_:signer1:inlineimage(4)}}

Et felt for innebygd bilde med en høyde på fire linjer.

Feltvalidering

*{{Mobile_es_:signer1:phone}}**	Et obligatorisk felt for telefonnummer som gir telefonnummerformat for USA.
{{d_es_:signer1:num(>0,<60)}}	Et valgfritt nummerfelt som tillater verdier mellom 0 og 60.

Betingelsesregler

{{field_es_:showif(price>60)}}

Et felt som vises hvis "pris" har en verdi som er større enn 60.

Beregnede felt

{{TV_es_:calc([SubTotal]+[Tax])}}

Et felt der verdien automatisk beregnes som summen av feltene “SubTotal” og “Tax”.

Konvertering av tekstkoder til skjemafelt

Feltlengde og formatering

Når tekstkoder brukes i et redigerbart dokument, vil Acrobat Sign vise et overleggsrektangel som dekker hele lengden til tekstkoden (fra startklammeparentes ("{{") til sluttklammeparentes ("}}")), og konvertere tekstkoden til det tilsvarende Acrobat Sign-skjemafeltet.

Lengden på skjemafeltet kan økes ved å legge til blanktegn i begynnelsen av tekstkoden umiddelbart etter "{{", eller på slutten av tekstkoden like før "}}". Størrelsen på skjemafeltet kan reduseres ved å redusere skriftstørrelsen til tekstkoden for å få riktig lengde.

Formateringen for skjemafeltet (skriftstørrelse, -type, -farge og så videre) avgjøres av formatet til første “{”. For å sikre riktig behandling av tekstkoder av Acrobat Sign må kodedefinisjoner angis i en vanlig skrift i dokumentet (Helvetica, Times, Arial, Verdana eller Courier). Hvis du vil fremtvinge en bestemt feltstørrelse og/eller skrifttype ved å bruke direktiver, kan du se delen Styre feltstørrelse med direktiver.

Tekstkodedefinisjoner skiller mellom store og små bokstaver og må angis med små bokstaver.

Figuren nedenfor viser tekstkoder i et Microsoft Word-dokument.

Hele bredden til tekstkoden, fra klammeparentesen i begynnelsen til sluttklammeparentesen, må få plass på én enkelt linje. Hvis en tekstkode strekker seg over flere linjer, enten i kildedokumentet eller i den behandlede PDF-filen, vil ikke skjemafeltet gjenkjennes på riktig måte av Acrobat Sign og kan føre til at den underliggende teksten blir synlig for underskriveren ved signering av dokumentet.

Når det brukes i PDF-skjemaer, må klammeparentesene ikke inkluderes i navnet til PDF-skjemafeltene, størrelsen på feltet avgjøres av størrelsen på PDF-skjemafeltet og formateringen av dataene som angis i feltet og formateringen til dataene som angis i feltet avgjøres av egenskapene til PDF-skjemafeltet.

Ett enkelt dokument kan ikke inneholde både PDF-skjemafelt og felt som er definert med tekstkoder.

Samhandling med skjemafelt under signering

Tekstkodene ovenfor konverteres til følgende utfyllbare felt under signeringsopplevelsen:

Skjemafelt i det signerte dokumentet

Når dataene er slått sammen i det signerte dokumentet, vises følgende i den signerte PDF-filen:

Lange tekstkoder

Når det brukes i redigerbare dokumenter, kan tekstkoder som inneholder mange direktiver bli svært lange, noe som gjør det vanskelig å angi små felt i dokumentet. Acrobat Sign inneholder en enkel mekanisme som lar deg angi kortere koder i dokumentet.

Hvis du for eksempel vil tilordne et obligatorisk felt for telefonnummer til avsenderen, kan du i stedet for å angi den fullstendige

{{*Mobile_es_:signer1:phone}}-koden bruker en kortere kode, {{$mob }}, på riktig plassering i dokumentet sammen med blanktegn for å justere størrelsen på feltet. Den fullstendige definisjonen av tekstkoden

{{#mob=*Mobile_es_:signer1:phone}} kan plasseres et annet sted i dokumentet. Hvis du vil finne ut mer om forkorting av tekstkoder, kan du se Forkorting av tekstkoder.

Dypdykk i tekstkoder

Syntaks for tekstkode

En Acrobat Sign-tekstkode defineres som:

Der komponentene defineres slik:

Required – Et valgfritt flagg som angir om det bestemte feltet er obligatorisk og må fylles ut av underskriveren under signeringen. Hvis flagget ikke er angitt, er ikke feltet obligatorisk og underskriveren kan (men må ikke) fylle ut en verdi under signeringen.
ReadOnly – Et valgfritt flagg som angir at det bestemte feltet er skrivebeskyttet. Merking av et felt som skrivebeskyttet sikrer at dataene i feltet ikke kan endres av andre under signeringen. Data kan slås sammen i skrivebeskyttede felt med Acrobat Sign-API-er eller Sendes samlet via CSV før dokumentet sendes til signering.
Feltnavn – Et unikt navn for å angi dette spesifikke feltet i dokumentet. Feltnavnet brukes til å angi verdiene som angir under signering, når dataene eksporteres fra tjenesten.

Merk:

Hvis er dokument har flere enn én tekstkode med samme navn men ulike direktiver, eller disse direktivene er i en forskjellig rekkefølge i tekstkodene med samme navn, vil Acrobat Sign automatisk legge til "efelt" + unikt nummer + "_" i begynnelsen av navnet. Hvis for eksempel to felt kalt "Adresse" vises i dokumentet, endrer Acrobat Sign navnet til ett av feltene til "efelt2_Adresse".
Hvis det er to tekstkoder med samme feltnavn og samme direktiver og direktivrekkefølge i et dokument, håndteres disse feltene som kopierte felt. Data som er angitt i ett felt kopieres automatisk til den andre feltplasseringen i dokumentet.

ES-identifikator – en spesifikk tekststreng, "_es_", som må inkluderes etter feltnavnet i tekstkoden for å aktivere spesifikke Acrobat Sign-funksjoner. Hvis Acrobat Sign-identifikatoren ikke er inkludert etter feltnavnet, legges det til et tomt skjemafelt i dokumentet uten direktiver.
Direktiv – En liste over én eller flere definisjoner som begynner med et kolon (":"), som angir rolle, felttype og ekstra feltbehandlingsregler som definerer inndatatype som er tillatt i feltet. Direktiver kan defineres i vilkårlig rekkefølge.
- Rolle – Deltakeren dette feltet er tilknyttet (for eksempel sender, signer).
- Felttype – Acrobat Sign-skjemafelttypen (for eksempel signatur-, initial-, avmerkingsboks- eller tekstfelt).
- Regler – avanserte behandlingsregler, som datavalidering, logikk for å vise/skjule felt basert på betingelser og så videre.

Kontrollere feltsamhandlinger under signering

Skjemafelt i et dokument kan tilordnes til en spesifikk underskriver under arbeidsflyten for signering. Acrobat Sign sikrer at en underskriver bare kan samhandle med feltene som er tilordnet vedkommende under signering. Skjemafelt kan tilordnes til en bestemt underskriver ved å legge til et spesifikt direktiv i tekstkoden.

Tilordne skjemafelt til spesifikke underskrivere

Acrobat Sign støtter følgende direktiver for tilordning av skjemafelt til spesifikke signatarer.

{{Field2_es_:signer1}}

Et felt i avtalen som er tilordnet den første som ikke er avsender av avtalen.

{{Field3_es_:signer1}}

{{Field4_es_:signer2}}

Hvis en avtale krever flere enn én underskriver og hver underskriver må angi data under signeringen, kan felt i avtalen tilordnes til spesifikke underskrivere ved hjelp av signer<x>-direktivet der <x> er rekkefølgen underskriverne skal signere avtalen. Felt som er merket med signer1-direktivet tilordnes den første underskriveren, felt som er merket med signer2-direktivet tilordnes den andre underskriveren og så videre. Acrobat Sign sikrer at en underskriver bare kan samhandle med feltene som er tilordnet vedkommende.

Hvis avsender av avtalen signerer først under signeringen, vil alle felt merket som "signer1", i tillegg til feltet merket som "sender", presenteres for avsenderen.

Avsender forhåndsutfyller data

I noen tilfelle trenger ikke avsender å signere avtalen, men må angi data før avtalen kan sendes til signering. Dette utføres ved å legge til et "prefill"-direktiv i de relevante skjemafeltene i avtalen. Acrobat Sign lar avsender fylle ut disse feltene før avtalen sendes til signering.

{{Field5_es_:prefill}}

Et felt i avtalen som må fylles ut av avsender før avtalen sendes til signering.

Merk:

Forhåndsutfylling er aktivert som standard for dokumenter som lastes opp til Acrobat Sign-dokumentbiblioteket. Forhåndsutfylling kan også aktiveres ved å velge av alternativet "Forhåndsvis og legg til signaturfelt" ved sending av dokumenter. Hvis du vil aktivere “prefill” for alle avtaler som sendes fra Send-siden, uavhengig av om alternativet for forhåndsvisning er aktivert, kan du kontakte kundestøtte for Adobe.

Ikke tilordnede felt

Felt som ikke inneholder en rolle (eller har en stavefeil i rolledirektivet), er åpne for utfylling av alle i mottakerlisten. Når feltet er fylt ut, låses det for å hindre at etterfølgende underskrivere endrer verdien.

{{Address}}	Et felt i en avtale som kan fylles ut av alle underskrivere.
{{zip_es_:zip4}}	Et felt i en avtale der alle underskrivere kan angi et postnummer med validering.

Merk:

Hvis et ikke tildelt felt flagges som «Nødvendig», må den første mottakeren fylle inn den verdien.

Det finnes en kontroll i Kontoinnstillinger > Send-innstillinger som modifiserer kombinasjonen av ikke tildelte og obligatoriske felt slik at feltet kan flagges som obligatorisk bare for den siste mottakeren.

Grunnleggende felttyper i Acrobat Sign

En rekke felttyper kan opprettes i et dokument ved hjelp av spesifikke direktiver i tekstkoder. Acrobat Sign tolker kodene og konverterer dem til riktige skjemafelt under signering. Alle felttypene som kan legges til i et dokument i Acrobat Sign-webapplikasjonen kan også angis med tekstkoder.