← Powrót do listy dostępnych walidatorów

Jeśli masz problem ze zrozumieniem jak działa walidator, sprawdź opisy: Walidator, Wykonanie warunkowe, Parametry komponentów

Opis walidatora

Przyjmuje wynik funkcji podanej w parametrze, która ewaluuje dane pod względem prawidłowości. Jeżeli funkcja logiczna zwróci prawdę, to walidator przechodzi dalej. Jeżeli zwróci fałsz, to pokaże komunikat.

Update:

W walidatorze istnieje możliwość walidowania tabel dynamicznych. Aby zwalidować tabelę należy określić, czy sprawdzanie warunku ma się odnosić do każdego wiersza w tabeli, czy też dowolnego wiersza w tabeli.

Przykładowa konfiguracja

Przykład 1. Chcę, aby tabela posiadała PRZYNAJMNIEJ JEDEN wpis, gdzie w kolumnie "uzytkownik" wpisana jest nazwa aktualnego użytkownika.

Przykład 2. Chcę, aby formularz przepuszczał użytkownika dalej jedynie w przypadku, gdy WSZYSTKIE wiersze w kolumnie "zadluzenie" są równe 0.

Pierwszym krokiem jest wybranie odpowiedniej wartości z parametru: "Użycie tabeli w funkcji". Dla przykładu pierwszego będzie to "Funkcja z użyciem kolumn(jakikolwiek wiersz)", dla przykładu drugiego "Funkcja z użyciem kolumn(każdy wiersz)".

UWAGA: Zmienne "Każdy wiersz" i "Jakikolwiek wiersz" nie mogą zostać użyte razem w funkcji walidującej. Pomimo pojawiania się obu z nich w menu wyboru zmiennej to tylko zmienna wybrana w parametrze "Użycie tabeli w funkcji" będzie działać poprawnie.

Po wybraniu odpowiedniego parametru możemy użyć następującego zestawu funkcji:

Dla przykładu 1: eq(item($Jakikolwiek wiersz, $uzytkownik), $aktualny_uzytkownik)

Gdzie: $Jakikolwiek wiersz to zmienna kontekstowa(powinna się pojawić po wpisaniu dolara), $użytkownik to zmienna kolumnowa, którą chcemy sprawdzić, a $aktualny_użytkownik to zmienna przetrzymująca login aktualnego użytkownika.

Dla przykładu 2: eq(item($Każdy wiersz, $zadluzenie), 0)

Gdzie: $Każdy wiersz to zmienna kontekstowa(powinna się pojawić po wpisaniu dolara), a $zadluzenie to zmienna kolumnowa, którą chcemy sprawdzić

Parametry konfiguracyjne

Funkcja ( typ : funkcja ) - Funkcja zwracająca wynik typu logicznego.

Potwierdzenie ( typ : wartość logiczna ) - Decyduje o tym, czy okienko informujące o błędzie zastąpić okienkiem potwierdzenia (dla wartości true).

Komunikat ( typ : wartość tekstowa ) - Treść alertu

Użycie tabeli w funkcji ( typ : wartość tekstowa ) - Określa czy, i w jaki sposób użyć wartości kolumn z tabeli dynamicznej

Długość tabeli ( typ : wartość całkowita ) - Liczba wierszy w tabeli(można uzyskać przekazując długość dowolnej z kolumn tabeli)

UWAGA: Dokumentacja do nowej wersji komponentu:

The license could not be verified: License Certificate has expired!

Opis walidatora

Walidator sprawdza dane za pomocą funkcji podanej w parametrze. Gdy funkcja logiczna zwróci prawdę to walidator przechodzi dalej. W przeciwnym razię wyświetla komunikat skonfigurowany w komponenicie.

Domyślna konfiguracja

Parametry konfiguracyjne:

Warunek logiczny( typ : funkcja ) - Funkcja zwracająca wynik typu logicznego. Gdy funkcja zwraca wynik pozytywny to akceptuje walidacje. W przeciwnym razie wyświetla komunikat o błędzie.

Użycie tabeli w funkcji ( typ : lista wyboru ) - Określa czy, i w jaki sposób użyć wartości kolumn z tabeli dynamicznej. Do wyboru: "Funkcja bez użycia kolumn" , "Funkcja z użyciem kolumn(każdy wiersz)" , "Funkcja z użyciem kolumn(jakikolwiek wiersz)"

UWAGA

Parametr ten ustawia dwa ukryte parametry na dynamicznym formularzu, oraz ukrywa/pokazuje parametr "Długość tabeli".

Dla funkcji z użyciem kolumn należy używać odpowiednich zmiennych kontekstowych. Zmienne 0 do wartości podanej w "Długość tabeli" Przydatna funkcja systemowa item()

"Funkcja z użyciem kolumn(każdy wiersz)" - Akceptuję tylko wtedy gdy dla wszystkich wierszy funkcja zwróci pozytywny wynik. Zmienna kontekstowa "Każdy wiersz"

"Funkcja z użyciem kolumn(jakikolwiek wiersz)" - Akceptuję gdy dla co najmniej jednego wiersza funkcja zwróci pozytywny wynik. Zmienna kontekstowa "Jakikolwiek wiersz"

Długość tabeli ( typ : wartość całkowita ) - Liczba wierszy w tabeli (można uzyskać przekazując długość dowolnej z kolumn tabeli) Parametr opcjonalny, ale wymagany do opcji z tabelą.

UWAGA

Parametr ten będzie czyszczony przy każdym ukryciu. Dla pustej tabeli (długość 0 lub mniej) walidator zaakceptuje zadanie.

Przy podaniu wartości większej niż ilość wierszy wyrzuci komunikat w formacie "Nieprawidłowa długość tablicy : X" gdzie X to podana wartość tego parametru

Typ komunikatu ( typ : lista wartości ) - Lista wyboru konfiguracji pojawienia się komunikatu. Możliwe opcje: "Globalny", Obok zmiennej", "Globalny i obok zmiennej".

UWAGA

Wartość przekazywana do parametru to (po kolei): "global" , "local", "localandglobal".

Potwierdzenie ( typ : wartość logiczna ) - Informuje o tym, czy wyświetlić okienko potwierdzenia.

UWAGA

Dostępne tylko w trybie globalnym.

Parametry opcjonalne:

Komunikat globalny ( typ : wartość tekstowa ) - Treść komunikatu w oknie z błędem/oknie potwierdzenia.

Zmienne formularza ( typ : zmienna formularza ) - Zmienna, obok której będzie wyświetlony komunikat.

UWAGA

Gdy wybierzemy zmienną znajdująca się w tabeli dynamicznej. to w zależności od wybranej opcji w "Użycie tabeli w funkcji " będzie inny komunikat.

Dla opcji "Funkcja bez użycia kolumn" zostanie wyświetlony komunikat globalny w formacie "[ Nazwa_Zmiennej ] treść_komunikatu" (Przykład 2)

Dla pozostałych opcji zostaną zaznaczone nie pasujące wiersze w danej kolumnie( na czerwono), po najechaniu myszką zostanie wyświetlony komunikat błędu (taki sam dla wszystkich nie pasujących wierszy) (Przykład 1)

Komunikat obok zmiennej ( typ : wartość tekstowa ) - Treść komunikatu błędu, który pojawi się przy wybranej zmiennej formularza.

UWAGA

W przypadku pustej wartości komunikat sie nie wyświetla. Można to wykorzystać do sterowania komunikatami za pomocą funkcji ifFn() oraz emptyString(). Gdy mamy tylko tryb "Obok zmiennej" i nie będzie żadnego komunikatu to walidator przepuści formularz.

Przykłady:

Przykład 1.

Opis
Walidacja tylko w tedy gdy kolumna "Opiniujący" jest cała wypełniona (każdy wiersz). Komunika błędu pojawi się przy każdej niewypełnionej komórce w zaznaczonej kolumnie (zmiennej formularza)
Konfiguracja
Wynik

Przykład 2:

Opis
Użytkownik w tabeli planuje koszty. Gdy suma kosztów jest większa niż przyznany fundusz, lub gdy fundusz jest ustawiony na 0 lub mniej walidacja nie przechodzi. Komunikat błędu pojawia się globalny i przy zmiennej. W konfiguracji nie sprawdzamy warunku na każdym wierszu więc komunikat dotyczący zmiennych tabelarycznych automatycznie będzie globalny.
Konfiguracja
Wynik