Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
titlePodstawowe informacje

Kategoria: Ogólne

Poprzednie nazwy: 

Dostępna od wersji: 1.0.0

...

Panel
titleParametry konfiguracyjne
 
Nazwa parametru
Panel
titlePrzykładowa konfiguracja

Image Removed

Opis walidatora

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.

Domyślna konfiguracja

 

Parametry konfiguracyjne:

...

Od 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".

Note
titleUWAGA

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()"

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ą.

...

notetitleUWAGA
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

...

notetitle
*1.0.6Lista wyboru konfiguracji pojawienia się komunikatu. Możliwe opcje: "Globalny", Obok zmiennej", "Globalny i obok zmiennej".
Tekst
 
UWAGA
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.

...

notetitle
Logiczny
 
UWAGA

Dostępne tylko w trybie globalnym.

Parametry opcjonalne:

...

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.

...

notetitleUWAGA
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.

...

notetitleUWAGA
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.

Panel
titlePrzykładowa konfiguracja

Image Added

Panel
titlePrzykład zastosowania

 

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

Panel
titleChange log

 11.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ą

...