Texttaggar – Grundläggande och syntax

Förstå den exakta strukturen som texttaggar kräver så att dina fält känns igen korrekt och beter sig som förväntat.

Texttaggar låter dig skapa formulärfält genom att skriva strukturerade platshållare direkt i ditt dokument.De är snabba och kraftfulla, men de fungerar bara när syntaxen är exakt.

Den här sidan förklarar den nödvändiga strukturen för en texttagg, vad varje del gör och reglerna som måste följas för att taggar ska kännas igen korrekt.

Obligatorisk tagginfattning (klammerparenteser)

Varje texttagg måste omges av dubbla klammerparenteser:

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

Klammerparenteserna är obligatoriska och tjänar två syften:

• De talar om för acrobat sign var texttaggen börjar och slutar.
• De definierar den ursprungliga bredden och höjden på det genererade fältet.
  • Storleken (font) på den första klammerparentesen avgör fältets höjd. 
    • En större font size på den första klammerparentesen skapar högre fält.
    • Resten av taggen kan ha en annan font size, men måste vara 2pt eller större.
  • Utrymmet mellan klammerparenteserna (inklusive klammerparenteserna själva) avgör fältets totala bredd. 
    • Större avstånd mellan klammerparenteser skapar bredare fält
    • Blanksteg räknas.

Om klammerparenteserna saknas eller är felaktiga behandlas texten som vanlig text, inget fält skapas och du kommer att se taggens text utskriven på ditt formulär efter att det har laddats upp.

För en bredare orientering om texttaggar och när du ska använda dem, se Översikt över texttaggar.

Den obligatoriska strukturen för en texttagg

Inuti klammerparenteserna måste varje texttagg följa denna struktur:

fältnamn_es_:signerare-roll:fälttyp:direktiv1:direktiv2

Denna struktur är strikt.Omordning av element eller utelämnande av obligatoriska delar kan resultera i tyst fel eller oavsiktligt beteende.

Obligatoriska element (i ordning)

Fältnamn

Fältnamnet identifierar formulärfältet i acrobat sign.

• Måste vara unikt inom dokumentet.
• Bör inte innehålla mellanslag.
• Används för rapportering och dataextraktion.

_es_ identifierare

_es_ identifieraren talar om för acrobat sign att texten representerar en texttagg.

• _es_ krävs.
• Utan den behandlas taggen som vanlig text.

Signerarens roll

Signerarens roll definierar vilken mottagare fältet tillhör.

• Inkludera alltid en signerarens roll.
• Signerarens roll måste innehålla ett nummer för att ange vilken mottagare fältet är avsett för. 

Signeringsroller som stöds

Texttaggar tilldelar fält till mottagare med hjälp av positionsbaserade signeringsroller.

Det signeringsrollformat som stöds är:

:signerN

Där N är ett nummer som börjar på 1 och motsvarar mottagarens position i signeringsordningen.

Exempel:

• :signer1 – första mottagaren
• :signer2 – andra mottagaren
• :signer3 – tredje mottagaren

Det finns ingen övre gräns som texttaggarna själva sätter.En signeringsroll måste motsvara en faktisk mottagare i avtalet för att fältet ska kunna tilldelas.

Texttaggar stöder inte namngivna eller semantiska roller.Endast positionsbaserade signeringsroller känns igen.

Undantaget från regeln är rollen :prefill:

• :prefill – Fält som tilldelas till avtalets avsändare och som måste fyllas i efter att avtalet skickats, men innan den första signeraren meddelas.
  • Inget nummer används eftersom denna position inträffar före den faktiska signeringscykeln.

Fälttyp

Fälttypen avgör vilken typ av formulärfält som skapas.

Vanliga exempel inkluderar:

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

Endast fälttyper som stöds känns igen.Fälttyper som inte stöds ignoreras.

För den fullständiga listan och fältspecifikt beteende, se Fälttyper som stöds av texttaggar.

Direktiv (valfritt)

Direktiv ändrar hur fältet fungerar.

Exempel omfattar:

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

Direktiv måste visas efter fälttypen och måste följa korrekt syntax.

För komplexa direktivinteraktioner, se Texttaggar avancerade beteenden.

Exempel: en komplett, giltig texttagg

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

Denna tagg:

• Använder klammerparenteser för att definiera fältgräns och storlek
• Skapar ett textfält
• Tilldelar det till den första undertecknaren
• Gör det obligatoriskt
• Visar en informationsruta för undertecknaren

För ytterligare enkla och sammansatta exempel, se Texttaggar exempel.

Viktiga regler att förstå tidigt

Texttaggar är obarmhärtiga av design.Kom ihåg dessa regler:

• Taggar bearbetas när dokumentet laddas upp.
• Det finns ingen validering under framtagning.
• Fel genererar inga varningar.
• Felaktiga taggar behandlas som vanlig text.

Om något inte fungerar, anta först att det är ett syntaxproblem och kontrollera Felsökning av texttaggar.