Tekstlabels - Basisprincipes en syntaxis

Begrijp de exacte structuur die text tag vereisen zodat je velden correct worden herkend en zich gedragen zoals verwacht.

Text tag stellen je in staat om formuliervelden te maken door gestructureerde tijdelijke aanduidingen direct in je document te typen.Ze zijn snel en krachtig, maar werken alleen wanneer de syntaxis exact is.

Deze pagina legt de vereiste structuur van een text tag uit, wat elk onderdeel doet en de regels die moeten worden gevolgd opdat tag correct worden herkend.

Vereiste tag-omhulling (accolades)

Elke text tag moet worden omsloten in dubbele accolades:

{veld-naam_es_:ondertekenaar-rol:veld-type:richtlijn1:richtlijn2}}

De accolades zijn vereist en hebben twee doelen:

• Ze vertellen acrobat sign waar de text tag begint en eindigt.
• Ze definiëren de initiële breedte en hoogte van het gegenereerde veld.
  • De grootte (lettertype) van de eerste accolade bepaalt de veldhoogte. 
    • Een grotere Tekengrootte op de eerste accolade maakt hogere velden.
    • De rest van de tag kan een andere Tekengrootte hebben, maar moet 2pt of groter zijn.
  • De ruimte tussen de accolades (inclusief de accolades zelf) bepaalt de totale breedte van het veld. 
    • Bredere afstand tussen accolades creëert bredere velden
    • Witruimte telt.

Als de accolades ontbreken of onjuist zijn gevormd, wordt de tekst behandeld als gewone tekst, wordt er geen veld gemaakt en zie je de tekst van de tag afgedrukt op je formulier nadat het is geüpload.

Voor een bredere oriëntatie op teksttags en wanneer je ze gebruikt, zie Overzicht van teksttags.

De vereiste structuur van een teksttag

Binnen de accolades moet elke teksttag deze structuur volgen:

veldnaam_es_:ondertekenaar-rol:veldtype:richtlijn1:richtlijn2

Deze structuur is strikt.Het herordenen van elementen of het weglaten van vereiste onderdelen kan leiden tot stille fouten of onbedoeld gedrag.

Vereiste elementen (op volgorde)

Veldnaam

De veldnaam identificeert het formulierveld in Acrobat Sign.

• Moet uniek zijn binnen het document.
• Mag geen spaties bevatten.
• Wordt gebruikt voor rapportage en data-extractie.

_es_ identificatie

De _es_ identificatie vertelt Acrobat Sign dat de tekst een teksttag vertegenwoordigt.

• _es_ is vereist.
• Zonder deze wordt de tag behandeld als gewone tekst.

Ondertekenaar rol

De ondertekenaar rol definieert bij welke ontvanger het veld hoort.

• Voeg altijd een ondertekenaar rol toe.
• De ondertekenaar rol moet een nummer bevatten om aan te geven voor welke ontvanger het veld bedoeld is. 

Ondersteunde rollen voor ondertekenaars

Teksttags wijzen velden toe aan ontvangers met behulp van positionele rollen voor ondertekenaars.

Het ondersteunde formaat voor rollen van ondertekenaars is:

:signerN

Waarbij N een nummer is dat begint bij 1 en overeenkomt met de positie van de ontvanger in de volgorde van ondertekening.

Voorbeelden:

• :signer1 — eerste ontvanger
• :signer2 — tweede ontvanger
• :signer3 — derde ontvanger

Er is geen bovengrens opgelegd door teksttags zelf.Een rol van ondertekenaar moet overeenkomen met een werkelijke ontvanger in de overeenkomst om het veld toe te wijzen.

Teksttags ondersteunen geen benoemde of semantische rollen.Alleen positionele rollen voor ondertekenaars worden herkend.

De uitzondering op de regel is de :prefill rol:

• :prefill — Velden die zijn toegewezen aan de verzender van de overeenkomst en moeten worden ingevuld nadat de overeenkomst is verzonden, maar voordat de eerste ondertekenaar wordt geïnformeerd.
  • Er wordt geen nummer gebruikt omdat deze positie plaatsvindt vóór de werkelijke ondertekeningscyclus.

Veldtype

Het veldtype bepaalt het type formulierveld dat wordt gemaakt.

Veelvoorkomende voorbeelden zijn:

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

Alleen ondersteunde veldtypen worden herkend.Niet-ondersteunde veldtypen worden genegeerd.

Voor de volledige lijst en veldspecifiek gedrag, zie Ondersteunde veldtypen voor teksttags.

Richtlijnen (optioneel)

Richtlijnen wijzigen hoe het veld zich gedraagt.

Voorbeelden zijn:

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

Richtlijnen moeten na het veldtype verschijnen en moeten de juiste syntaxis volgen.

Voor complexe richtlijninteracties, zie Geavanceerd gedrag van teksttags.

Voorbeeld: een complete, geldige tekst tag

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

Deze tag:

• Gebruikt accolades om de veldgrens en -grootte te definiëren
• Creëert een tekstveld
• Wijst het toe aan de eerste ondertekenaar
• Maakt het verplicht
• Toont knopinfo aan de ondertekenaar

Voor aanvullende eenvoudige en samengestelde voorbeelden, zie Voorbeelden van teksttags.

Belangrijke regels om vroeg te begrijpen

Teksttags zijn opzettelijk onvergeeflijk.Houd deze regels in gedachten:

• Tags worden verwerkt wanneer het document wordt geüpload.
• Er is geen authoring-time validatie.
• Fouten genereren geen waarschuwingen.
• Misvormde tags worden behandeld als gewone tekst.

Als iets niet werkt, ga er dan eerst van uit dat het een syntaxisprobleem is en controleer Problemen met tekst-tags oplossen.