Textové značky - Základy a syntaxe

Seznamte se s přesnou strukturou, kterou vyžadují textové značky, aby byla vaše pole správně rozpoznána a chovala se podle očekávání.

Textové značky vám umožňují vytvořit pole formuláře zadáním strukturovaných zástupných symbolů přímo do dokumentu.Jsou rychlé a výkonné, ale fungují pouze tehdy, když je syntaxe přesná.

Tato stránka vysvětluje požadovanou strukturu textové značky, co jednotlivé části dělají a pravidla, která musí být dodržena, aby byly značky správně rozpoznány.

Požadované uzavření značky (složené závorky)

Každá textová značka musí být uzavřena v dvojitých složených závorkách:

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

Složené závorky jsou povinné a slouží dvěma účelům:

• Říkají aplikaci Acrobat Sign, kde textová značka začína a končí.
• Definují počáteční šířku a výšku generovaného pole.
  • Velikost písma první závorky určuje výšku pole. 
    • Větší velikost písma u první závorky vytváří vyšší pole.
    • Zbytek značky může mít jinou velikost písma, ale musí být 2 pt nebo větší.
  • Prostor mezi závorkami (včetně samotných závorek) určuje celkovou šířku pole. 
    • Větší rozestup mezi složenými závorkami vytváří širší pole
    • Mezery se počítají.

Pokud složené závorky chybí nebo jsou nesprávně formátované, text je považován za prostý text, nevytvoří se žádné pole a na formuláři se po nahrání zobrazí text značky.

Pro širší orientaci v textových značkách a kdy je používat, viz Přehled textových značek.

Požadovaná struktura textové značky

Uvnitř složených závorek musí každá textová značka dodržovat tuto strukturu:

název-pole_es_:role-podepisovatele:typ-pole:direktiva1:direktiva2

Tato struktura je striktní.Změna pořadí prvků nebo vynechání požadovaných částí může vést k tichému selhání nebo neočekávanému chování.

Požadované prvky (v pořadí)

Název pole

Název pole identifikuje pole formuláře v aplikaci Acrobat Sign.

• Musí být jedinečný v rámci dokumentu.
• Neměl by obsahovat mezery.
• Používá se pro vytváření sestav a extrakci dat.

Identifikátor _es_

Identifikátor _es_ říká aplikaci Acrobat Sign, že text představuje textovou značku.

• _es_ je povinný.
• Bez něj je značka považována za prostý text.

Role podepisovatele

Role podepisovatele definuje, kterému příjemci pole patří.

• Vždy uveďte roli podepisovatele.
• Role podepisovatele musí obsahovat číslo označující, pro kterého příjemce je pole určeno. 

Podporované role podepisujících

Textové značky přiřazují pole příjemcům pomocí pozičních rolí podepisujících.

Podporovaný formát role podepisujícího je:

:signerN

Kde N je číslo začínající na 1, které odpovídá pozici příjemce v pořadí podepisování.

Příklady:

• :signer1 — první příjemce
• :signer2 — druhý příjemce
• :signer3 — třetí příjemce

Samotné textové značky neukládají žádný horní limit.Role podepisujícího musí odpovídat skutečnému příjemci ve smlouvě, aby bylo pole přiřazeno.

Textové značky nepodporují pojmenované nebo sémantické role.Rozpoznávány jsou pouze poziční role podepisujících.

Výjimkou z pravidla je role :prefill:

• :prefill — Pole, která jsou přiřazena odesílateli smlouvy a musí být vyplněna po odeslání smlouvy, ale před upozorněním prvního podepisujícího.
  • Číslo se nepoužívá, protože tato pozice nastává před skutečným cyklem podepisování.

Typ pole

Typ pole určuje typ formulářového pole, které se vytvoří.

Běžné příklady zahrnují:

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

Rozpoznávány jsou pouze podporované typy polí.Nepodporované typy polí jsou ignorovány.

Úplný seznam a chování specifické pro pole naleznete v části Podporované typy polí textových značek.

Direktivy (volitelné)

Direktivy upravují chování pole.

Příklady:

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

Direktivy se musí objevit po typu pole a musí dodržovat správnou syntaxi.

Informace o složitých interakcích direktiv naleznete v části Pokročilé chování textových značek.

Příklad: úplná, platná textová značka

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

Tato značka:

• Používá složené závorky k definování hranice a velikosti pole
• Vytváří textové pole
• Přiřazuje ho prvnímu podepisovateli
• Činí ho povinným
• Zobrazuje podepisovateli popisek

Další jednoduché a složené příklady naleznete v části Příklady textových značek.

Důležitá pravidla, která je třeba pochopit na začátku

Textové značky jsou záměrně netolerantní.Mějte na paměti tato pravidla:

• Značky se zpracovávají při nahrání dokumentu.
• Neexistuje ověřování v době vytváření.
• Chyby negenerují varování.
• Chybně formátované značky jsou považovány za prostý text.

Pokud něco nefunguje, předpokládejte nejprve problém se syntaxí a zkontrolujte Řešení problémů s textovými značkami.