Добавление вычисляемых полей в форму

Adobe Acrobat Sign позволяет динамически обновлять поля в документе (соглашении) на основе данных, введенных подписывающей стороной. Это можно сделать с помощью вычисляемых полей. С помощью вычисляемых полей можно настроить правила документа (или шаблона документа) перед тем, как отправить его на подпись. Эти правила обрабатываются, когда пользователь выполняет операции с документом, и документ динамически обновляется в соответствии с полями или значениями.

Вычисляемые поля в документе можно создать одним из следующих способов.

• Среда авторинга форм в Acrobat Sign
• Текстовые теги Acrobat Sign (дополнительные сведения см. в руководстве по текстовым тегам).
• Поля форм Adobe Acrobat PDF (дополнительные сведения см. в справочном руководстве Создание форм в приложении Acrobat.)

Примеры использования вычисляемых полей

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

1. Настройка формы заказа — вычисляемые поля можно использовать для настройки формы заказа, где подписывающая сторона может выбрать один из элементов в списке и указать количество. Когда пользователь выбирает элемент в списке, форма автоматически обновляется с учетом цены выбранного товара. Когда пользователь выбирает количество, автоматически рассчитывается итоговая стоимость товаров. В форму можно включить дополнительные расчеты, определяющие общую сумму налога по заказу или величину скидки, вычисленную в соответствии с правилами расчета скидок.

2. Автоматическое указание срока действия контракта — если в момент подписания документа пользователь выбирает срок контракта (6 месяцев, 12 месяцев, 24 месяца и т. д.), вычисляемое поле позволяет автоматически подставить дату окончания контракта в соответствии со значением, выбранным во время подписания документа.

3. Подписание формы с несколькими вариантами выбора — вычисляемое поле можно использовать для настройки форм подписки (например, форм участия), где пользователь, подписывающий форму, может выбрать несколько определенных параметров. Выбранные пользователем варианты определяют другие динамические аспекты форм, такие как условия соглашения, срок контракта и общая стоимость.

Основные сведения о вычисляемых полях

Любое поле формы в Acrobat Sign, включая флажки и переключатели, можно пометить как вычисляемое. Во время подписания формы пользователь не может напрямую ввести значение в поле, помеченное как вычисляемое. Значение этого поля рассчитывается автоматически на основе правил, настроенных для формы.

Определение вычисляемого поля состоит из двух частей: выражение и формат.

Вычисляемые поля можно создать с помощью текстовых тегов Acrobat Sign, с помощью веб-приложения Acrobat Sign или с помощью полей формы PDF. При использовании текстовых тегов Acrobat Sign или полей формы PDF вычисляемое выражение определяется с помощью директивы calc. Форматирование вычисляемого поля можно применить с помощью директивы format.

Пример

{{someCalculatedField_es_:signer1:calc(someExpn):format(formatType, someFormat)}}

В этом примере показаны текстовые теги, используемые для определения поля someCalculatedField. Это поле назначено получателю «signer1». Значение этого поля вычисляется по формуле, заданной параметром «someExpn». Тип итогового значения определяется параметром «formatType», и к нему применяется формат, заданный параметром «someFormat».

Среда авторинга в веб-приложении Acrobat Sign предоставляет полноценный редактор выражений, в котором можно создавать формулы для вычисляемых полей. Дополнительные сведения о создании выражений см. в разделе Определение вычисляемых полей с помощью редактора выражений.

Выражения вычисляемого поля

Выражение определяет формулу или правило для расчета значения в вычисляемом поле. Выражение может состоять из одного или нескольких элементов:

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

В вычисляемых полях поддерживаются следующие операторы.

Поддерживаемые функции

Для определения выражений в вычисляемом поле используются следующие функции.

Допустимые значения фрагментов дат

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

Форматирование вычисляемых полей

Для вычисляемого поля можно не только задать выражение, но и настроить форматирование результирующего значения. Результат можно представить в текстовом формате (по умолчанию), а также в формате числа или даты.

Если используются текстовые теги, директива «format» имеет два аргумента: «FormatType» и «Format».

Применение числового формата к вычисляемым полям

Чтобы представить результат в виде числа, можно использовать следующие символы.

Применение формата даты к вычисляемым полям

Чтобы представить результат в виде даты, можно использовать следующие символы.

Примеры форматирования

Далее приведены примеры форматирования дат и чисел в вычисляемых полях.

• Вычисляемое поле с примененным форматом даты:

{{myField_es_:calc(otherDateField + 3):format(date, "mmm dd, yyyy")}}

Результирующее значение имеет вид «22 мая 2016».

• Вычисляемое поле с примененным числовым форматом:

{{myTax_es_:calc(total * taxrate):format(number, "$,.00") }}

Результирующее значение имеет вид «$1,987.65».

Определение вычисляемых полей с помощью редактора выражений

Вычисляемые поля можно определить в среде авторинга Acrobat Sign. Чтобы определить вычисляемое поле в среде авторинга, выполните указанные ниже действия.

1. Перетащите поле в документ. Дважды щелкните добавленное поле, чтобы открыть диалоговое окно свойств. Присвойте полю соответствующее имя. Измените атрибут Тип значения на Вычисляемое значение. Теперь значение поля будет определяться в результате вычисления во время подписания документа.

2. Введите вычисляемое выражение в текстовом поле Формула или нажмите на кнопку функции (fx), чтобы открыть редактор выражений.

3. В редакторе выражений задайте выражение для вычисляемого поля (см. рис. ниже). В области выражения в верхней части окна видна формула, которая будет использоваться для вычисления значения поля. Формулу можно ввести в области выражения или создать в среде авторинга. Редактор выражений предоставляет список доступных функций, список существующих полей форм в документе, а также список поддерживаемых операторов, используемых при построении выражений. Чтобы добавить в формулу поле или функцию, дважды щелкните нужный элемент в области списка в редакторе выражений. В выражение также можно добавить операторы, выбрав нужный элемент в списке операторов.

4. После создания выражения можно проверить его структуру с помощью кнопки Проверить синтаксис и сохранить изменения.

5. Выберите тип вычисляемых полей в раскрывающемся списке Отображать как.

6. Если в списке Отображать как выбрана дата или число, выберите формат числа или даты. Также можно выбрать пользовательское форматирование для поля.

Вычисляемые поля в формате валюты

Формат валюты для вычисляемого поля вставляет символ валюты перед вычисляемым значением. (В противном случае вычисление является простым математическим вычислением, которое определяется формулой.)

Вставляемое значение зависит от приведенных ниже правил.

• Если поля источника содержат значение валюты для США, вычисляемое значение отображает символ доллара США: $.
• Если поля источника содержат значение валюты для Великобритании, вычисляемое значение отображает символ фунта стерлингов: £.

Для использования формата валюты вычисляемые поля должны быть настроены следующим образом.

• Поле Отображать как должно иметь значение Число.
  
• Поле Формат числа должно иметь значение Валюта.
  

Поля источника, используемые в расчете, могут иметь значение Число или Валюта.

Примеры вычисляемых полей

• {{shipState_es_:signer1:calc([billingState]):showif(sameAs=unchecked)}}
  • Поле в документе, назначенное первой подписывающей стороне, которое отображается только после снятия флажка «sameAs». В это поле автоматически подставляется значение из поля «billingState», введенное подписывающей стороной.
• {{total_es_:signer1:calc(q1*pr1):format(Number,”$,0.00”):align(right)}}
  • Поле в документе, назначенное первой подписывающей стороне. Значение в этом поле автоматически вычисляется путем умножения значений в полях «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. Таким образом, в вычисляемые поля автоматически подставляется цена товара в зависимости от выбора, сделанного подписывающей стороной.