﻿# Валидация данных в бизнес-процессах для скриптов и методов API

> [HTML Version](validation-in-processes.html)

Для каждого поддерживаемого типа данных в ELMA365 предусмотрены свои форматы значений, которые описаны в [справке по публичному API ELMA365](https://api.elma365.com/ru/public-api/guides/DataType/). Чтобы обеспечить корректность информации, сохраняемой в ходе бизнес-процессов, данные в них валидируются — проверяются на соответствие формату и заполнение обязательных полей. 

Валидация выполняется в следующих случаях:

- при выполнении скриптов в бизнес-процессах:

	- в блоке [Скрипт](360027203731.md);

	- в [шлюзе](360012495911.md#variable), если для определения перехода используется служебная переменная, значение которой вычисляется с помощью скрипта;

	- в [пользовательском действии в бизнес-процессах типа Скрипт](script-activity.md); 

- при вызове [методов API](https://api.elma365.com/ru/public-api/reference/bpm/), с помощью которых:

	- запускается бизнес-процесс;

	- изменяется контекст экземпляра процесса;

	- закрывается задача.

## Обработка ошибок валидации в системе

Если в скрипт или метод API передаётся некорректное значение:

1. С версии системы 2026.4 — данные сохранятся, ошибка зафиксируется в логе сервиса **processor**.

2. С версии системы 2026.8:

- для скриптов — выполнение экземпляра процесса прервётся, ошибка отобразится в разделе [Монитор ошибок](error_monitor.md);

- для методов API — действие не выполнится, в ответе на запрос отправится ошибка.

## Пример валидации данных

Допустим, при получении заказа от клиента во внешней системе с помощью API должен запускаться бизнес-процесс в ELMA365. Во время обработки запроса входные данные для вызова метода проверяются на корректность. Например, если для полей типа **Номер телефона**, **Электронная почта**, **Учетная запись** указаны несуществующие подтипы:

- в версиях системы с 2026.4 до 2026.8 — процесс запустится, в логе сервиса **processor** зафиксируется ошибка валидации;

- в версии 2026.8 и выше — процесс не запустится, чтобы исключить сохранение некорректных данных. 

## Устранение ошибок валидации

В случае ошибок при проверке данных:

1. Определите, откуда передаются некорректные данные для выполнения скрипта или вызова метода API.

2. Проверьте заполнение полей, которые не могут быть пустыми.

3. Убедитесь, что все значения передаются в нужном формате. 