{{Sig_es_:signer1:signature}}
- Интеграции Adobe Acrobat Sign
- Новые возможности
- Версии и жизненный цикл продуктов
- Acrobat Sign для Salesforce
- Установка пакета
- Настройка пакета
- Руководство пользователя
- Включение аутентификации по цифровому удостоверению
- Руководство разработчика
- Руководство по расширенной настройке
- Руководство по сопоставлению и шаблонам полей
- Руководство пользователя мобильного приложения
- Руководство по автоматизации потоков
- Руководство для Document Builder
- Настройка больших документов
- Руководство по обновлению
- Заметки о выпуске
- Часто задаваемые вопросы
- Руководство по устранению неполадок
- Дополнительные статьи
- Acrobat Sign для Microsoft
- Acrobat Sign для Microsoft 365
- Acrobat Sign для Outlook
- Acrobat Sign для Word/PowerPoint
- Acrobat Sign для Teams
- Acrobat Sign для Microsoft PowerApps и Power Automate
- Соединитель Acrobat Sign для Microsoft Search
- Acrobat Sign для Microsoft Dynamics
- Acrobat Sign для Microsoft SharePoint
- Обзор
- SharePoint On-Prem: Руководство по установке
- SharePoint On-Prem: Руководство по сопоставлению шаблонов
- SharePoint On-Prem: Руководство пользователя
- SharePoint On-Prem: Заметки о выпуске
- SharePoint Online: Руководство по установке
- SharePoint Online: Руководство по сопоставлению шаблонов
- SharePoint Online: Руководство пользователя
- SharePoint Online: Руководство по сопоставлению веб-форм
- SharePoint Online: Заметки о выпуске
- Acrobat Sign для Microsoft 365
- Acrobat Sign для ServiceNow
- Acrobat Sign для HR ServiceNow
- Acrobat Sign для SAP SuccessFactors
- Acrobat Sign для Workday
- Acrobat Sign для NetSuite
- Acrobat Sign для SugarCRM
- Acrobat Sign для VeevaVault
- Acrobat Sign для Coupa BSM Suite
- Acrobat Sign для Zapier
- Документация для разработчиков Acrobat Sign
Обзор
Текстовые теги Adobe Acrobat Sign — это текст в особом формате, который можно разместить в любом месте в документе, задав местоположение, размер, тип полей, таких как поля подписи и инициалов, флажки, переключатели и поля форм, а также задав дополнительные правила обработки полей. Текстовые теги также можно использовать при создании документов PDF с применением полей форм. См. справочное руководство Создание форм в приложении Acrobat.
Текстовые теги преобразуются в поля форм Acrobat Sign при отправке документа на подпись или его загрузке. Текстовые теги Acrobat Sign можно поместить в документ любого типа: PDF, Microsoft Word, PowerPoint, Excel и текстовые файлы (.txt, .rtf).
Например:
|
Поле подписи, назначенное получателю, определенному как «signer1». |
{{Cmpy_es_:signer2:company}} |
Поле названия компании получателя, определенного как «signer2» (подписант 2). |
{{address_es_:signer1}} |
Поле адреса получателя, определенного как «signer1». |
{{*city_es_:signer1}} |
Обязательное поле города получателя, определенного как «signer1». |
{{!price}} |
Поле только для чтения. Получатели не могут изменять значение в этом поле. |
Текстовые теги Acrobat Sign предлагают мощный механизм настройки шаблонов документов для размещения полей подписи и инициалов, сбора данных нескольких сторон в соглашении, определения правил проверки собранных данных и добавления квалифицирующих условий. После правильной настройки документа с помощью текстовых тегов его можно использовать в качестве шаблона при отправке документов на подпись, предварительно проверив единообразие и актуальность данных, собранных для соглашений, во всей организации.
Где применимо, указываются возможности и функции, которые относятся к уровням «Бизнес» и «Организация».
Краткое руководство по работе с текстовыми тегами
Примеры текстовых тегов
Во всех приведенных ниже примерах предполагается, что теги используются в рамках содержимого документа. При использовании тегов в качестве имен полей форм PDF опускайте открывающие «{{» и закрывающие скобки «}}».
Поля подписи и инициалов
{{Sig_es_:signer1:signature}} |
Поле подписи, назначенное получателю, определенному как «signer1». |
{{Int_es_:signer1:initials}} |
Поле инициалов, назначенное получателю, определенному как «signer1». |
{{SigB_es_:signer1:signatureblock}} |
Блок подписи, назначенный получателю, определенному как «signer1». |
{{OSig_es_:signer1:optsignature}} |
Необязательное поле подписи, назначенное получателю, определенному как «signer1». |
{{OInt_es_:signer1:optinitials}} |
Необязательное поле инициалов, назначенное получателю, определенному как «signer1». |
{{SigStamp_es_:signer1:stampimage(25)}} |
Поле штампа, которое можно использовать в качестве варианта подписи. Штампы являются необязательными, если в документе есть другие поля для подписания. |
Поля ролей получателей
В полях подписывающей стороны и отправителя указываются роли получателей в рамках соглашения.
Поле подписывающей стороны
Роль «signer» задает первого получателя (подписывающую или утверждающую сторону), который не является «sender» (отправителем). Роль «signer1» определяет первого получателя во всех случаях. Получатель, определенный как «signer1», может быть отправителем, если отправитель сначала подписывает или утверждает соглашение.
{{Cmpy_es_:signer1:company}} |
Поле названия компании получателя, определенного как «signer1». |
{{N_es_:signer2:fullname}} |
Поле только для чтения для ввода полного имени получателя, определенного как «signer2». |
{{Dte_es_:signer1:date}} |
Поле только для чтения, содержащее дату подписи. |
{{Em_es_:signer1:email}} |
Поле только для чтения, содержащее адрес электронной почты подписывающей стороны. |
Вместо ролей «sender» и «signer» можно использовать только такие роли, как «signer1», «signer2», «signer3» и т. д. При отправке документа убедитесь, что эти участники добавлены в правильном порядке.
Поле отправителя
Роль «sender» (отправитель) можно использовать только при условии выбора пункта «Я должен подписать» -> «Первый/Последний» в процессе отправки. Роль «sender» всегда определяет поле, назначенное отправителю «sender», независимо от того, ставит ли отправитель свою подпись первым или последним.
{{*Ttl_es_:sender:title}} |
Обязательное поле для ввода должности отправителя. |
Поле «Все»
Поле Гиперссылка имеет специальную (необязательную) роль получателя: Все.
При наличии такой роли все получатели должны взаимодействовать с полем, прежде чем выполнить действие с документом.
Для этого нужно просто нажать на гиперссылку.
Предварительно заполняемые поля
{{price_es_:prefill}} |
Поле, которое отправитель заполняет перед отправкой документа. |
Текстовые поля
{{address_es_:signer1}} |
Необязательное поле для ввода адреса получателя, определенного как «signer1». |
{{*city_es_:signer1}} |
Обязательное поле города получателя, определенного как «signer1». |
Поля только для чтения
{{!price}} |
Поле только для чтения. Подписывающие стороны не могут изменять значение в этом поле. |
Флажки
{{[]}} |
Флажок. |
{{[x]}} |
Флажок, установленный по умолчанию. |
Переключатели
{{(Red)Color}} |
При выборе переключатель становится красным. |
Изображения
{{Image1_es_:signer1:inlineimage(4)}} |
Поле изображения с высотой в 4 строки. |
Проверка поля
{{*Mobile_es_:signer1:phone}} |
Обязательное поле для телефона в формате телефонных номеров США. |
{{d_es_:signer1:num(>0,<60)}} |
Необязательное поле для номера длиной от 0 до 60 цифр. |
Условные правила
{{field_es_:showif(price>60)}} |
Это поле показывается, если значение «price» (цена) больше 60 символов. |
Вычисляемые поля
{{TV_es_:calc([SubTotal]+[Tax])}} |
Поле, значение в котором рассчитывается автоматически как сумма значений полей «SubTotal» (подытог) и «Tax» (налог). |
Преобразование текстовых тегов в поля форм
Длина и форматирование поля
При использовании текстовых тегов в редактируемом документе Acrobat Sign заключает в прямоугольник весь текстовый тег (от начала «{{» до конца «}}») и преобразует его в соответствующее текстовому тегу поле формы Acrobat Sign.
Длину поля формы можно увеличить путем добавления пробелов в начале текстового тега сразу после «{{» или в конце текстового тега непосредственно перед «}}». Чтобы уменьшить размер поля формы и сделать его соответствующей длины, можно уменьшить размер шрифта текстового тега.
Форматирование поля формы (размер шрифта, тип, цвет и т. д.) определяется форматом первого символа «{». Чтобы обеспечить правильную обработку текстовых тегов Acrobat Sign, определения тегов должны задаваться в документе с использованием наиболее распространенных шрифтов (Helvetica, Times, Arial, Verdana или Courier). Чтобы применить определенный размер поля и/или стиль шрифта с помощью директив, обратитесь к разделу Настройка размера поля с помощью директив.
Определения текстовых тегов вводятся с учетом регистра и должны содержать текст в нижнем регистре.
На рисунке ниже показаны текстовые теги, размещенные в документе Microsoft Word.
Весь текстовый тег от начальной фигурной скобки до закрывающей фигурной скобки должен уместиться на одной строке. Если текстовый тег занимает несколько строк в исходном документе или в обрабатываемом PDF, Acrobat Sign неправильно распознает поле формы, и в результате при подписании документа подписывающая сторона будет видеть лежащий в его основе текст.
При использовании в формах PDF фигурные скобки не должны включаться в имя поля формы PDF, размер поля определяется размером поля формы PDF, а форматирование данных, введенных в поле, определяется свойствами поля формы PDF.
Один документ не может содержать одновременно и поля форм PDF и поля, определенные с помощью текстовых тегов.
Работа с полями форм во время подписания
В процессе подписания указанные выше текстовые теги преобразуются в следующие заполняемые поля:
Поля форм в подписанном документе
После объединения данных в подписанный документ в подписанном PDF будет отображаться следующее:
Длинные текстовые теги
При использовании в редактируемых документах текстовые теги, содержащие множество директив, могут стать очень длинными, что затруднит определение небольших полей в документе. Acrobat Sign предоставляет удобный механизм, с помощью которого можно задать более короткие теги в документе.
Например, если требуется обязательное поле для телефона, назначенное отправителю, вместо того, чтобы вставить весь тег
{{*Mobile_es_:signer1:phone}}, можно использовать более короткий тег {{$mob }} в соответствующем месте в документе, используя пробел для корректировки размера поля. Полное определение текстового тега
{{#mob=*Mobile_es_:signer1:phone}} можно разместить в другом месте в документе. Дополнительные сведения о сокращении текстовых тегов см. в разделе Сокращение текстовых тегов.
Подробные сведения о работе с текстовыми тегами
Синтаксис текстового тега
Текстовый тег Acrobat Sign определяется следующим образом.
Его компоненты имеют следующие определения:
- Обязательное — это опциональный флажок, который определяет необходимость наличия определенного поля и его заполнения подписывающей стороной во время подписания. Если флажок не установлен, поле формы является необязательным и подписывающая сторона может (но не обязана) заполнить его во время подписания.
- Только для чтения — это опциональный флажок, который указывает на то, что определенное поле доступно «только для чтения». Если пометить поле как только для чтения, это гарантирует, что никто не сможет изменить данные в поле во время подписания. Данные можно объединить в поля только для чтения с помощью API-интерфейсов Acrobat Sign или с помощью Пакетной отправки в формате CSV перед отправкой документа на подпись.
- Имя поля — это уникальное имя для идентификации данного конкретного поля в документе. Имя поля используется для определения значений, указываемых во время подписания, когда данные экспортируются из службы.
- Если в документе имеется несколько текстовых тегов с одинаковым именем, но разными директивами или эти директивы располагаются в разном порядке среди текстовых тегов с одинаковым именем, Acrobat Sign автоматически добавляет «efield» + уникальный номер + «_» в начало имени. Например, если в документе появляются два поля с именем «Address», Acrobat Sign меняет имя одного из полей на «efield2_Address».
- Если имеется два текстовых тега с одинаковым именем поля и одинаковыми директивами и порядком директив в документе, эти поля обрабатываются как клонированные поля. Данные, введенные в одно поле, автоматически клонируются в другое местоположение поля в документе.
- Идентификатор ES — это специальная текстовая строка «_es_», которая вставляется после имени поля в текстовый тег для активации особых функций Acrobat Sign. Если после имени поля не вставлен идентификатор Acrobat Sign, поле формы добавляется в документ без директив.
- Директива — это перечень из одного или нескольких определений, начинающийся с двоеточия («:»), который задает роль, тип поля и дополнительные правила обработки полей, определяющие тип вводимых данных, разрешенных для поля. Директивы можно привести в любом порядке.
- Роль — участник, с которым связано данное поле (например, отправитель, подписывающая сторона).
- Тип поля — тип поля формы Acrobat Sign (например, подпись, инициалы, флажок или текстовое поле).
- Правила — расширенные правила обработки, такие как проверка данных, логика отображения/скрытия полей при определенных условиях и т. д.
Управление полями во время подписания
Поля форм в документе можно назначить конкретной подписывающей стороне во время процесса подписания. Acrobat Sign делает так, чтобы подписывающая сторона могла работать только с теми полями, которые назначены ему/ей во время подписания. Поля форм можно назначить конкретной подписывающей стороне, добавив особую директиву в текстовый тег.
Назначение поля формы конкретным подписывающим сторонам
Acrobat Sign поддерживает следующие директивы для назначения поля формы конкретной подписывающей стороне.
{{Field2_es_:signer1}} |
Поле в соглашении, которое присваивается первому, кто не является отправителем соглашения. |
{{Field3_es_:signer1}} {{Field4_es_:signer2}} |
Если для соглашения требуется больше одной подписывающей стороны и каждой подписывающей стороне во время подписания необходимо предоставить данные, поля в соглашении можно назначить определенным подписывающим сторонам, используя директиву signer<x>, где <x> — это порядок подписания соглашения подписывающими сторонами. Поля, отмеченные директивой «signer1», назначаются первой подписывающей стороне, поля, отмеченные директивой «signer2», назначаются второй подписывающей стороне и т. д. Acrobat Sign делает так, чтобы подписывающая сторона могла работать только с теми полями, которые назначены ему/ей. Если при подписании соглашение сначала подписывает его отправитель, отправителю на подпись предоставляются все поля, помеченные как «signer1», а также поле, помеченное как «sender». |
Данные, предварительно заполняемые отправителем
В некоторых случаях отправителю не нужно подписывать соглашение, а нужно ввести данные перед отправкой соглашения на подпись. Это осуществляется путем добавления директивы «prefill» к соответствующим полям форм в соглашении. Acrobat Sign позволяет отправителю заполнить эти поля перед отправкой документа на подпись.
{{Field5_es_:prefill}} |
Поле в соглашении, которое заполняется отправителем перед отправкой соглашения на подпись. |
Предварительное заполнение включено по умолчанию для документов, загруженных в библиотеку документов Acrobat Sign. Предварительное заполнение также можно включить, установив флажок «Предпросмотр и добавление полей подписи» при отправке документов. Чтобы включить «предварительное заполнение» для всех соглашений, отправляемых со страницы «Отправка», независимо от того, включен ли параметр «Предпросмотр», обратитесь в службу поддержки Adobe.
Неназначенные поля
Поля, не имеющие роли (либо директива роли которых указана неверно), доступны для заполнения всеми пользователями в списке получателей. После того как поле заполнено, оно блокируется, чтобы следующие подписывающие стороны не смогли изменить его значение.
{{Address}} |
Поле в соглашении, которое может быть заполнено любой подписывающей стороной. |
{{zip_es_:zip4}} |
Поле в соглашении для ввода почтового индекса любой подписывающей стороной с проверкой. |
Если неназначенное поле отмечено как «обязательное», первый получатель должен указать значение в этом поле.
Параметр в разделе Параметры учетной записи > Параметры отправки позволяет настроить сочетание неназначенных и обязательных полей, чтобы сделать поле обязательным только для последнего получателя.
Основные типы полей Acrobat Sign
С помощью определенных директив в текстовых тегах в документе можно создавать поля различных типов. Во время подписания Acrobat Sign интерпретирует теги и преобразует их в соответствующие поля формы. Все типы полей, которые можно добавить в документ через веб-приложение Acrobat Sign, можно также задать посредством текстовые тегов.
Поля подписи и инициалов
Вы можете разместить поля подписи или инициалов Acrobat Sign в определенных местах в документе, добавив директиву, чтобы задать тип поля подписи. По умолчанию поля подписи и инициалов являются обязательными.
Однако для некоторых документов требуется, чтобы подписывающая сторона дополнительно поставила инициалы или подпись в определенных дополнительных местах в документе. С помощью текстовых тегов в документе также можно определить необязательные поля подписи и инициалов.
В Acrobat Sign требуется, чтобы документ содержал как минимум одну подпись от каждой подписывающей стороны документа. Во время подписания назначать поля подписей в документе утверждающим сторонам необязательно.
{{Sig1_es_:sender:signature}} |
Обязательное поле подписи, назначенное отправителю. |
{{Int1_es_:signer1:initials}} |
Обязательное поле инициалов, назначенное получателю, определенному как «signer1». |
{{OSig1_es_:signer2:optsignature}} |
Необязательное поле подписи, назначенное получателю, определенному как «signer2». |
{{OInt1_es_:signer1:optinitials}} |
Необязательное поле инициалов, назначенное получателю, определенному как «signer1». |
{{SigStamp_es_:signer1:stampimage(25)}} |
Поле штампа, которое можно использовать в качестве варианта подписи. Штампы являются необязательными, если в документе есть другие поля для подписания. |
Специальные поля ACROBAT Sign
Acrobat Sign предоставляет специальные поля, которые можно разместить в документе для сбора информации (например, должность или название компании) от подписывающей стороны. Если информация для этих полей уже доступна, Acrobat Sign автоматически заполняет эти поля во время работы подписывающей стороны над документом при подписании.
{{Ttl1_es_:title}} |
Поле для указания должности подписывающей стороны. |
{{Cmpy1_es_:company}} |
Поле для указания компании подписывающей стороны. |
Специальные поля только для чтения
Кроме того, Acrobat Sign также может собирать данные о дате подписания, адресов электронной почты и имен подписывающих сторон в документе. Эти поля заполняются Acrobat Sign автоматически и не могут быть изменены подписывающей стороной при подписании документа.
{{Dte1_es_:date}} |
Поле для автоматической записи даты подписи. |
{{Em1_es_:email}} |
Поле для автоматической записи адреса электронной почты подписывающей стороны. В случае использования веб-форм Acrobat Sign подписывающая сторона может отредактировать поле адреса электронной почты при размещении подписи в веб-форме. В зависимости от конфигурации учетной записи Acrobat Sign проверяет адрес электронной почты, предоставленный подписывающей стороной до завершения процесса подписания в веб-форме. |
{{fn1_es_:signer:firstname}} |
Поле, в котором автоматически отображается первая строка, считанная в поле подписи. Соответствует имени в подписи. |
{{ln1_es_:signer:lastname}} |
Поле, в котором автоматически отображается содержимое поля после первой строки в поле подписи. Соответствует фамилии в подписи. |
{{Name1_es_:fullname}} |
Поле для указания полного имени подписанта в одной строке. |
Блок подписи
Если для определенной подписывающей стороны в документе отсутствует поле подписи, Acrobat Sign автоматически размещает блок подписи в нижней части документа для этой подписывающей стороны. По умолчанию блок подписи включает в себя поля подписи и адреса электронной почты. Однако если для учетной записи или администратора группы включен параметр Требовать, чтобы подписывающие стороны указывали свою должность при постановке электронной подписи или Требовать, чтобы подписывающие стороны указывали название компании при постановке электронной подписи либо оба этих параметра (в меню «Настройки подписи»), поля заголовка и/или компании будут включены в блок подписи. На иллюстрации ниже показан блок подписи, который включает в себя все четыре поля.
С помощью директивы «signatureblock» в документе можно разместить весь блок подписи Acrobat Sign.
{{SBlk1_es_:signatureblock}} |
Размещает блок подписи в указанном месте документа. |
Текстовые поля
Все поля, размещаемые в документе, которые не содержат дополнительные директивы определений типов полей, обрабатываются в документе как заполняемые текстовые поля.
{{propertyName_es_:signer}} |
Определяет редактируемое текстовое поле «propertyName» в документе. |
Определение обязательных/необязательных полей
Для большинства полей можно задать, будут ли они обязательными или необязательными. Acrobat Sign делает так, чтобы подписывающая сторона не могла подписать документ, пока не будут заполнены все обязательные поля.
По умолчанию все поля являются необязательными, за исключением следующих:
- По умолчанию поля подписи и инициалов являются обязательными, кроме тех случаев, когда для определения этих полей используются текстовые теги «optsignature» или «optinitials». Дополнительную информацию об этих текстовых тегах см. в разделе Поля подписи и инициалов.
- Поля заголовка и компании являются обязательными, если в настройках вашей учетной записи требуется, чтобы они были частью блока подписи. Информацию об определенных настройках учетной записи см. в разделе Блок подписи.
Обязательное поле обозначается путем добавления префикса в виде звездочки (*) к его имени или путем добавления необходимой директивы в текстовый тег.
Например:
{{*phone_es_:signer1}} {{phone_es_:signer1:required}} {{phone_es_:prefill:required}} |
Определяет обязательное текстовое поле «phone», которое должно быть заполнено подписывающей стороной или в ходе процесса предварительного заполнения. |
{{address_es_:signer1}} |
Определяет необязательное поле «address», которое должно быть заполнено получателем «signer1». |
Обязательные поля обозначаются красной звездочкой в левой части поля.
Редактируемые поля и поля только для чтения
По умолчанию все поля, которые не предназначены только для чтения, являются редактируемыми. К исключениям относятся некоторые специальные поля подписывающих сторон (адрес электронной почты, имя подписывающей стороны и дата подписи), которые по умолчанию доступны только для чтения. Дополнительную информацию см. в разделе Специальные поля только для чтения.
Поля только для чтения оказываются полезны при автоматическом объединении данных в документ с использованием API-интерфейса Acrobat Sign или функции объединения данных Пакетной отправки. Поля только для чтения гарантируют, что подписывающая сторона не сможет изменить объединенные данные при подписании.
Добавление префикса в виде восклицательного знака (!) к имени поля или использование директивы только для чтения означает, что это поле доступно «только для чтения».
Например:
{{!price}} {{price_es_:readonly}} |
Определяет текстовое поле только для чтения, которое должно быть заполнено объединяемыми данными до отправки документа на подпись. |
Дополнительная обработка документа с использованием текстовых тегов
Дополнительные типы полей
Используя уникальные текстовые теги, можно создать следующие типы полей:
Флажки
С помощью текстовых тегов можно создать флажок, разместив тег «checkbox» в документе или используя директиву флажка.
{{[]}} |
Размещает безымянный флажок в документе. |
{{CB_es_:checkbox}} | Размещает именованный флажок в документе. |
{{[x]}} |
Размещает безымянный флажок, выбираемый в документе по умолчанию. |
{{CB1_es_:checkbox(checked)}} |
Размещает именованный флажок, выбираемый в документе по умолчанию. |
{{[]Comm_es_:signer1}} |
Размещает флажок «Comm», назначенный получателю, определенному как «signer1». |
{{Comm_es_:checkbox:signer1}} |
Размещает флажок «Comm», назначенный получателю, определенному как «signer1», с помощью директивы. |
{{[]*}} |
Безымянный обязательный флажок, который должен быть выбран получателем, определенным как «signer1». Дополнительную информацию об определении обязательных полей см. в разделе Определение обязательных/необязательных полей. |
{{CB2_es_:required:checkbox}} |
Именованный обязательный флажок, который должен быть выбран получателем, определенным как «signer1». |
{{[]!}} |
Безымянный флажок, доступный только для чтения. Дополнительную информацию об определении обязательных полей см. в разделе Определение обязательных/необязательных полей. |
{{CB3_es_:readonly:checkbox}} |
Именованный флажок, доступный только для чтения. |
{{CB4_es_:checkbox:label("I agree.")}} |
Определяет флажок с меткой для понятного описания флажка. Метка отображается для подписывающей стороны во время процесса подписания и в этом случае содержит фразу «I agree». |
Переключатели
Текстовые теги можно использовать для определения и размещения переключателей в документе. Переключатели в группе переключателей, определяемой в документе одним и тем же именем поля, должны иметь как минимум два параметра (варианта выбора). Все параметры (варианты выбора) переключателей должны иметь разные значения для выбора. Переключатели могут задаваться с использованием следующего синтаксиса.
{{(option_value)fieldname_es_}} |
Размещает переключатель в документе. |
{{(Red)Color_es_:signer1}} {{(Blue)Color_es_:signer1}} {{(Green)Color_es_:signer1}} |
Задает три переключателя, принадлежащие одной группе «Color», назначенной получателю, определенному как «signer1». Параметры имеют значения красного, синего и зеленого цвета. |
{{Color_es_:signer1:radio(Red)}} {{Color_es_:signer1:radio(Blue)}} {{Color_es_:signer1:radio(Green)}} |
Альтернативный способ задать группу переключателей «Color», используя директиву переключателей. |
{{(Red)Color_es_:signer1:label(“Red”)}} {{(Blue)Color_es_:signer1:label(“Blue”)}} {{(Green)Color_es_:signer1:label(“Green”)}} |
Определяет группу переключателей, и каждому из переключателей назначает понятная метка. Метка отображается для подписывающей стороны во время подписания. |
Указание стиля переключателей
Acrobat Sign поддерживает создание переключателей в разных стилях. Заданный стиль переключателя отображается в формате PDF. Однако при подписании параметры переключателей всегда имеют круглую форму.
Поля изображений
Поля изображений используются для вставки файлов изображений, в том числе фотографий или сканированных документов (например, водительских прав). Эти изображения можно извлечь из подписанного документа. Директива :inlineimage требует добавления дополнительного параметра, который определяет высоту поля. Высота поля рассчитывается на основе размера шрифта тега. При этом высота поля измеряется в строках для данного шрифта.
{{inlineImageEx_es_:signer1:inlineimage(20)}} |
Определяет поле изображения высотой в 20 строк. |
Многострочные текстовые поля
Текстовые теги можно использовать для определения текстовых полей, которые могут занимать несколько строк. Эти поля могут использоваться в документе для сбора нескольких строк данных во время подписания.
{{largeField_es_:signer1:multiline}} |
Задает поле, назначенное получателю, определенному как «signer1», под названием «largeField», которое позволяет во время подписания подписывающей стороне ввести несколько строк данных в поле. |
{{largeField2_es_:signer1:multiline(4)}} |
Задает поле «largeField2», назначенное получателю, определенному как «signer1». Высота этого поля — 4 строки. В случае отсутствия параметра числа строк поле поддерживает две строки данных по умолчанию. |
Раскрывающиеся списки
Текстовые теги можно использовать для определения и размещения раскрывающихся списков в документе. Раскрывающиеся списки могут содержать множество параметров. При подписании документа пользователь может выбрать один из этих параметров. Определение раскрывающегося списка содержит два компонента: уникальный набор параметров, из которых получатель может выбрать один вариант и дополнительно набор значений, возвращаемых при экспорте данных из соглашения.
Параметры раскрывающегося списка должны быть уникальными, а его значения — нет (т. е. несколько параметров раскрывающегося списка могут иметь одинаковое значение, экспортированное из них). Значения раскрывающегося списка являются опциональными. Если значения раскрывающегося списка не заданы, параметры раскрывающегося списка возвращаются при экспорте данных из соглашения.
Если значения раскрывающегося списка заданы, количество значений должно совпадать с количеством параметров. Если количество параметров не совпадает с заданными значениями, может возникнуть ошибка, и поле не будет рассматриваться как раскрывающийся список.
При определении выбора по умолчанию для раскрывающегося списка или определении условий для другого поля на основании выбора получателем одного из параметров в раскрывающемся списке необходимо использовать значения (не параметры) экспорта. Если значения экспорта не заданы, используйте параметры раскрывающегося списка.
{{*Color_es_:signer1:dropdown(options="Red,Green, Blue”)}} |
Размещает необходимый раскрывающийся список в документе. Во время подписания получатель, определенный как «signer1», может выбрать один из трех доступных вариантов. В этом раскрывающемся списке не заданы какие-либо значения экспорта, в результате выбранный параметр экспортируется со страницы «Управление» посредством API-интерфейса или со страницы «Отчеты». |
{{Color_es_:signer1:dropdown(options="Red,Green,B lue”, values=”R,G,B”)}} |
Размещает раскрывающийся список в документе. Во время подписания получатель, определенный как «signer1», может выбрать один из трех доступных параметров. В этом случае раскрывающийся список также задает возможные значения экспорта (R, G, B). В зависимости от параметра, выбранного получателем во время подписания, со страницы «Управление» посредством API-интерфейса или со страницы «Отчеты» экспортируются соответствующие значения. Например, если получатель выбирает параметр «Red», экспортируемым значением является «R». |
{{Color_es_:signer1:dropdown(options="Red,Green,Blue”, values=”R,,B”)}} |
В этом примере раскрывающийся список содержит те же параметры, что и в предыдущем примере, но одно из значений является пустым. Если во время подписания получатель, определенный как «signer1», выбирает «Green» в раскрывающемся списке, никакое значение не экспортируется для данного поля. |
{{Color_es_:signer1:dropdown(options="Red,,Blue”, values=”R,G,B”)}} |
В этом примере раскрывающийся список во время подписания предоставляет получателю, определенному как «signer1», три параметра, при этом второй параметр пустой. Если получатель выбирает пустой параметр, экспортируемым значением является «G». |
При необходимости в определение раскрывающихся полей можно добавить дополнительные директивы, например сделать раскрывающийся список обязательным, применить к раскрывающимся спискам условную логику или указать, что параметр, выбранный получателем, должен быть скрыт в PDF.
Сопутствующие документы (вложенные файлы)
Acrobat Sign можно использовать для сбора сопутствующих документов от подписывающих сторон во время подписания. При подписании Acrobat Sign преобразует текстовый тег в поле, которое подписывающая сторона могла выбрать для загрузки файла. Один или несколько загруженных документов становятся частью подписанного документа, преобразуются в файл PDF и прикладываются в конце подписанного соглашения после завершения процесса подписания. Поля форм для сбора файлов от подписывающей стороны определяются с помощью директивы «attachment».
{{*DriversLicense_es_:signer1:attachment}} |
Задает обязательное поле «DriversLicense», назначенное получателю, определенному как «signer1». Получатель должен использовать это поле для загрузки файла во время подписания. |
{{photo_es_:signer1:attachment:label("Photo")}} |
Задает необязательное поле «photo», назначенное получателю, определенному как «signer1». Получатель может использовать это поле для загрузки изображения во время подписания. Метка директивы может использоваться в качестве удобного описания поля. Метка отображается для подписывающей стороны во время подписания. |
Определение поля вложенного файла:
Предоставляемое во время подписания поле вложенного файла:
Гиперссылки
Acrobat Sign можно использовать, чтобы задать гиперссылки в документах. Получатель может щелкнуть гиперссылку во время подписания и перейти к месту в документе или на внешний URL-адрес. Для гиперссылок также можно задать метки, чтобы в документе отображались текстовые метки, вместо прямых URL-адресов.
Обычно поля гиперссылок позволяют получателям по какой-либо причине перейти на другую страницу. При использовании в качестве дополнительной ссылки определять роли получателя не требуется. Поле останется активной ссылкой, на которую сможет нажать любой получатель.
Поля гиперссылок также можно определить как обязательные. При настройке поля в качестве обязательного роль получателя необходима для определения того получателя, который должен нажать на ссылку.
- Назначенный получатель не сможет завершить действие до нажатия на ссылку.
- Ссылка останется активной (но не обязательной) для всех других получателей.
Кроме того, поле «Гиперссылка» содержит уникальную роль получателя: Все. При использовании роли Все в сочетании с флажком Обязательно, все получатели будут обязаны нажать на поле гиперссылки, чтобы завершить действие.
{{companywebsite_es_:link(http://www.adobe.com):label(Adobe)}} |
Задает гиперссылку, которая привязывается к внешнему URL-адресу. Включает метку «Adobe», которую видит получатель во время подписания. |
{{doclink_es_:link:page(10):label(View this section)}} |
Задает гиперссылку, которая привязывается к странице 10 в текущем документе. Включает метку «Просмотр этого раздела», которую видит получатель во время подписания. |
{{*companyToU_es_:everyone:link(https://www.adobe.com/ru/legal/terms.html):label(Условия использования)}} |
Определяет обязательную гиперссылку, на которую должны нажать все получатели. Включает метку «Условия использования», которую видит получатель во время подписания. |
Штампы участников и идентификаторы транзакций (только уровни обслуживания «Бизнес» и «Организация»)
Для подписывающих сторон к подписанным документам PDF могут быть добавлены штампы участников и идентификаторы транзакций. После подписания или утверждения участником в документе появляется штамп этого участника. В штамп участника включено имя участника, время подписания/утверждения события и адрес электронной почты. Идентификаторы транзакций и штампы отображаются в готовом подписанном документе PDF.
{{userstamp1_es_:signer1:stamp}} |
Задает штамп участника для получателя, определенного как «signer1». Такой штамп отображается в готовом подписанном документе PDF. |
{{userstamp2_es_:signer2:stamp}} |
Задает штамп участника для получателя, определенного как «signer2». Такой штамп отображается в готовом подписанном документе PDF. |
{{transstamp2_es_:transactionid}} |
Задает штамп идентификатора транзакции, который отображается в готовом подписанном документе PDF. |
{{userstamp_es_:signer1:stamp:repeat}} {{transstamp1_es_:transactionid:repeat}} |
Задает штамп, который отображается в одном и том же месте на всех страницах в готовом подписанном документе PDF. |
Цифровые подписи (только уровень обслуживания «Организация»)
В документы можно добавлять цифровые подписи. В одном документе одной подписывающей стороной может быть поставлена только одна цифровая подпись. Если одна подписывающая сторона ставит больше одной цифровой подписи (например, {{digsig1_:signer1: digitalsignature}} и {{digsig2_:signer1: digitalsignature}}), сохраняется только первая подпись, а другие удаляются автоматически при отправке документа на подпись, кроме тех случаев, когда она удаляется вручную на стадии предварительного просмотра и авторинга перед отправкой.
{{digsig1_es_:signer1:digitalsignature}} |
Задает цифровую подпись для получателя, определенного как «signer1». |
Подписи штампа
Штампы можно использовать для двух целей: они могут заменить поле подписи и применяться организациями, которые предпочитают использовать в качестве подписи штамп предприятия; кроме того, их можно использовать для добавления традиционной для некоторых стран подписи (например, печати ханко). Так же, как поля цифровой подписи, для каждого получателя можно определить только одно поле печати. Поля штампов являются необязательными по умолчанию, если пользователь не выбрал иное или если для подписывающей стороны не определены другие поля подписи.
Для полей штампа требуется добавление дополнительного параметра в директиву :stampimage (определяет высоту поля). Высота поля измеряется количеством строк (на основе размера шрифта текстового тега).
{{Stamp1_es_:signer1:stampimage(28)}} |
Определяет поле штампа высотой в 28 строк для получателя с идентификатором «signer1». |
Указание значения по умолчанию
С помощью текстовые тегов в Acrobat Sign можно задать значение по умолчанию для поля. Во время подписания заданное значение по умолчанию показывается участникам.
Директива текстового тега |
Пример |
---|---|
:default |
:default("Значение по умолчанию задано в двойных кавычках") :default('Значение по умолчанию задано в одинарных кавычках') |
Если значение по умолчанию содержит одинарные кавычки или апостроф, само значение по умолчанию должно быть заключено в двойные кавычки. Например: {{location_es_:signer1:default("Signer's Business")}}. Если внутри значения по умолчанию требуются двойные кавычки, само значение по умолчанию должно быть взято в одинарные кавычки.
Указание подсказки
Текстовые теги также позволяют задавать Подсказки для полей форм Acrobat Sign. Получатель видит подсказки во время подписания.
Директива текстового тега |
Пример |
---|---|
:tooltip |
:tooltip("Предоставьте копию водительских прав") :tooltip('Выберите цвет') |
Настройка размера поля с помощью директив
Директива «:dimension» позволяет настроить высоту и ширину поля, а также переопределить значение в фигурных скобках.
Эту директиву можно использовать для документов, создаваемых в системе, которая не позволяет изменять размер шрифта.
Форма директивы: :dimension(width=XXnn, height=YYmm),
где XX и YY — числовые значения измерения, а тип приращения определяется значениями nn и mm.
- Числовые значения — это десятичные числа, имеющие до 5 знаков после запятой.
- Допустимые типы приращений
- pt — пункты (каждый пункт равен 1/72 дюйма). Пункты используются по умолчанию, если другой тип приращения не указан.
- in — дюймы.
- cm — сантиметры.
- mm — миллиметры.
{{BigSig_es_:signer1:signature:dimension(width=35mm, height=12mm)}} |
Поле подписи, размер которого равен 35 мм в ширину и 12 мм в высоту. |
Если тип приращения фиктивен или директива :dimension сформирована неправильно, тег игнорирует директиву и использует размер поля, указанный в фигурных скобках.
Определение вида шрифта
С помощью текстовых тегов можно изменить вид шрифта поля с тем, чтобы переопределить вид шрифта, используемый в текстовом теге для названия, цвета и размера шрифта. В качестве имени шрифта можно использовать имя любого шрифта в существующем документе или одного из следующих шрифтов: Lato, Roboto, Slabo 13px, Source Serif Pro, Source Sans Pro и Source Code Pro. Чтобы задать цвет, используйте шестнадцатеричное значение RGB или любое из следующих допустимых значений цвета: белый, светло-серый, темно-серый, черный, красный, розовый, оранжевый, желтый, зеленый, пурпурный, голубой или синий. По умолчанию название и размер шрифта — это название и размер первой скобки «{» в начале текстового тега.
Директива текстового тега |
Пример |
---|---|
:font |
:font(name=Lato, color=#FF0000, size=12) — задает вид поля: шрифт «Lato», красный цвет текста и размер шрифта 12 пунктов
:font(name=Source Code Pro, color=green, size=14) — задает вид поля: шрифт «Source Code Pro», зеленый цвет текста и размер шрифта 14 пунктов |
Указание выравнивания полей
Текстовые теги можно использовать для выравнивания значений, вводимых в поля форм. По умолчанию значения в полях форм выровнены. Однако при использовании директив в текстовых тегах поля форм можно выровнять по центру или по правому краю.
Директива текстового тега |
Пример |
---|---|
:align(alignment) |
:align(left) — выравнивает текст в поле по левому краю. Это поведение полей форм по умолчанию, и соответствие директиве не требуется. :align(right) — выравнивает текст в поле по правому краю. :align(center) — выравнивает данные, введенные в поле формы, по центру. |
Указание повторения полей
С помощью текстовых тегов можно повторить одни и те же поля на каждой странице в документе, не копируя текстовый тег на каждой странице. Например, это может быть крайне полезно для полей подписей или штампов участников в больших документах.
Директива текстового тега |
Пример |
---|---|
:repeat |
:stamp:repeat — копирует штамп участника в одно и то же место на каждой второй странице в документе. Обязательно задайте роль подписывающей стороны для штампа. (Например, signer1, signer2.) :signature:repeat — копирует поле подписи в одно и то же место на каждой второй странице в документе. Обязательно задайте роль подписывающей стороны для штампа. (Например, signer1, signer2.) :repeat(even) — копирует поле в одно и то же место на четных страницах документа. :repeat(odd) — копирует поле в одно и то же место на нечетных страницах документа. :repeat(after) — копирует поле в одно и то же место на всех страницах после той страницы, на которую было добавлено поле. :repeat(before) — копирует поле в одно и то же место на всех страницах до той страницы, на которую было добавлено поле. :repeat(2,10), :repeat(6-9), :repeat(2,6-9) — копирует поле в одно и то же место на указанных страницах или диапазонах страниц документа. |
Определение правил проверки данных
Acrobat Sign поддерживает различные типы проверки полей, задаваемые дополнительными директивами текстовых тегов. Заданные правила проверки данных применяются, когда подписывающая сторона заполняет данные во время подписания. У получателя не получится завершить процесс подписания в Acrobat Sign, если введенные данные не соответствуют заданному правилу проверки.
Например:
{{*Mobile_es_:signer1:phone}} |
Задает обязательное поле «Mobile», назначенное получателю, определенному как «signer1». Во время подписания получатель должен указать в этом поле действительный номер телефона. |
{{Birthday_es_:signer2:isdate}} |
Задает поле «Birthday», назначенное получателю, определенному как «signer2». Во время подписания получатель должен ввести значение даты. |
Некоторые типы проверки полей могут иметь дополнительные параметры, которые ограничивают разрешенные значения в поле.
{{duration_es_:signer1:num(>=0,<=60)}} |
Задает необязательное поле «duration», значение которого должно быть между 0 и 60. |
{{tenNum_es_:signer1:string(char=num,maxlen=10)}} |
Задает необязательное поле «tenNum», которое разрешает ввод максимум 10 цифр. |
Поддерживаемые правила проверки полей
Тип проверки | Директива текстового тега | Дополнительные параметры и значения | Примеры | |
---|---|---|---|---|
Строка | :string | char | alpha — только буквы | :string |
:string(char=alpha) | ||||
:string(char=num) | ||||
:string(char=alphanum) | ||||
num — только цифры | ||||
alphanum — буквы и цифры | :string(maxlen=10) | |||
maxlen | Определенная максимальная длина | :string(char=alpha,maxlen=10) | ||
Номер | :num | >= | Больше или равно | :num |
:num(<=1000) | ||||
<= | Меньше или равно | :num(>=50,<=500) | ||
Валюта | :curr | country | :curr | |
:curr(country=us) | ||||
:curr(country=uk) | ||||
>= | :curr(<=500) | |||
<= | :curr(country=us,<=100) | |||
Процент | :pct | >= | Больше или равно | :pct |
:pct(>=50) | ||||
<= | Меньше или равно | :pct(>=0,<=100) | ||
Дата | :isdate | format | mm/dd/yy (по умолчанию) | :isdate |
mm/dd/yyyy | :isdate(format=dd/mm/yy) | |||
dd/mm/yy | ||||
dd/mm/yyyy | ||||
mm/yy | ||||
"mmm d, yyyy" | :isdate(format="mmm d, yyyy") | |||
Запятые являются специальными разделителями. Если запятые используются в выражении форматирования, это выражение необходимо заключить в кавычки. |
||||
Время | :time | :time | ||
Электронная почта | :isemail | :isemail | ||
Почтовый индекс | :zip | country | us — формат почтового индекса США по умолчанию | :zip |
uk — формат почтового индекса Великобритании по умолчанию | :zip(country=uk) | |||
Индекс + 4 | :zip4 | :zip4 | ||
Телефон | :phone | country | us — формат телефонного номера США по умолчанию | :phone |
uk — формат телефонного номера Великобритании по умолчанию | :phone(country=uk) | |||
Номер социального страхования | :ssn | :ssn | ||
Регулярное выражение | :custom | regexp | Регулярное выражение, представленное в виде строки. См. примечание ниже. | :custom(regexp="^5[1-5][0- |
msg | Сообщение, которое видит получатель, если данные не соответствуют указанному выражению. | :custom(regexp="^.{3}$",msg="Not a match for three chars in a row!") |
- Не зависящие от регистра метасимволы «?i» и «?-a» не поддерживаются
- В данном синтаксисе символ обратной косой черты, который является частью такой конструкции регулярного выражения, как «\w», всегда должен отделяться обратной косой чертой, т. е. «\\w».
- Для поиска обратной косой черты необходимо использовать \\\\.
- Строка регулярного выражения начинается и заканчивается двойными кавычками (").
- Если ожидается, что в строке, которую вводит получатель, будет указан символ двойных кавычек, то в строке проверки двойные кавычки могут быть исключены с помощью обратной косой черты: \"
.
- Если ожидается, что в строке, которую вводит получатель, будет указан символ двойных кавычек, то в строке проверки двойные кавычки могут быть исключены с помощью обратной косой черты: \"
Полезную справочную информацию по синтаксису регулярных выражений, используемых Acrobat Sign, можно найти здесь.
В одно поле можно включить только одну директиву для проверки. Если в одном текстовом теге задано несколько правил проверки, применяется только первое правило проверки. Все последующие правила проверки игнорируются.
Маскировка конфиденциальных данных
Добавив к текстовому тегу определенную директиву, в Acrobat Sign можно замаскировать конфиденциальные данные, собранные во время подписания. Во время подписания, данные, введенные подписывающей стороной в таком поле, преобразуются в звездочки (*) или выбранные пользователем маскирующие символы, как только подписывающая сторона покидает поле. Кроме того, введенные подписывающей стороной данные не отображаются для следующих подписывающих сторон и не включаются в конечный документ PDF. Введенные подписывающей стороной данные можно экспортировать из Acrobat Sign или через API-интерфейс Acrobat Sign.
Определение текстового тега:
Во время подписания:
В конечном документе PDF:
{{*CC_es_:signer1:mask}} |
Задает обязательное поле «CC», назначенное получателю, определенному как «signer1», данные которого маскируются во время подписания. |
{{*CC_es_:signer1:mask(char=-)}} |
Задает обязательное поле «CC», назначенное получателю, определенному как «signer1», данные которого маскируются во время подписания с помощью символа «-». Если символ не задан в текстовом теге, в качестве символа маскировки по умолчанию используется звездочка (*). |
Определение условных правил для полей
Acrobat Sign поддерживает применение условных правил для полей в документе. Условные правила можно использовать для определения правил отображения или скрытия от подписывающей стороны определенного поля в документе при подписании.
Условия, примененные к определенному полю, основываются на значениях одного или нескольких других полей в документе. С помощью условных правил, примененных к определенному полю, можно также указать, будет ли это поле отображаться или же оно будет скрыто при соблюдении всех условий или любого условия, заданного для такого поля.
{{_es_:signer1:showif(condition)}} {{_es_:signer1:showifany(condition)}} |
Показывать поле получателю, определенному как «signer1», при условии соблюдения любого из заданных условий. |
{{_es_:signer1:showifall(condition)}} |
Показывать поле получателю, определенному как «signer1», только при условии соблюдения всех заданных условий. |
{{_es_:signer1:hideif(condition)}} {{_es_:signer1:hideifany(condition)}} |
Скрывать поле от получателя, определенного как «signer1», при условии соблюдения любого из заданных условий. |
{{_es_:signer1:hideifall(condition)}} |
Скрывать поле от получателя, определенного как «signer1», только при условии соблюдения всех заданных условий. |
{{_es_:signer1:enableif(condition)}} {{_es_:signer1:enableifany(condition)}} |
Включить поле для получателя, определенного как «signer1», при условии соблюдения любого из заданных условий. Данное условие аналогично условию «showif», за исключением того, что в случае его несоблюдения поле во время подписания отображается, но является неактивным и не редактируется. Если применимо, в неактивном поле отображается значение поля по умолчанию. Значение также отображается в подписанном документе PDF. |
{{_es_:signer1:enableifall(condition)}} |
Включить поле для получателя, определенного как «signer1», только при условии соблюдения всех заданных условий. |
{{_es_:signer1:disableif(condition)}} {{_es_:signer1:disableifany(condition)}} |
Отключить поле для получателя, определенного как «signer1», при условии соблюдения любого из заданных условий. Отключенное поле отображается как неактивное во время подписания. Если в поле имеется значение по умолчанию, значение отключенного поля все же отображается в подписанном документе PDF. |
{{_es_:signer1:disableifall(condition)}} |
Отключить поле для получателя, определенного как «signer1», только при условии соблюдения всех заданных условий. |
Условие определяется следующим образом: значение оператора имени поля, где именем поля является имя поля формы в документе, на котором основано условие. Поддерживаемые операторы и допустимые значения для различных поддерживаемых полей форм отображены в таблицах ниже.
Условные операторы поля
Оператор |
Смысл |
Значение |
Пример |
---|---|---|---|
=, ==, eq |
Равно |
Одно значение |
myCheck=checked |
!=, <>, neq |
Не равно |
Одно значение |
signature!=signed |
<, lt |
Меньше чем |
Одно значение, цифровое |
myNumber < 10 |
>, gt |
Больше чем |
Одно значение, цифровое |
myNumber > 40 |
<=, lte |
Меньше или равно |
Одно значение, цифровое |
myNumber <= 15 |
>=, gte |
Больше или равно |
Одно значение, цифровое |
myNumber >= 0 |
?=, in |
Ввод |
Список значений с разделителями-запятыми, заключаются в кавычки или скобки |
option ?="1,2,3" |
?!=,!in, not in, notin |
Не в |
Список значений с разделителями-запятыми, заключаются в кавычки или скобки |
option ?!= "1,2,3" |
~=, contains |
Содержит |
Одно значение |
Title ~= Manager |
~!=, !contains, not contains, notcontains |
Не содержит |
Одно значение |
Title ~!= Junior |
Несколько условий в одном поле могут разделяться запятой. Например:
{{notRed_es_:showifall(checkbox=checked,Color!=Red)}} задает поле «notRed», которое видит подписывающая сторона при соблюдении обоих условий.
Условное значение поля для поддерживаемых полей текстовых тегов
Тип поля |
Допустимые значения |
Пример |
---|---|---|
Подпись |
подписанный, неподписанный |
signHere=signed |
Инициалы |
подписанный, неподписанный |
initHere!=signed |
Флажок |
флажок установлен, флажок снят |
myCheck=checked |
Переключатель |
Значение параметра переключателя |
Color=Red |
Текстовые поля |
Значение текстового поля |
Title!=Senior Title~=Chief Price>100 |
Поля вложений |
прикреплено, не прикреплено |
attachment=attached; attachment=unattached |
Условия можно применить к любому полю, включая обязательные поля инициалов, подписей и блоков подписей. Когда условие определено для обязательного поля, оно считается обязательным только в том случае, если условие делает поле видимым для подписывающей стороны во время подписания. Другими словами, если к полю подписи применено какое-то условие, которое скрывает его, подписывающая сторона не видит это поле и, следовательно, не обязано ставить подпись в этом конкретном поле. Счетчик «обязательных полей» в нижней части страницы подписи динамически обновляется на основе определенных условий для точного отражения количества полей, которые необходимо заполнить подписывающей стороне до завершения подписания документа.
Каждая подписывающая сторона должна иметь одно поле подписи без примененных к нему условий. По этой причине, если ко всем полям подписей для данной подписывающей стороны применяется какое-то условие, в конце документа для этой подписывающей стороны добавляется новый блок подписей.
Указание формул расчета для полей
Acrobat Sign поддерживает динамическое заполнение значений полей в документе во время подписи на основе значений/элементов других полей, внесенных пользователем во время подписания. Такие типы полей называются вычисляемыми полями.
Формулы расчета задаются аналогично другим полям в документ с помощью текстовых тегов или среды разработки с поддержкой перетаскивания Acrobat Sign. Формула расчета может ссылаться на одно или несколько существующих полей в документе, а также может основываться на другом вычисляемом поле в документе. Расчеты можно применять к полям с числовыми значениями, полям дат и текстовым полям.
В дополнение к расчету значения поля в документе, вычисляемые поля также могут включать информацию о форматировании для задания соответствующего стиля вывода рассчитанного значения в документе. С помощью текстовых тегов к вычисляемым полям также можно применять дополнительные правила (условные правила, маскировку полей и т. д.).
f1_es_:signer1:calc(formula) |
Вычисляемое поле, назначенное получателю, определенному как «signer1». Его значение рассчитывается автоматически по заданной формуле. |
f2_es_:signer1:calc(formula):format(formatType, format) |
Вычисляемое поле, назначенное получателю, определенному как «signer1». Его значение рассчитывается по заданной формуле, и в итоге выводится значение определенного типа, отформатированное в соответствии с заданным форматом. |
Пример: вычисляемое поле можно использовать для динамического вычисления общего причитающегося налога по заказу.
{{Tax_es_:signer1:calc([subtotal] * [taxrate]):format(number, "$,.00")}}
Налог рассчитывается на основании общей стоимости продуктов, заказанных клиентом, и налоговой ставки в месте пребывания подписывающей стороны. Итоговое рассчитанное значение налога форматируется с использованием символа доллара ($) перед значением и включает две десятичные запятые в итоговом значении. Например, если промежуточное итоговое значение равно 1250, а налоговая ставка составляет 6,25%, итоговое рассчитанное значение, отображаемое в поле «Налог» в документе, будет $1,328.13.
Для получения дополнительной информации о вычисляемых полях и их использовании в документах см. справочное руководство Вычисляемые поля.
Сокращение текстовых тегов
Текстовые теги предоставляют мощный механизм определения разных типов полей в документе, назначая эти поля определенным подписывающим сторонам, задавая правила проверки полей и/или применяя к этим полям условные правила. Применение всех этих возможностей к одному полю формы может сделать определение поля очень длинным и привести к изменению структуры документа в результате определения поля. Более того, поскольку определение каждого поля должно умещаться в одной строке, использование нескольких сложных директив может сделать макет документа очень громоздким. Для обеспечения согласованности структуры документа Acrobat Sign поддерживает механизм задания сокращенных текстовых тегов в документе. Сокращенный текстовый тег состоит из двух частей:
- Тег ссылки — это определение сокращенного тега, размещенное в соответствующем месте в документе. Тег ссылки регулирует размер и местоположение фактического поля формы в документе. Тег ссылки имеет следующий синтаксис: {{$shortened_name}}. Например, {{$ r}} определяет тег ссылки, где «r» — это короткое имя тега. Размер поля можно отрегулировать, вставляя пробелы либо сразу после последней открывающей фигурной скобки, либо непосредственно перед первой закрывающей фигурной скобкой.
- Тег определения — это полное определение для конкретного тега, которое может быть задано в любом месте документа. Размер и расположение тега определения не определяют размер и местоположение фактического поля формы в документе. Тег определения имеет следующий синтаксис:
{{#shortened_name=Standard Tag Syntax}}. Например, {{#r=[]ReceiveCommunication_es_:signer1}} задает полное определение тега ссылки ссылкой с именем «r». В данном примере тег определяет флажок, назначенный получателю, определенному как «signer1».
Например, на рисунке ниже показаны два тега ссылки, размещенные в документе.
Полное определение двух тегов ссылки задается в любом месте документа, как показано на рисунке ниже.
Полное определение текстовых тегов очень длинное, и если бы было нельзя задавать сокращенные теги в соответствующих местах в документе, было бы невозможно сохранить структуру исходного документа.
Удаление страниц из вывода
При отделении местоположений полей форм от определения поля, все определения тегов в документе могут быть размещены в конце документа или на полностью отдельной странице в документе. При отправке документа через Acrobat Sign все текстовые теги обрабатываются и сверху определения текстового тега помещается белый квадрат, после чего текст становится невидим подписывающей стороне. Это может привести к появлению совершенно пустых страниц в документе после обработки Acrobat Sign, страниц, содержащих только текстовые теги. Во избежание появления дополнительных нежелательных пустых страниц в документе Acrobat Sign поддерживает специальное определение текстового тега для удаления конкретной страницы из обрабатываемого выходного документа, созданного Acrobat Sign, перед отправкой документа на подпись.
{{#REMOVE_PAGE_FROM_OUTPUT}} |
Специальная директива, которая сообщает Acrobat Sign о необходимости удалить страницу, на которой отображается эта директива из обрабатываемого выходного документа. Тег может отображаться в любом месте страницы. Документ, отправляемый в Acrobat Sign, должен содержать хотя бы одну страницу. Если эта директива будет отображаться на всех страницах документа, отправляемых в Acrobat Sign, первая страница не будет удалена. |
Дополнительные примеры текстовых тегов
Ниже приведено несколько примеров текстовых тегов с описанием для каждого тега.
Флажки
{{[]_es_:signer1}} |
Флажок, назначенный получателю, определенному как «signer1». |
{{[]*}} |
Обязательный флажок. |
{{[]!}} |
Флажок только для чтения. |
Переключатели
{{(Daily)Rate_es_:signer1}} |
Переключатель, назначенный «signer1», со значением «Daily». |
Раскрывающийся список
{{*Color_es_:signer1:dropdown(options= "Red,Green,Blue”)}} |
Обязательный раскрывающийся список с тремя возможными параметрами. Список назначается получателю, определенному как «signer1». |
{{Color_es_:signer1:dropdown(options= "Red,Green,Blue”):default(“Red”)}} |
Раскрывающийся список с тремя возможными параметрами, и по умолчанию выбран параметр «Red». Список назначается получателю, определенному как «signer1». Если в определении раскрывающегося списка указано значение, для определения значения по умолчанию должно использоваться данное значение, в противном случае используется параметр. |
{{Color_es_:dropdown(options="Red,Green,Blue", values=”R,G,B”):default(“R”):mask}} |
Раскрывающийся список, не назначенный никакому получателю, с тремя возможными параметрами, соответствующими трем значениям экспорта. Значение «R», соответствующее выбору «Red» получателем, выбрано по умолчанию, и выбранный в итоге параметр маскируется (отображается как «*») в документе PDF. |
{{Color_es_:dropdown(options= "Red,Green,Blue”):showif(Rate=”Daily”)}} |
Раскрывающийся список, не назначенный никакому получателю, с тремя возможными параметрами. Раскрывающийся список отображается только в том случае, если у переключателя «Rate» значение «Daily». |
Проверка поля
{{Birthday_es_:signer2:isdate}} |
Необязательное поле даты для ввода даты в формате США получателем, определенным как «signer2». |
{{*Zip2_es_:signer2:zip}} |
Необязательное поле для ввода действительного почтового индекса получателя, определенного как «signer2». Поле проверяет значение, введенное получателем. |
Сокращение текстовых тегов
|
{{$r}} |
Тег ссылки, указывающий местоположение поля. |
|
{{#r=[]Spouse_es_:prefill}} |
Определение флажка, которое предварительно заполняет отправитель. |
Сокращение текстового тега можно также использовать в качестве функции, а не только для замены всего поля.
В качестве примера возьмем следующий тег:
{{field1_es_:signer1:showif(fieldA=‘Yes)}}
Указанный выше тег можно также сократить следующим образом:
{{field_es_:$A:$B}}
#A=signer
#B=showif(fieldA=‘Yes’)
Сокращение текстового тега также может действовать как метод расчета. В качестве примера возьмем следующий тег:
{{field1_es_:calc(a * b / c)}}
Указанный выше тег можно также сократить следующим образом:
Field1_es_:$1(a,b,c)
#1(option1, option2, option3) = calc([option1] * [option2] / [option3])
Условные правила
{{f_es_:hideifall(sig=unsigned,initials=unsigned}} |
Это поле отображается только при добавлении и подписи, и инициалов. |
{{*emailAddress_es_:signer1:isemail:showif (TypeOfComm="receiveEmail")}} |
Обязательное поле для ввода адреса электронной почты получателя, определенного как «signer1». Это поле отображается только в том случае, если в другом поле «TypeOfComm» указано значение «receiveEmail». Поле проверяет значение, введенное получателем. |
{{f_es_:hideifany(Color=”Red”,Color=”Green”}} |
Поле, которое не отображается, если получатель выбирает красный («Red») или зеленый («Green») цвет в раскрывающемся списке цветов («Color»). |
Вычисляемые поля
{{shipState_es_:signer1:calc([billingState]) :showif(sameAs=unchecked)}} |
Поле в документе, назначенное первой подписывающей стороне, которое отображается только в том случае, если не выбрано другое поле (флажок) «sameAs». В это поле автоматически подставляется значение из поля «billingState», введенное подписывающей стороной. |
{{total_es_:signer1:calc(q1*pr1) :format(Number,”$,0.00”):align(right)}} |
Поле в документе, назначенное получателю, определенному как «signer1». Значение в этом поле автоматически вычисляется путем умножения значений в полях «q1» и «pr1». Итоговое значение выводится в формате валюты, содержит два десятичных разделителя, и перед ним отображается знак доллара ($). Кроме того, итоговое значение выравнивается по правому краю поля. |
{{price_es_:signer1:calc(if(pn1=”W1”,9.99, if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}} |
Поле в документе, называемое «price», рассчитывается на основании значения, выбранного подписывающей стороной в других полях «pn1» в документе. Если значение в поле «pn1» равно W1, то в поле «price» отображается значение 9,99; если значение в поле «pn1» равно W2, то в поле «price» отображается значение 5,99 и т. д. Если ни одно из значений не соответствует значению поля «pn1», то в поле «price» отображается 0. Благодаря этому механизму вычисляемые поля могут применяться для автоматического заполнения цены на основе выбора, сделанного пользователем во время подписания. |
Для получения дополнительной информации о вычисляемых полях см. справочное руководство Вычисляемые поля.