Teksttags - grundlæggende og syntaks

Forstå den nøjagtige struktur, som teksttags kræver, så dine felter genkendes korrekt og opfører sig som forventet.

Teksttags giver dig mulighed for at oprette formularfelter ved at skrive strukturerede pladsholdere direkte ind i dit dokument. De er hurtige og kraftfulde, men de virker kun, når syntaksen er nøjagtig.

Denne side forklarer den påkrævede struktur af et teksttag, hvad hver del gør, og de regler, der skal følges, for at tags genkendes korrekt.

Påkrævet indkapsling af tag (krøllede parenteser)

Hvert teksttag skal være indkapslet i dobbelte krøllede parenteser:

{field-name_es_:signer-role:field-type:directive1:directive2}}

De krøllede parenteser er påkrævede og tjener to formål:

• De fortæller Acrobat Sign, hvor teksttagget begynder og slutter.
• De definerer den indledende bredde og højde af det genererede felt.
  • Størrelsen (skrifttype) af den første parentes bestemmer feltets højde. 
    • En større skriftstørrelse på den første parentes skaber højere felter.
    • Resten af tagget kan have en anden skriftstørrelse, men skal være 2 point eller større.
  • Pladsen mellem parenteserne (inklusive parenteserne selv) bestemmer feltets samlede bredde. 
    • Bredere afstand mellem parenteser skaber bredere felter
    • Mellemrum tæller med.

Hvis de krøllede parenteser mangler eller er forkert udformet, behandles teksten som almindelig tekst, der oprettes intet felt, og du vil se teksten fra tagget udskrevet på din formular, efter den er uploadet.

Se Teksttags – oversigt for at få en bredere gennemgang af teksttags, og hvornår de skal bruges.

Den påkrævede struktur for et teksttag

Inden i de krøllede parenteser skal hvert teksttag følge denne struktur:

feltnavn_es_:underskriver-rolle:felttype:direktiv1:direktiv2

Denne struktur er streng. Omorganisering af elementer eller udeladelse af påkrævede dele kan resultere i tavs fejl eller utilsigtet adfærd.

Påkrævede elementer (i rækkefølge)

Feltnavn

Feltnavnet identificerer formularfeltet i Acrobat Sign.

• Skal være unik inden for dokumentet.
• Bør ikke indeholde mellemrum.
• Bruges til rapportering og dataekstraktion.

_es_ identifikator

_es_-identifikatoren fortæller Acrobat Sign, at teksten repræsenterer et teksttag.

• _es_ er påkrævet.
• Uden den behandles tagget som almindelig tekst.

Underskriver-rolle

Underskriver-rollen definerer, hvilken modtager feltet tilhører.

• Inkludér altid en underskriver-rolle.
• Underskriver-rollen skal indeholde et tal for at angive, hvilken modtager feltet er beregnet til. 

Understøttede underskriver-roller

Teksttags tildeler felter til modtagere ved hjælp af positionsbaserede underskriver-roller.

Det understøttede underskriver-rolleformat er:

:underskriverN

Hvor N er et tal, der starter ved 1, som svarer til modtagerens position i underskriftsrækkefølgen.

Eksempler:

• :signer1 — første underskriver
• :signer2 — anden modtager
• :signer3 — tredje modtager

Der er ingen øvre grænse pålagt af selve teksttagsene. En underskriverrolle skal svare til en faktisk modtager i aftalen, for at feltet kan tildeles.

Teksttags understøtter ikke navngivne eller semantiske roller. Kun positionsbaserede underskriverroller genkendes.

Undtagelsen fra reglen er :prefill-rollen:

• :forudfyld – felter, der tildeles afsenderen af aftalen, og som skal udfyldes, efter aftalen er sendt, men før den første underskriver får besked.
  • Der bruges ikke noget tal, fordi denne position sker før den faktiske underskriftscyklus.

Felttype

Felttypen bestemmer typen af formularfelt, der oprettes.

Almindelige eksempler omfatter:

• :text
• :signature
• :dato
• :afkrydsningsfelt

Kun understøttede felttyper genkendes. Ikke-understøttede felttyper ignoreres.

For den komplette liste og feltspecifik adfærd, se Understøttede felttyper for teksttags.

Direktiver (valgfrit)

Direktiver ændrer, hvordan feltet opfører sig.

Udvalgte eksempler:

• :påkrævet
• :tooltip()
• :readOnly
• :calc()
• :format()

Direktiver skal vises efter felttypen og skal følge den korrekte syntaks.

For komplekse direktivinteraktioner, se Tekstmærkers avancerede adfærd.

Eksempel: et komplet, gyldigt tekstmærke

{full_name_es_:signer1:text:required:tooltip(Skriv dit fulde juridiske navn)}}

Dette mærke:

• Bruger krøllede parenteser til at definere feltgrænse og størrelse
• Opretter et tekstfelt
• Tildeler det til den første underskriver
• Gør det påkrævet
• Viser et værktøjstip til underskriveren

Gennemgå Teksttags – eksempler for at se yderligere enkle og sammensatte eksempler.

Vigtige regler at forstå tidligt

Teksttags kræver stor nøjagtig og efterlader ikke plads til fejl. Husk disse regler:

• Mærker behandles, når dokumentet uploades.
• Der er ingen validering på forfatteringstidspunktet.
• Fejl genererer ikke advarsler.
• Forkert udformede mærker behandles som almindelig tekst.

Hvis noget ikke virker, antag først et syntaksproblem og tjek Fejlfinding af tekstmærker.