¶ Что такое валидация.
Валидация — это функционал проверки данных по заданным параметрам при выполнении действий с заказами.
Иначе говоря, валидация — это система ограничений, которая срабатывает в момент сохранения заказа при его создании или редактировании. Если данные не соответствуют условиям, заданным в валидаторе или правилах перемещения, система мгновенно отреагирует: предупредит об ошибке и не даст сохранить изменения до тех пор, пока пользователь не выполнит все необходимые требования.
Валидаторы настраиваются гибко и индивидуально под нужды вашей компании. Они могут применяться как ко всем пользователям CRM сразу, так и к отдельным ролям, конкретным сотрудникам или даже к API-токенам.
Ниже мы приведём примеры наиболее распространённых валидаторов (а о том, как настраивать валидаторы с помощью редактора, мы расскажем далее):
- определённый пользователь не может перемещать заказы из указанного статуса;
- роль (например, «Оператор») не может вносить какие-либо изменения в заказ, если тот находится в заданном статусе;
- при смене статуса заказа на указанный, пользователи обязательно должны установить дату напоминания;
- в поле «Индекс» не может быть введено более 6 символов;
- при заполнении поля Телефон, номер обязательно должен быть введен в опеределенном формате;
- при применении целевого действия пользователь не сможет сохранить заказ, если не заполнено специальное поле заказа;
- сумма корзины не может быть ниже заданной;
и многое другое.
Если пользователь не соблюдает какие-то правила заполнения карточки заказа, при попытке сохранить его онувидит на экране всплывающее окно с текстом ошибки — текст вы также задаетё самостоятельно.
Ниже показано, как это выглядит в карточке заказа.
¶ Типы валидации в CRM Sales Render.
Пункт Валидация находится в режиме Управление. У нас есть два типа валидации, ниже коротко о них.
-
Правила перемещения. Это правила перемещения заказов по статусам,они будут действововать для ВСЕХ пользователей компании и плагинов-макросов (с ними вы работаете черз кнопки массовый операций "Обработать", например макрос Массовое перемещение заказов по статусам). Работе триггеров правила валидации мешать не будут.
-
Валидаторы заказа. Это правила валидации данных, внесенных в заказ (проверка правильности ввода ФИО, телефона или адреса; запрет действий с заказом и т.д., больше примеров мы приводили в пункте "Что такое валидация").
¶ Настройка Правил перемещения.
Для того чтобы настроить правила перемещения, перейдите в режим Управление - Валидация - Правила перемещения. Это правила, по которым заказы будут перемещаться в статусы. Здесь создается алгоритм, чтобы сотрудники компании не могли совершать некорректные перемещения заказов.
На открывшейся странице вы видите два столбца и поле для выбора статуса по середине экрана:
Столбец посередине - это статус, для которого вы делаете настройки, вы можете гибко настроить правила перемещения для каждого статуса, по умолчанию запреты не выставлены.
Для каждого статуса настройки необходимо сохранять отдельно, после того как вы задали нужные параметры, нажмите кнопку Сохранить рядом с выбранным статусом.
Столбец слева - это список статусов, ИЗ которых заказ может быть перемещён в статус, для которого вы настраиваете правила перемещения.
Столбец справа - это список статусов, В которые заказ может быть перемещён из статуса, выбранного посередине.
Выше на срине вы видите следующую настройку для статуса Обработка:
- в статус Обработка нельзя перемещать заказы из других статусов, в этом статусе могут быть только созданы новые заказы, и обновлены заказы, которые уже имеют статус Обработка;
- из статуса Обработка нельзя перемещать заказы в статусы: В пути, Ждёт вручения, Проблемы доставки, Доставлено, Возвраты.
Из интересного: обратите внимание, что в центральной колонке можно выбрать не только статусы, но и «Новый заказ». Это предусмотрено для того, чтобы вы могли настроить, в каком именно статусе допускается создание новых заказов.
При выборе «Новый заказ» доступна настройка только правой колонки — то есть вы определяете, в каком статусе такой заказ может быть создан. Настраивать, из каких статусов он может прийти, в этом случае не требуется. Это правило будет действовать не только для пользователей, но и для API итеграций.
¶ Настройка Валидаторов заказ.
Для того чтобы настроить валидаторы, перейдите в режим Управление - Валидация - Валидаторы заказа. Чтобы создать валидатор, нужно нажать + в правом нижнем углу страницы. Базово в компании нет никаких валидаторов.
В открывшемся окне вы увидите следующие поля:
Название - мы можете дать валидатору любое название для понимания его фукнции.
Сообщение - здесь вводится текст, который увидит пользователь в ошибке, если нарушит правило валидации и попытается сохранить изменения (как показано на скриншоте выше).
Фильтр - здесь необходимо указать условия, которые вызовут срабатывание валидатора
У нас собственный low-code редактор написания правил валидации, он же используется и в написании триггеров, ниже мы разберем некоторые функции и правила написания фильтров для валидаторов.
На скрине в фильтре прописано следующее условие для срабатывания валидатора: если статус заказа сменился на статус Апрувы и поле телефон пустое. Если соблюдены эти условия, при сохранении пользователь получит ошибку с текстом "Обязательно заполните поле телефон".
¶ Как работать с фильтром в валидаторе.
В поле фильтра вы увидите переменные, сущности, функции, константы. Как с ними работать?
- Переменные - это все поля в заказах, например: статус, проект, поле "ФИО" являются переменными в заказе. У переменных может быть как текущее, так и предыдущее состояние. Валидатор может проверять факт смены статуса, если указать в фильтре “Текущий статус в заказе” не равен (пишется как !=) “Предыдущему статусу в заказе”.
- Сущности. Если наличие статуса в заказе - это переменная, то сущность означает, какой именно статус имеет заказ. Например, чтобы валидатор срабатывал только при обновлении статуса заказа на "Апрувы", вы задаете в фильтре, что переменная “Статус заказа”, равна (пишется как ==) сущности "Статус заказа" и далее выбираете конкретно “Апрувы”.
- Функции - это готовые функции для вычислений и проверок. Среди них, например: «В строку» TO_STRING, «Длина» LENGTH, «Кол-во товаров в корзине» COUNT_CART_ITEMS, «Кол-во акций в корзине» COUNT_CART_PROMOTIONS, «Максимальная дата» DATE_MAX и другие. Функции позволяют не просто сравнивать поля напрямую, а сначала что-то посчитать или преобразовать, а затем уже использовать результат в условии.
- Константы - это фиксированный список из следующих констант FALSE, TRUE, NULL, NOW. Это нужно для того, чтобы использовать выражения типа “Исполнитель действия пользователь?” == “TRUE” или “Текущее время” == “NOW”.
В редакторе выражений доступны следующие операторы:
== означает “равно”;
!= означает “не равно”;
> больше;
>= больше или равно;
< меньше;
<= меньше или равно;
AND (ещё пишется как && ) это логический оператор. Ставится, когда в валидаторе несколько условий “Статус должен быть таким И проект должен быть таким”, то есть условия строгое;
OR (ещё пишется как || ) ещё один логический оператор, который означает ИЛИ. Ставится, когда в валидаторе, когда есть несколько условий “Статус должен быть “Обработка” ИЛИ статус должен быть “Перезвонить”.
IN оператор для работы с массивами, с помощью которого можно проверять наличие товаров/акций;
+, -, / </kbd> арифметические операторы
Важно: если вы используете в фильтрах сразу AND и OR, то при построение фильтров нужно знать, что AND будет выполняться раньше, чем OR. Поэтому, если вы хотите, чтобы сначала проверялись условия OR, возьмите это действие в скобки.
Если у вас остались вопросы по работе с валидацией в CRM SalesRender, обращайтесь в нашу службу поддержки — мы поможем настроить любые валидаторы под ваши бизнес-процессы.
*все скриншоты сделаны в тестовых компаниях и не содержат реальных данных