Versions Compared

Key

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

Image Added

← 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

...

Panel
titlePodstawowe informacje

 

Kategoria: Ogólne

Dostępna od wersji: 1.0.0

Panel
titleOpis

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.

Panel
titleParametry konfiguracyjne

 Image Removed

Panel
titlePrzykładowa konfiguracja

 

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:

...

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

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:

Expand
titlePrzykł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

    Image Modified
  • Wynik

    Image Modified
Expand
titlePrzykł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

    Image Modified
  • Wynik

    Image Modified
  • Image Modified

...

Panel

 

Mapa z przykładową konfiguracją

View file
nameTesty komponentów - walidatory.zip
pageWalidatory cuf-components
height250

...

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



Hide If
special@anonymous

Powiązane zadania

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-8
 
 
JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-98

JIRA
server192.168.1.52 JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-152

JIRA
server192.168.1.52 JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-238

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-296