← 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 poniżej wersji 1.0.30

Kategoria: Ogólne

Dostępna od wersji: 1.0.0

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.

Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Warunek logiczny*1.0.0Funkcja zwracająca wynik typu logicznego. Gdy funkcja zwraca wynik pozytywny to akceptuje walidacje. W przeciwnym razie wyświetla komunikat o błędzie.Funkcja Pole edytowalnePrzekazywana funkcja musi zwracać typ logiczny.
Użycie tabeli w funkcji*1.0.10Okreś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.10Liczba 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 edytowalneParametr 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.6Lista wyboru konfiguracji pojawienia się komunikatu. Możliwe opcje: "Globalny", Obok zmiennej", "Globalny i obok zmiennej".Tekst Edytowalna lista wartościWartoś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"
Potwierdzenie1.0.6Informuje o tym, czy wyświetlić okienko potwierdzenia.Logiczny Pole edytowalneParametr 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ł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

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ą



Powiązane zadania