Рабочая среда

• Левая палитра: компоненты сгруппированы по категориям — «Базовые» и «Расположение» доступны всегда; категории «Продвинутые» и «Данные» появляются после включения Продвинутого режима. Вверху палитры есть живой поиск по названиям компонентов.
• Рабочий холст: интерактивный макет будущей формы. Новый компонент вставляется перетаскиванием или кликом по элементу палитры (он добавится в конец формы).
• Панель быстрых действий: появляется при наведении на компонент на холсте.

Действия над компонентом

Работа с многостраничным режимом

• Каждая страница — отдельная вкладка над холстом. Добавляйте страницы кнопкой «+ Страница».
• Заголовок страницы показывается респонденту в навигации; настройте его в свойствах страницы.
• Страницы можно переименовывать, менять местами перетаскиванием и удалять.
• На последней странице автоматически размещается кнопка отправки формы.
• Валидация проверяет текущую страницу перед переходом к следующей: респондент не «уйдет» дальше с незаполненными обязательными полями.

Вкладка «Отображение»

Вкладка «Данные»

Вкладка «Валидация (Проверка)»

Вкладка «Свойства API»

Вкладка «Условия показа»

Вкладка «Расположение»

Вкладка «Логика» Продвинутый

Правила вида «когда триггер → выполнить действие». Полное описание — в разделе Продвинутый режим.

1. Укажите, должен ли компонент отображаться, когда условие выполнено (True) или когда не выполнено (False).
2. Выберите поле-источник условия из выпадающего списка всех компонентов формы.
3. Задайте значение для сравнения. Условие срабатывает при точном совпадении ответа с указанным значением.

Скрытые условностью поля не попадают в отправку, если это явно не разрешено в настройках компонента. Для сложных условий (несколько полей сразу, сравнение чисел, вычисляемые выражения) используйте Продвинутый режим — условия на JSONLogic.

Механизм безопасной обработки файлов

1. Респондент выбирает файл в форме.
2. Файл отправляется в защищенный файловый шлюз платформы и помещается во временный изолированный буфер.
3. Служба ClamAV проверяет файл на вирусы и вредоносные сигнатуры.
4. Чистый файл сохраняется в защищенное S3-хранилище, а в сабмишн формы записывается безопасный уникальный UUID файла.
5. Если обнаружен вирус — загрузка блокируется, файл немедленно уничтожается.

Максимальный размер файла задается администратором в «Настройках системы». Программное скачивание загруженных файлов и политики доступа описаны в разделе Скачивание файлов (File API).

📋 Сценарий 1. Поле ИИН/БИН с маской и проверкой

1. Добавьте Текстовое поле, назовите «ИИН/БИН».
2. В «Отображении» задайте Маску ввода 999999999999 — ровно 12 цифр, и Автозаполнение браузером = off.
3. Во «Вкладке Валидация»: включите Обязательно, задайте Регулярное выражение ^\d{12}$ и понятный текст ошибки: «ИИН/БИН состоит из 12 цифр».
4. Во «Свойствах API» проверьте ключ поля — например, iin_bin: под этим именем значение уйдёт в отчёты и вебхуки.

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

🗺 Сценарий 2. Каскадные списки «Область → Город»

1. Создайте два Выпадающих списка: «Область» и «Город».
2. Обоим задайте Тип источника данных = URL и адрес справочника (свой REST-эндпоинт или словарь платформы /api/v1/dictionaries/{код}).
3. У списка «Город» в поле Refresh Options On выберите компонент «Область» — список городов будет перезагружаться при смене области.
4. Включите Clear Value On Refresh Options — при смене области ранее выбранный город сбросится (иначе останется город из чужой области).
5. В URL-источнике города передавайте выбранную область параметром: ?region={{ data.region }} — так сервер отдаст только подходящие города.

Включите Lazy Load Data у обоих списков, чтобы справочники грузились только при открытии, а не при загрузке формы.

✅ Сценарий 3. Чекбокс согласия на обработку данных

1. Добавьте Флажок (Чекбокс) с меткой «Я даю согласие на обработку персональных данных».
2. Во «Вкладке Валидация» включите Обязательно для заполнения и задайте текст ошибки: «Требуется согласие на обработку персональных данных».
3. Поставьте флажок последним полем перед кнопкой отправки; ссылку на политику добавьте через Текстовый блок (Контент) над чекбоксом.

Не ставьте флажку «Значение по умолчанию = включено»: согласие должно быть осознанным действием.

💾 Сценарий 4. Кнопка «Сохранить черновик»

1. Добавьте Кнопку рядом с основной кнопкой отправки.
2. В «Действии» выберите Сохранить в состоянии и укажите имя состояния, например draft.
3. Выключите Show Validations и Блокировать при ошибках в форме — черновик должен сохраняться даже с незаполненными обязательными полями.
4. Задайте тему кнопки «secondary», чтобы визуально отличать от основной кнопки отправки.

Для периодических форм черновики работает вместе с настройкой «Продолжать текущий отчёт» — респондент сможет дозаполнять анкету в течение периода. Подробности: Периодическая отчётность.

👨‍👩‍👧 Сценарий 5. Таблица «Члены семьи» с лимитами

1. Добавьте Сетку данных (Таблицу) «Члены семьи».
2. Внутрь перетащите поля: ФИО (Текстовое поле), дата рождения (Дата и время), степень родства (Выпадающий список из словаря).
3. Во «Вкладке Валидация» задайте Минимум/Максимум строк — например, минимум 1, максимум 10.
4. В «Add Another Text» напишите «+ Добавить члена семьи», в «Number of Rows» поставьте 1.

В выгрузке Excel каждая строка таблицы попадёт в ответ как отдельный объект массива family_members — одинаковые ключи полей внутри строк обязательны.

📚 Сценарий 6. Выпадающий список из словаря платформы

1. Создайте Выпадающий список, источник данных — URL.
2. Укажите адрес словаря: /api/v1/dictionaries/{код словаря} — данные управляются в справочнике записей, без пересборки формы.
3. Задайте Поле для сохранения (Value Property) по структуре словаря (например, code), а подпись настройте Шаблоном отображения варианта.
4. Включите Проверку «Разрешены только варианты из списка», чтобы респондент не отправил значение вне словаря.

При обновлении справочника форма подхватит новые варианты автоматически — ревизия формы не требуется.

Что открывается

• Категории палитры «Продвинутые» и «Данные»: профильные поля и контейнеры данных.
• Кнопка «JSON» на компонентах: прямое редактирование JSON-схемы любого поля.
• Вкладка «Логика» в диалоге свойств компонента (см. ниже).
• Калькулируемое значение: JavaScript-выражение, автоматически вычисляющее значение поля из других ответов (например, сумма полей таблицы).
• Кастомная JS-валидация: произвольная проверка значения функцией на JavaScript.
• JSONLogic: составные условия видимости и валидации в декларативном формате.
• Серверный пересчет значения и разрешение ручного переопределения вычисляемых полей.

Полный перечень JS-настроек с доступными переменными и примерами кода — в разделе JavaScript-свойства компонентов.

Вкладка «Логика»

Расширенная логика описывается правилами вида «когда триггер → выполнить действие»:

• Триггеры: простое условие по полю, JSONLogic-выражение или JavaScript-функция.
• Действия: изменить свойство компонента (например, сделать поле обязательным), изменить состояние, объединить (merge) часть схемы, выполнить произвольный код.

Так реализуются сценарии вида «если сумма кредита больше 1 000 000 — показать блок поручителей и сделать поле ИИН обязательным».

Доступные переменные (общий контекст)

Во всех JS-точках доступны одни и те же переменные:

Ссылайтесь на другие поля по их Property Name (вкладка «Свойства API»), а у Переключателей, Списков и Групп флажков — по значению варианта, а не по его метке.

Все точки входа JavaScript

show = (data.income < 45000) &&
  (data.maritalStatus == 'single' || data.maritalStatus == 'widowed');

value = (data.items || [])
  .reduce((sum, row) => sum + (Number(row.amount) || 0), 0);

valid = (input === data.email)
  ? true : 'Адреса электронной почты не совпадают';

values = [
  { label: 'Опция A', value: 'a' },
  { label: 'Опция B', value: 'b' }
];