Pole walidowane
Czym jest pole walidowane
Pole walidowane jest krótkim polem tekstowym z dodatkowym sprawdzeniem poprawności wpisanej wartości. Stosuje się je wtedy, gdy użytkownik ma wpisać dane o znanym formacie, na przykład PESEL, NIP, REGON, IBAN, kod pocztowy albo adres e-mail.
Walidacja działa po stronie wartości zapisanej w polu. Użytkownik może wpisać tekst, a system sprawdza go według wybranego typu walidatora. Jeśli wartość nie spełnia warunków, pole zostaje oznaczone jako niepoprawne.
Pusta wartość przechodzi sprawdzenie walidatora. Jeśli pole ma być obowiązkowe, ustaw także wymagalność pola w konfiguracji formularza.
Walidacja a maska wpisywania
Walidacja i maska wpisywania pełnią różne role.
Maska pomaga użytkownikowi wprowadzić tekst w określonym układzie znaków, na przykład w układzie numeru rachunku albo kodu pocztowego. Walidator sprawdza, czy gotowa wartość spełnia reguły wybranego typu danych.
Przykład: dla numeru PESEL sam układ 11 cyfr nie wystarcza. Walidator sprawdza także sumę kontrolną, więc przypadkowy ciąg 11 cyfr może zostać odrzucony.
Dostępne walidatory
| Walidator | Co sprawdza |
|---|---|
| Czy wartość ma format adresu e-mail. | |
| IBAN | Czy wartość przechodzi ogólną kontrolę IBAN modulo 97. |
| PL IBAN | Czy polski numer rachunku ma poprawną długość, cyfry i sumę kontrolną IBAN. |
| PL NIP | Czy NIP ma poprawną strukturę i cyfrę kontrolną. |
| PL PESEL | Czy PESEL ma 11 cyfr i poprawną sumę kontrolną. |
| PL kod pocztowy | Czy wartość ma format NN-NNN. |
| PL REGON | Czy REGON ma poprawną długość i sumę kontrolną. |
| PL dowód osobisty | Czy numer dowodu ma poprawny układ i cyfrę kontrolną. |
| DE IBAN | Czy niemiecki IBAN ma prefiks DE, właściwą długość i poprawną sumę kontrolną. |
| DE Steuer-Identifikationsnummer | Czy niemiecki numer identyfikacji podatkowej ma poprawną strukturę i cyfrę kontrolną. |
| DE Rentenversicherung | Czy niemiecki numer ubezpieczenia emerytalnego ma poprawną strukturę i cyfrę kontrolną. |
| DE Ausweisnummer | Czy numer niemieckiego dokumentu w starym formacie spełnia wymagania struktury i cyfr kontrolnych. |
| DE Umsatzsteuer ID | Czy niemiecki numer VAT UE ma prefiks DE i poprawną cyfrę kontrolną. |
| DE Betriebsnummer | Czy niemiecki numer zakładu ma poprawną strukturę i cyfrę kontrolną. |
| REGEX | Czy wartość pasuje do wyrażenia regularnego podanego w konfiguracji pola. |
Szczegóły walidatorów polskich
PL PESEL
Wartość musi mieć 11 cyfr. System mnoży kolejne cyfry przez wagi 1, 3, 7, 9, 1, 3, 7, 9, 1, 3, 1. Wynik jest poprawny, gdy suma iloczynów daje resztę 0 z dzielenia przez 10.
Kontrola dotyczy długości, cyfr i sumy kontrolnej. Wymagalność pola oraz wykorzystanie daty urodzenia zapisanej w numerze są osobnymi zagadnieniami.
PL NIP
Przed sprawdzeniem system usuwa spacje i myślniki. NIP musi mieć 10 cyfr, a pierwsza cyfra musi być różna od 0.
Cyfra kontrolna jest wyliczana z pierwszych 9 cyfr. System używa wag 6, 5, 7, 2, 3, 4, 5, 6, 7 i porównuje wynik modulo 11 z ostatnią cyfrą numeru.
PL REGON
Przed sprawdzeniem system usuwa spacje i myślniki. REGON może mieć 9 albo 14 cyfr.
Dla numeru 9-cyfrowego system używa wag 8, 9, 2, 3, 4, 5, 6, 7 i porównuje cyfrę kontrolną z dziewiątą cyfrą. Jeśli wynik modulo 11 wynosi 10, za cyfrę kontrolną przyjmowane jest 0.
Dla numeru 14-cyfrowego system najpierw sprawdza pierwsze 9 cyfr, a potem sprawdza całość z wagami 2, 4, 8, 5, 0, 9, 7, 3, 6, 1, 2, 4, 8.
PL IBAN
System usuwa spacje i myślniki. Wartość może zaczynać się od prefiksu PL. Po usunięciu prefiksu numer musi mieć 26 cyfr.
Walidacja wykorzystuje standardową kontrolę IBAN modulo 97. Wynik jest poprawny, gdy po przekształceniu numeru reszta z dzielenia wynosi 1.
PL kod pocztowy
Wartość musi mieć format NN-NNN, czyli dwie cyfry, myślnik i trzy cyfry.
PL dowód osobisty
System usuwa spacje i myślniki oraz zamienia litery na wielkie. Numer musi mieć 9 znaków: 3 litery i 6 cyfr.
Cyfra kontrolna jest porównywana z czwartym znakiem numeru. System używa wag 7, 3, 1, 0, 7, 3, 1, 7, 3.
Szczegóły walidatorów międzynarodowych i niemieckich
Wartość musi mieć format adresu e-mail: część lokalną, znak @, domenę i końcówkę domeny.
IBAN
System wykonuje ogólną kontrolę IBAN modulo 97. Walidator obsługuje litery i spacje, a wynik jest poprawny, gdy reszta z dzielenia wynosi 1.
DE IBAN
Wartość musi mieć 22 znaki, zaczynać się od prefiksu DE i przejść kontrolę IBAN modulo 97.
DE Steuer-Identifikationsnummer
Wartość musi mieć 11 cyfr. W pierwszych 10 cyfrach jedna cyfra występuje dwa razy, a pozostałe występują po jednym razie. System sprawdza też cyfrę kontrolną.
DE Rentenversicherung
Wartość musi mieć 12 znaków. Dziewiąty znak jest literą, a pozostałe znaki są cyframi. System przelicza literę na wartość liczbową i sprawdza cyfrę kontrolną.
DE Ausweisnummer
Walidator dotyczy starego formatu niemieckiego dokumentu tożsamości. Wartość musi mieć 26 znaków, zawierać literę D w pozycji oznaczającej narodowość i przejść kontrolę czterech cyfr kontrolnych.
DE Umsatzsteuer ID
Wartość musi mieć 11 znaków, zaczynać się od prefiksu DE, a pozostała część musi przejść kontrolę cyfry kontrolnej.
DE Betriebsnummer
Wartość musi mieć 8 cyfr. Pierwsze trzy cyfry muszą mieścić się w zakresie 010-099 albo być większe lub równe 110. System sprawdza także cyfrę kontrolną.
Walidacja przez REGEX
Walidator REGEX pozwala sprawdzić wartość według własnego wyrażenia regularnego. Stosuj go wtedy, gdy dostępne walidatory nie obejmują potrzebnego formatu.
Przykład zastosowania: własny numer klienta, kod wewnętrzny, numer umowy albo identyfikator zgodny z lokalnym standardem organizacji.
Przy wyrażeniu regularnym opisz administratorom procesu oczekiwany format danych. Samo wyrażenie bywa trudne do odczytania dla osób, które później utrzymują formularz.
Kiedy używać pola walidowanego
Pole walidowane wybieraj dla danych, które użytkownik wpisuje ręcznie i które mają jednoznaczny format. Dobrymi przykładami są identyfikatory podatkowe, numery rachunków, numery dokumentów i adresy e-mail.
Jeśli chcesz ograniczyć sposób wpisywania znaków, rozważ także maskę. Jeśli chcesz wymusić uzupełnienie wartości, ustaw pole jako wymagane.