Validate

Zastosowanie

Funkcja Validate sprawdza wartość wybranym walidatorem, np. czy tekst jest poprawnym adresem e-mail, numerem PESEL albo numerem NIP. Walidator EU_NIP sprawdza numer VAT w bazie VIES.

Składnia

Validate("validatorName","value");

Validate("validatorName","value","countryCode");

Argumenty

Argument	Typ	Wymagany	Opis
`validatorName`	tekst	Tak	Nazwa walidatora. Dozwolone wartości: `NONE`, `PL_PESEL`, `PL_NIP`, `PL_REGON`, `PL_IBAN`, `PL_POSTAL`, `PL_DowodOsobisty`, `DE_STEUERIDENTIFIKATION`, `DE_RENTENVERSICHERUNGS`, `DE_AUSWEISNUMMEROLD`, `DE_UMSATZSTEUERID`, `DE_BETRIEBSNUMMER`, `DE_IBAN`, `E_MAIL`, `DATETIME`, `EU_NIP`, `IBAN`. Walidator `NONE` dla niepustej wartości zawsze zwraca `false`.
`value`	tekst	Tak	Wartość do sprawdzenia.
`countryCode`	tekst	Nie	Tylko dla walidatora `EU_NIP`: kod kraju numeru VAT. Jeżeli go nie podasz, pierwsze dwa znaki `value` muszą być kodem kraju, np. `PL123456789`.

Zwracana wartość

Funkcja zwraca wartość logiczną: true, jeżeli wartość przeszła walidację, w przeciwnym razie false. Dla pustej wartości funkcja zwraca true niezależnie od walidatora.

Przykłady

Przykład 1: adres e-mail

Funkcja sprawdza, czy podana wartość jest poprawnym adresem e-mail. W tym przypadku zwraca true.

isValid = Validate("E_MAIL","john@doe.pl");

Przykład 2: numer VAT z kodem kraju na początku

Funkcja sprawdza w bazie VIES, czy numer VAT (NIP), który zaczyna się od kodu kraju, jest poprawnym numerem EU_NIP.

if(Validate("EU_NIP","PL123456789"))
{
ShowMessage(2,"OK");
}
else
{
ShowMessage(1,"NOT_OK");
}

Przykład 3: numer VAT i osobny kod kraju

Funkcja sprawdza w bazie VIES, czy numer VAT (NIP) z osobno podanym kodem kraju jest poprawnym numerem EU_NIP.

if(Validate("EU_NIP","123456789","PL"))
{
ShowMessage(2,"OK");
}
else
{
ShowMessage(1,"NOT_OK");
}

Przykład 4: numer VAT i kod kraju z pól sprawy

Funkcja sprawdza w bazie VIES numer VAT (NIP) z pola nip i kod kraju z pola countrycode.

if(Validate("EU_NIP",[nip],[countrycode]))
{
ShowMessage(2,"OK");
}
else
{
ShowMessage(1,"NOT_OK");
}

Dobre praktyki

Podawaj nazwę walidatora dokładnie tak, jak na liście dozwolonych wartości.
Przy walidatorze EU_NIP podaj kod kraju na początku numeru albo w osobnym argumencie.

Typowe błędy

Nazwa walidatora spoza listy albo zapisana inną wielkością liter. Reguła zakończy się błędem. Użyj nazwy z listy dozwolonych wartości.
Nieprawidłowy albo brakujący kod kraju przy EU_NIP. Walidacja się nie powiedzie, nawet jeśli numer jest poprawny. Podaj kod kraju zgodny z numerem.
Oczekiwanie błędu reguły, gdy walidator nie zadziała (np. baza VIES jest niedostępna). Wyjątek wewnątrz walidatora nie przerywa reguły: funkcja zwraca wtedy false, tak samo jak dla niepoprawnej wartości.
Traktowanie pustej wartości jako błędnej. Dla pustej wartości funkcja zwraca true. Jeżeli wartość jest wymagana, sprawdź osobno, czy nie jest pusta.