Настоящая статья содержит информацию, верную на момент перед выпуском новой версии. Даты выпуска, характеристики и другие параметры могут быть изменены без предварительного уведомления.
Позвольте получателям выбирать варианты «X из Y» с ограничениями — без обходных путей, без догадок.
Группы флажков позволяют задавать структурированные условия выбора с заданными правилами (например, «выберите любые 3 преимущества», «выберите как минимум 2 факультативные программы» или «выберите до 5 настроек») без необходимости разработки специальных сценариев или постоянной проверки.
Группы флажков можно настроить только при размещении полей соглашения через API (используя конечную точку PUT /agreements/{agreementID}/formFields).
Конфигурация
Доступность
- Acrobat Standard и Acrobat Pro: не поддерживается
- Acrobat Sign Solutions: поддерживается
- Acrobat Sign for Government: поддерживается
Принцип работы
Группа флажков — это набор из двух или более флажков, которые имеют общее имя группы и правило проверки. Правило проверки требует, чтобы получатели выбрали:
- ровно X вариантов
- как минимум X вариантов
- не более X вариантов
- диапазон X–Y из N вариантов
Каждый отдельный флажок имеет свое собственное имя поля, состояние по умолчанию и стиль.
Правила применяются в реальном времени, когда получатели устанавливают флажок, а также при отправке, что не позволяет завершить процесс, пока выбор не будет соответствовать вашему правилу. Завершенные соглашения показывают состояние каждого флажка.
Создание группы флажков (запрос подписи)
В настоящее время группы флажков можно создавать в соглашении только с помощью конечной точки REST v6 API PUT /agreements/{agreementID}/formFields, заполняя параметр formFieldGroups:
{
"formFieldGroups": [
{
"validationRule": {
"minSelection": 0,
"maxSelection": 0
},
"fieldNames": [
"string"
],
"name": "string"
}
]
Советы для создания понятных форм
- Используйте короткие, однозначные имена полей для каждого флажка.
- Выбирайте самое узкое правило, соответствующее вашему намерению (например, «ровно 2», а не «диапазон 2–2»).
- Устанавливайте значения по умолчанию только тогда, когда они отражают типичный выбор и остаются в рамках вашего правила.
Процесс подписания
- Классический интерфейс eSign применяет правило проверки группы, когда получатели выбирают варианты, а также при отправке, с использованием четких сообщений проверки. Если правило не соблюдено, получатели не могут завершить процесс.
- Если включен современный интерфейс eSign и получателю назначена группа флажков, для получателя будет использоваться классический интерфейс eSign (пока Modern eSign не будет поддерживать эту функцию).
Экспорт данных
- При экспорте данных каждый флажок указывается с собственным именем поля и состоянием (установлен/снят).
- Метаданные группы не включаются в экспорт. Планируйте последующую обработку соответствующим образом.
Известные ограничения
- Условная логика и вычисления применяются к отдельным флажкам, а не ко всей группе.
- Режим фокусировки на мобильных устройствах не поддерживается при создании документов с использованием групп флажков.
Совместимость и резервные варианты
- Классический режим создания не поддерживает группы флажков. Если вы откроете документ с группами в классическом режиме создания, сгруппированные поля отобразятся как независимые флажки, а правила группы будут утеряны без предупреждения.
- Начиная с выпуска в октябре 2025 года, поддерживается создание соглашений с запросом подписи, созданных через API. Поддержка шаблонов библиотеки, веб-форм и массовой рассылки ожидается в более поздних версиях; до тех пор избегайте предположений, что правила группы будут применяться в этих процессах.
- Если в новой среде авторинга отображается предупреждение для документов с группами во время рабочих процессов редактирования/изменения, следуйте подсказкам или используйте интерфейс запроса подписи с новой средой авторинга.
