Текстовые теги — основы и синтаксис

Изучите точную структуру, которую требуют текстовые теги, чтобы ваши поля распознавались правильно и работали как ожидается.

Текстовые теги позволяют создавать поля форм путем ввода структурированных заполнителей непосредственно в документ. Они быстры и мощны, но работают только при точном соблюдении синтаксиса.

На этой странице объясняется требуемая структура текстового тега, за что отвечает каждая часть и какие правила необходимо соблюдать для правильного распознавания тегов.

Обязательное заключение тега (фигурные скобки)

Каждый текстовый тег должен быть заключен в двойные фигурные скобки:

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

Фигурные скобки обязательны и служат двум целям:

• Они сообщают Acrobat Sign, где начинается и заканчивается текстовый тег.
• Они определяют начальную ширину и высоту создаваемого поля.
  • Размер (шрифт) первой скобки определяет высоту поля. 
    • Больший кегль первой скобки создает более высокие поля.
    • Остальная часть тега может иметь другой кегль, но должна быть 2 пт или больше.
  • Пространство между скобками (включая сами скобки) определяет общую ширину поля. 
    • Более широкое расстояние между скобками создает более широкие поля
    • Пробелы учитываются.

Если фигурные скобки отсутствуют или имеют неправильный формат, текст обрабатывается как обычный текст, поле не создается, и вы увидите текст тега, напечатанный в форме после ее добавления.

Для более широкого понимания текстовых тегов и случаев их использования см. Обзор текстовых тегов.

Обязательная структура текстового тега

Внутри фигурных скобок каждый текстовый тег должен следовать этой структуре:

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

Эта структура является строгой. Изменение порядка элементов или пропуск обязательных частей может привести к скрытому сбою или нежелательному поведению.

Обязательные элементы (по порядку)

Имя поля

Имя поля идентифицирует поле формы в Acrobat Sign.

• Должно быть уникальным в документе.
• Не должно содержать пробелов.
• Используется для отчетности и извлечения данных.

Идентификатор _es_

Идентификатор _es_ сообщает Acrobat Sign, что текст представляет собой текстовый тег.

• _es_ является обязательным.
• Без него тег обрабатывается как обычный текст.

Роль подписанта

Роль подписанта определяет, какому получателю принадлежит поле.

• Всегда указывайте роль подписанта.
• Роль подписанта должна включать номер, указывающий, для какого получателя предназначено поле. 

Поддерживаемые роли подписантов

Текстовые теги назначают поля получателям, используя позиционные роли подписантов.

Поддерживаемый формат роли подписанта:

:signerN

Где N — это число, начинающееся с 1, которое соответствует позиции получателя в порядке подписания.

Примеры:

• :signer1 — первый получатель
• :signer2 — второй получатель
• :signer3 — третий получатель

Сами текстовые теги не накладывают верхнего ограничения. Роль подписанта должна соответствовать фактическому получателю в соглашении, чтобы поле было назначено.

Текстовые теги не поддерживают именованные или семантические роли. Распознаются только позиционные роли подписантов.

Исключением из правила является роль :prefill:

• :prefill — поля, которые назначаются отправителю соглашения и должны быть заполнены после отправки соглашения, но до уведомления первого подписанта.
  • Номер не используется, поскольку эта позиция предшествует фактическому циклу подписания.

Тип поля

Тип поля определяет тип создаваемого поля формы.

Распространенные примеры включают:

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

Распознаются только поддерживаемые типы полей. Неподдерживаемые типы полей игнорируются.

Полный список и поведение для конкретных полей см. в разделе Поддерживаемые типы полей текстовых тегов.

Директивы (необязательно)

Директивы изменяют поведение поля.

Примеры:

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

Директивы должны располагаться после типа поля и должны соответствовать правильному синтаксису.

Для сложных взаимодействий директив см. Расширенное поведение текстовых тегов.

Пример: полный, действительный текстовый тег

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

Этот тег:

• Использует фигурные скобки для определения границ и размера поля
• Создает текстовое поле
• Назначает первой подписывающей стороне
• Делает его обязательным
• Отображает подсказку для подписывающего

Дополнительные простые и составные примеры см. в разделе Примеры текстовых тегов.

Важные правила, которые нужно понимать с самого начала

Текстовые теги намеренно не прощают ошибок. Необходимо учесть следующие правила:

• Теги обрабатываются при добавлении документа.
• Проверка во время создания отсутствует.
• Ошибки не генерируют предупреждения.
• Неправильно сформированные теги обрабатываются как обычный текст.

Если что-то не работает, сначала предположите проблему с синтаксисом и проверьте Устранение неполадок с текстовыми тегами.