#Walidacja pól

Aby zapewnić dokładność, bezpieczeństwo i spójność danych w kolekcjach, NocoBase oferuje funkcję walidacji pól. Funkcja ta składa się z dwóch głównych części: konfiguracji reguł oraz ich zastosowania.

#Konfiguracja reguł

Pola systemowe NocoBase integrują reguły Joi, a ich obsługa przedstawia się następująco:

#Typ tekstowy (String)

Typy tekstowe (string) Joi odpowiadają w NocoBase następującym typom pól: Tekst jednowierszowy, Tekst wielowierszowy, Numer telefonu, E-mail, URL, Hasło oraz UUID.

#Reguły ogólne

• Minimalna długość
• Maksymalna długość
• Długość
• Wzorzec (Wyrażenie regularne)
• Wymagane

#E-mail

Zobacz więcej opcji

#URL

Zobacz więcej opcji

#UUID

Zobacz więcej opcji

#Typ liczbowy

Typy liczbowe Joi odpowiadają w NocoBase następującym typom pól: Liczba całkowita, Liczba oraz Procent.

#Reguły ogólne

• Większe niż
• Mniejsze niż
• Wartość maksymalna
• Wartość minimalna
• Wielokrotność

#Liczba całkowita

Oprócz reguł ogólnych, pola typu Liczba całkowita dodatkowo obsługują walidację liczb całkowitych oraz walidację niebezpiecznych liczb całkowitych.

#Liczba i Procent

Oprócz reguł ogólnych, pola typu Liczba i Procent dodatkowo obsługują walidację precyzji.

#Typ daty

Typy dat Joi odpowiadają w NocoBase następującym typom pól: Data (ze strefą czasową), Data (bez strefy czasowej), Tylko data oraz Znacznik czasu Unix.

Obsługiwane reguły walidacji:

• Większe niż
• Mniejsze niż
• Wartość maksymalna
• Wartość minimalna
• Walidacja formatu znacznika czasu
• Wymagane

#Pola powiązane

Pola powiązane obsługują jedynie walidację wymaganą. Należy pamiętać, że walidacja wymaganego pola powiązanego nie jest obecnie obsługiwana w scenariuszach podformularzy ani podtabel.

#Zastosowanie reguł walidacji

Po skonfigurowaniu reguł dla pól, odpowiednie reguły walidacji zostaną uruchomione podczas dodawania lub modyfikowania danych.

Reguły walidacji mają również zastosowanie do komponentów podtabel i podformularzy:

Należy pamiętać, że w scenariuszach podformularzy lub podtabel walidacja wymaganego pola powiązanego nie jest skuteczna.

#Różnice w stosunku do walidacji pól po stronie klienta

Walidacja pól po stronie klienta i serwera ma zastosowanie w różnych scenariuszach. Istnieją znaczące różnice w sposobie ich implementacji oraz momencie uruchamiania reguł, dlatego należy nimi zarządzać oddzielnie.

#Różnice w metodzie konfiguracji

• Walidacja po stronie klienta: Reguły konfiguruje się w formularzach edycji (jak pokazano na poniższym rysunku).
• Walidacja pól po stronie serwera: Reguły pól ustawia się w konfiguracji źródła danych → kolekcji.

#Różnice w momencie uruchamiania walidacji

• Walidacja po stronie klienta: Uruchamia walidację w czasie rzeczywistym, gdy użytkownicy wypełniają pola, i natychmiast wyświetla komunikaty o błędach.
• Walidacja pól po stronie serwera: Po przesłaniu danych, serwer przeprowadza walidację przed ich zapisaniem, a komunikaty o błędach są zwracane w odpowiedziach API.
• Zakres zastosowania: Walidacja pól po stronie serwera działa nie tylko podczas przesyłania formularzy, ale także we wszystkich scenariuszach związanych z dodawaniem lub modyfikowaniem danych, takich jak przepływy pracy czy import danych.
• Komunikaty o błędach: Walidacja po stronie klienta obsługuje niestandardowe komunikaty o błędach, natomiast walidacja po stronie serwera obecnie ich nie obsługuje.