Ця документація була автоматично перекладена штучним інтелектом.
Валідація полів
Щоб забезпечити точність, безпеку та узгодженість даних у колекціях, NocoBase пропонує функцію валідації полів. Ця функція складається з двох основних частин: налаштування правил та застосування правил валідації.
Налаштування правил
Системні поля NocoBase інтегрують правила Joi, з підтримкою наступних типів:
Рядок
Типи рядків Joi відповідають наступним типам полів NocoBase: Однорядковий текст, Багаторядковий текст, Номер телефону, Електронна пошта, URL, Пароль та UUID.
Загальні правила
- Мінімальна довжина
- Максимальна довжина
- Довжина
- Регулярний вираз
- Обов'язкове поле
Електронна пошта
URL
UUID
Число
Типи чисел Joi відповідають наступним типам полів NocoBase: Ціле число, Число та Відсоток.
Загальні правила
- Більше ніж
- Менше ніж
- Максимальне значення
- Мінімальне значення
- Кратне
Ціле число
Окрім загальних правил, поля цілих чисел додатково підтримують валідацію цілих чисел та валідацію небезпечних цілих чисел.
Число та Відсоток
Окрім загальних правил, поля чисел та відсотків додатково підтримують валідацію точності.
Дата
Типи дат Joi відповідають наступним типам полів NocoBase: Дата (з часовим поясом), Дата (без часового поясу), Тільки дата та Мітка часу Unix.
Підтримувані правила валідації:
- Більше ніж
- Менше ніж
- Максимальне значення
- Мінімальне значення
- Валідація формату мітки часу
- Обов'язкове поле
Поля зв'язків
Поля зв'язків підтримують лише валідацію обов'язковості. Зверніть увагу, що валідація обов'язковості для полів зв'язків наразі не підтримується в сценаріях підформ або підтаблиць.
Застосування правил валідації
Після налаштування правил для полів, відповідні правила валідації будуть спрацьовувати при додаванні або зміні даних.
Правила валідації також застосовуються до компонентів підтаблиць та підформ:
Зверніть увагу, що у сценаріях підформ або підтаблиць валідація обов'язковості для полів зв'язків не діє.
Відмінності від клієнтської валідації полів
Клієнтська та серверна валідація полів застосовуються в різних сценаріях, і між ними існують значні відмінності у способах реалізації та моментах спрацьовування правил, тому ними потрібно керувати окремо.
Відмінності у способі налаштування
- Клієнтська валідація: Налаштування правил у формах редагування (як показано на зображенні нижче)
- Серверна валідація полів: Налаштування правил для полів у Джерелі даних → Конфігурація колекції
Відмінності у моментах спрацьовування валідації
- Клієнтська валідація: Спрацьовує в реальному часі, коли користувачі заповнюють поля, і негайно відображає повідомлення про помилку.
- Серверна валідація полів: Виконується на стороні сервера після надсилання даних, перед їх збереженням, а повідомлення про помилки повертаються через відповіді API.
- Область застосування: Серверна валідація полів діє не лише під час надсилання форм, але й спрацьовує в усіх сценаріях, що передбачають додавання або зміну даних, таких як робочі процеси та імпорт даних.
- Повідомлення про помилки: Клієнтська валідація підтримує власні повідомлення про помилки, тоді як серверна валідація наразі не підтримує власні повідомлення про помилки.