Tekstkoder - Grunnleggende og syntaks

Forstå den nøyaktige strukturen tekstkoder krever slik at feltene dine gjenkjennes riktig og oppfører seg som forventet.

Tekstkoder lar deg opprette skjemafelt ved å skrive strukturerte plassholdere direkte inn i dokumentet ditt. De er raske og kraftige, men de fungerer bare når syntaksen er nøyaktig.

Denne siden forklarer den nødvendige strukturen til en tekstkode, hva hver del gjør, og reglene som må følges for at koder skal gjenkjennes riktig.

Påkrevd kodeavgrensning (krøllparenteser)

Hver tekstkode må være omsluttet av doble krøllparenteser:

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

Krøllparentesene er påkrevd og tjener to formål:

• De forteller acrobat sign hvor tekstkoden begynner og slutter.
• De definerer den opprinnelige bredden og høyden til det genererte feltet.
  • Størrelsen (skrift) på den første parentesen bestemmer felthøyden. 
    • En større skriftstørrelse på den første parentesen skaper høyere felt.
    • Resten av koden kan ha en annen skriftstørrelse, men må være 2pt eller større.
  • Plassen mellom parentesene (inkludert parentesene selv) bestemmer den totale bredden til feltet. 
    • Større avstand mellom krøllparenteser skaper bredere felt
    • Mellomrom teller.

Hvis krøllparentesene mangler eller er feilformatert, behandles teksten som vanlig tekst, ingen felt opprettes, og du vil se teksten til taggen skrevet ut på skjemaet ditt etter at det er lastet opp.

For en bredere orientering om teksttagger og når du skal bruke dem, se Oversikt over teksttagger.

Den nødvendige strukturen til en teksttagg

Inne i krøllparentesene må hver teksttagg følge denne strukturen:

feltnavn_es_:underskriverrolle:felttype:direktiv1:direktiv2

Denne strukturen er streng.Omorganisering av elementer eller utelatelse av nødvendige deler kan resultere i stille feil eller utilsiktet oppførsel.

Nødvendige elementer (i rekkefølge)

Feltnavn

Feltnavnet identifiserer skjemafeltet i acrobat sign.

• Må være unikt innenfor dokumentet.
• Bør ikke inneholde mellomrom.
• Brukes til rapportering og datauttrekk.

_es_ identifikator

_es_-identifikatoren forteller acrobat sign at teksten representerer en teksttagg.

• _es_ er påkrevd.
• Uten den behandles taggen som vanlig tekst.

Underskriverrolle

Underskriverrollen definerer hvilken mottaker feltet tilhører.

• Inkluder alltid en underskriverrolle.
• Underskriverrollen må inkludere et tall for å angi hvilken mottaker feltet er ment for. 

Støttede signeringsroller

Tekstkoder tildeler felt til mottakere ved hjelp av posisjonelle signeringsroller.

Det støttede formatet for signeringsrolle er:

:signerN

Der N er et tall som starter på 1 og tilsvarer mottakerens posisjon i signeringsrekkefølgen.

Eksempler:

• :signer1 — første mottaker
• :signer2 — andre mottaker
• :signer3 — tredje mottaker

Det er ingen øvre grense pålagt av tekstkodene selv.En signeringsrolle må tilsvare en faktisk mottaker i avtalen for at feltet skal bli tildelt.

Tekstkoder støtter ikke navngitte eller semantiske roller.Bare posisjonelle signeringsroller gjenkjennes.

Unntaket fra regelen er :prefill-rollen:

• :prefill — Felt som er tildelt avsenderen av avtalen, og som må fylles ut etter at avtalen er sendt, men før den første signerer blir varslet.
  • Ingen tall brukes fordi denne posisjonen skjer før den faktiske signeringssyklusen.

Felttype

Felttypen bestemmer typen skjemafelt som opprettes.

Vanlige eksempler inkluderer:

• :text
• :signature
• :date
• :checkbox

Bare støttede felttyper gjenkjennes.Ikke-støttede felttyper ignoreres.

For den fullstendige listen og feltspesifikk oppførsel, se Støttede felttyper for tekstkoder.

Direktiver (valgfritt)

Direktiver endrer hvordan feltet oppfører seg.

Eksempler inkluderer:

• :required
• :tooltip()
• :readOnly
• :calc()
• :format()

Direktiver må vises etter felttypen og må følge riktig syntaks.

For komplekse direktivinteraksjoner, se Avanserte funksjoner for tekstmerker.

Eksempel: et komplett, gyldig tekstmerke

{full_name_es_:signer1:text:required:tooltip(Enter your full legal name)}}

Dette merket:

• Bruker krøllparenteser til å definere feltgrensen og størrelsen
• Oppretter et tekstfelt
• Tilordner det til den første underskriveren
• Gjør det obligatorisk
• Viser et verktøytips til underskriveren

For flere enkle og sammensatte eksempler, se Eksempler på tekstmerker.

Viktige regler å forstå tidlig

Tekstmerker er ubarmhjertige av design.Husk disse reglene:

• Merker behandles når dokumentet lastes opp.
• Det finnes ingen validering under redigering.
• Feil genererer ikke advarsler.
• Feilformede tagger behandles som vanlig tekst.

Hvis noe ikke fungerer, anta først at det er et syntaksproblem og sjekk Feilsøking av teksttagger.