← 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
Dokumentacja dla starszej wersji
Podstawowe informacje
Kategoria: Ogólne
Dostępna od wersji: 1.0.0
Opis
Walidator sprawdza dane za pomocą funkcji podanej w parametrze. Gdy funkcja logiczna zwróci prawdę to walidator przechodzi dalej. W przeciwnym razie wyświetla komunikat skonfigurowany w komponencie.
Parametry konfiguracyjne
| Nazwa parametru | Od wersji | Opis | Typ parametru | Wartość domyślna | Rodzaj pola | Uwagi i ograniczenia |
|---|---|---|---|---|---|---|
| Warunek logiczny* | 1.0.0 | Funkcja zwracająca wynik typu logicznego. Gdy funkcja zwraca wynik pozytywny to akceptuje walidacje. W przeciwnym razie wyświetla komunikat o błędzie. | Funkcja | Pole edytowalne | Przekazywana funkcja musi zwracać typ logiczny. | |
| Użycie tabeli w funkcji* | 1.0.10 | Określa czy, i w jaki sposób użyć wartości kolumn z tabeli dynamicznej. | Tekst | Lista wartości | Do wyboru: "Funkcja bez użycia kolumn" , "Każdy wiersz" , "Jakikolwiek wiersz". Parametr ten ukrywa/pokazuje parametr "Długość tabeli". "Każdy wiersz" - Akceptuje tylko wtedy, gdy dla wszystkich wierszy funkcja zwróci pozytywny wynik. Do identyfikatora wiersza możemy odnieść się przy pomocy zmiennej "Id wiersza" (dla starszych wersji: "Każdy wiersz") "Jakikolwiek wiersz" - Akceptuje, gdy dla co najmniej jednego wiersza funkcja zwróci pozytywny wynik. Do identyfikatora wiersza możemy odnieść się przy pomocy zmiennej "Id wiersza" (dla starszych wersji: "Jakikolwiek wiersz") | |
| Długość tabeli?* | 1.0.10 | Liczba wierszy w tabeli (można uzyskać przekazując długość dowolnej z kolumn tabeli) Parametr opcjonalny, ale wymagany do opcji z tabelą. | Całkowity | Pole edytowalne | 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* | 1.0.6 | Lista wyboru konfiguracji pojawienia się komunikatu. Możliwe opcje: "Globalny", Obok zmiennej", "Globalny i obok zmiennej". | Tekst | Edytowalna lista wartości | Wartości do wyboru: Tak/Nie. Parametr ukryty od wersji 1.0.6, należy korzystać z rozwiązania systemowego. Widoczny jedynie, jeżeli został wcześniej ustawiony na "Tak". Wartość przekazywana do parametru to (po kolei): "global" , "local", "localandglobal" | |
| Potwierdzenie | 1.0.6 | Informuje o tym, czy wyświetlić okienko potwierdzenia. | Logiczny | Pole edytowalne | Parametr ukryty od wersji 1.0.6, należy korzystać z rozwiązania systemowego. Widoczny jedynie, jeżeli został wcześniej uzupełniony. | |
| Komunikat globalny | Treść komunikatu w oknie z błędem/oknie potwierdzenia. | Tekst | ||||
| Zmienne formularza | Zmienna, obok której będzie wyświetlony komunikat. | Zmienna | 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 | Treść komunikatu błędu, który pojawi się przy wybranej zmiennej formularza. | Tekst | W przypadku pustej wartości zmienna nie zostaje zaznaczona, a komunikat się 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ładowa konfiguracja
Przykład zastosowania
Przykłady:
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
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
Change log
1.0.0
Dodanie komponentu
1.0.10
Obsługa tabeli dynamicznej
1.0.30
Komunikat globalny i dla danego pola
Poprawienie dynamicznego formularza
1.0.35
Zastąpienie dwóch zmiennych kontekstowych przez jedną
The license could not be verified: License Certificate has expired!
3 Comments
Dział Wdrożeń
W jaki sposób zwalidować jedynie te wiersze, które w danej kolumnie przyjmą określoną wartość ?
Adrian Kozica
Można dać warunek OR(not(item(kazdy wiersz, kolumna)), <warunek walidacji dla tych wierszy>)
Adrian Kozica
Innymi słowy:
"Przepuść każdy wiersz, który nie zawiera podanej wartości w tej kolumnie, lub wiersz, który spełnia warunek ..."
Add Comment