Чтобы обеспечить корректность информации, сохраняемой в ходе бизнес-процессов, в системе действует валидация данных. Она применяется в следующих случаях:
- при выполнении скриптов в бизнес-процессах:
- в блоке Скрипт;
- в шлюзе, если для определения перехода используется служебная переменная, значение которой вычисляется с помощью скрипта;
- в пользовательском действии в бизнес-процессах типа Скрипт;
- при вызове методов API, с помощью которых:
- запускается бизнес-процесс;
- изменяется контекст экземпляра процесса;
- закрывается задача.
Обработка ошибок валидации в системе
Если в скрипт или метод API передаётся некорректное значение:
- С версии системы 2026.4 — данные сохранятся, ошибка зафиксируется в логе сервиса processor.
- С версии системы 2026.8:
- для скриптов — выполнение экземпляра процесса прервётся, ошибка отобразится в разделе Монитор ошибок;
- для методов API — действие не выполнится, в ответе на запрос отправится ошибка.
Пример валидации данных
Допустим, при получении заказа от клиента во внешней системе с помощью API должен запускаться бизнес-процесс в ELMA365. Во время обработки запроса входные данные для вызова метода проверяются на корректность. Например, если для полей типа Номер телефона, Электронная почта, Учетная запись указаны несуществующие подтипы:
- в версиях системы с 2026.4 до 2026.8 — процесс запустится, в логе сервиса processor зафиксируется ошибка валидации;
- в версии 2026.8 и выше — процесс не запустится, чтобы исключить сохранение некорректных данных.
Устранение ошибок валидации
В случае ошибок при проверке данных:
- Определите, откуда передаются некорректные данные для выполнения скрипта или вызова метода API.
- Проверьте заполнение полей, которые не могут быть пустыми.
- Убедитесь, что все значения передаются в нужном формате.