Tagi tekstowe — podstawy i składnia

Poznaj dokładną strukturę wymaganą przez znaczniki tekstowe, aby pola były rozpoznawane poprawnie i działały zgodnie z oczekiwaniami.

Znaczniki tekstowe umożliwiają tworzenie pól formularza przez wpisywanie strukturalnych symboli zastępczych bezpośrednio w dokumencie.Są szybkie i wydajne, ale działają tylko wtedy, gdy składnia jest dokładna.

Ta strona wyjaśnia wymaganą strukturę znacznika tekstowego, funkcję każdej części oraz zasady, których należy przestrzegać, aby znaczniki były rozpoznawane poprawnie.

Wymagane otoczenie znacznika (nawiasy klamrowe)

Każdy znacznik tekstowy musi być otoczony podwójnymi nawiasami klamrowymi:

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

Nawiasy klamrowe są wymagane i służą dwóm celom:

• Informują program acrobat sign, gdzie zaczyna się i kończy znacznik tekstowy.
• Określają początkową szerokość i wysokość generowanego pola.
  • Rozmiar czcionki pierwszego nawiasu klamrowego określa wysokość pola. 
    • Większy rozmiar czcionki pierwszego nawiasu klamrowego tworzy wyższe pola.
    • Pozostała część znacznika może mieć inny rozmiar czcionki, ale musi wynosić co najmniej 2 pkt.
  • Przestrzeń między nawiasami klamrowymi (włącznie z samymi nawiasami) określa całkowitą szerokość pola. 
    • Większe odstępy między nawiasami klamrowymi tworzą szersze pola
    • Białe znaki mają znaczenie.

Jeśli nawiasy klamrowe są brakujące lub nieprawidłowo sformułowane, tekst jest traktowany jako zwykły tekst, nie jest tworzone żadne pole i po przesłaniu formularza zobaczysz tekst znacznika wydrukowany na formularzu.

Aby uzyskać szersze wprowadzenie do znaczników tekstowych i informacje o tym, kiedy ich używać, zobacz Przegląd znaczników tekstowych.

Wymagana struktura znacznika tekstowego

Wewnątrz nawiasów klamrowych każdy znacznik tekstowy musi mieć następującą strukturę:

nazwa-pola_es_:rola-podpisującego:typ-pola:dyrektywa1:dyrektywa2

Ta struktura jest ścisła.Zmiana kolejności elementów lub pominięcie wymaganych części może spowodować ciche niepowodzenie lub niezamierzone zachowanie.

Wymagane elementy (w kolejności)

Nazwa pola

Nazwa pola identyfikuje pole formularza w produkcie acrobat sign.

• Musi być unikalna w dokumencie.
• Nie powinna zawierać spacji.
• Jest używana do raportowania i wyodrębniania danych.

identyfikator _es_

identyfikator _es_ informuje produkt acrobat sign, że tekst reprezentuje znacznik tekstowy.

• _es_ jest wymagane.
• Bez niego znacznik jest traktowany jako zwykły tekst.

Rola podpisującego

Rola podpisującego określa, do którego odbiorcy należy pole.

• Zawsze uwzględnij rolę podpisującego.
• Rola podpisującego musi zawierać numer wskazujący, dla którego odbiorcy pole jest przeznaczone. 

Obsługiwane role podpisujących

Tagi tekstowe przypisują pola odbiorcom za pomocą pozycyjnych ról podpisujących.

Obsługiwany format roli podpisującego to:

:signerN

Gdzie N to liczba zaczynająca się od 1, która odpowiada pozycji odbiorcy w kolejności podpisywania.

Przykłady:

• :signer1 — pierwszy odbiorca
• :signer2 — drugi odbiorca
• :signer3 — trzeci odbiorca

Same tagi tekstowe nie nakładają górnego limit.Rola podpisującego musi odpowiadać rzeczywistemu odbiorcy w umowie, aby pole zostało przypisane.

Tagi tekstowe nie obsługują nazwanych ani semantycznych ról.Rozpoznawane są tylko pozycyjne role podpisujących.

Wyjątkiem od tej reguły jest rola :prefill:

• :prefill — pola przypisane do nadawcy umowy, które muszą zostać wypełnione po wysłaniu umowy, ale przed powiadomieniem pierwszego podpisującego.
  • Nie używa się liczby, ponieważ ta pozycja występuje przed rzeczywistym cyklem podpisywania.

Typ pola

Typ pola określa typ tworzonego pola formularza.

Typowe przykłady obejmują:

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

Rozpoznawane są tylko obsługiwane typy pól.Nieobsługiwane typy pól są ignorowane.

Aby uzyskać pełną listę i zachowanie specyficzne dla pól, zobacz Obsługiwane typy pól tagów tekstowych.

Dyrektywy (opcjonalne)

Dyrektywy modyfikują sposób działania pola.

Przykłady:

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

Dyrektywy muszą pojawić się po typie pola i muszą być zgodne z poprawną składnią.

Informacje o złożonych interakcjach dyrektyw można znaleźć w sekcji Zaawansowane zachowania znaczników tekstowych.

Przykład: kompletny, prawidłowy znacznik tekstowy

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

Ten znacznik:

• Używa nawiasów klamrowych do określenia granic i rozmiaru pola
• Tworzy pole tekstowe
• Przypisuje je pierwszemu podpisującemu
• Czyni je wymaganym
• Wyświetla podpowiedź dla podpisującego

Dodatkowe proste i złożone przykłady można znaleźć w sekcji Przykłady znaczników tekstowych.

Ważne zasady, które należy zrozumieć na początku

Znaczniki tekstowe są z założenia bezwzględne.Pamiętaj o tych zasadach:

• Znaczniki są przetwarzane podczas przesyłania dokumentu.
• Nie ma walidacji w czasie tworzenia.
• Błędy nie generują ostrzeżeń.
• Nieprawidłowe tagi są traktowane jako zwykły tekst.

Jeśli coś nie działa, najpierw sprawdź składnię i zobacz Rozwiązywanie problemów z tagami tekstowymi.