Image Added
← Powrót do listy dostępnych walidatoró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
Image Removed
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)
...
Zgłoszenia
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-152 |
|---|
|
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-238 |
|---|
|
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. Można wybrać typ komunikatu. Komunikat może być globalny (tak jak dotychczas), może być wyświetlony przy konretnej zmiennej lub tu i tu (w przypadku opcji podwójnej) Komunikat w trybie potwierdzenia możliwy tylko dla typu komunikatu globalnego.
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.
Domyślna konfiguracja
Image Removed
Parametry konfiguracyjne
...
| Info |
|---|
| title | Dokumentacja dla starszej wersji |
|---|
|
Dokumentacja poniżej wersji 1.0.30 |
| Panel |
|---|
| title | Podstawowe informacje |
|---|
|
Kategoria: OgólneDostępna od wersji: 1.0.0 |
| Panel |
|---|
|
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 |
|---|
| title | 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" , " |
|
...
...
| Note |
|---|
|
Parametr ten ustawia dwa ukryte parametry na dynamicznym formularzu, oraz 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ą. |
|
...
|
| Note |
|---|
|
| 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 | |
|
| Note |
|---|
|
| 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. |
|
...
|
note | title | UWAGA |
Dostępne tylko w trybie globalnym. |
Parametry opcjonalne
...
| 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 | |
|
note |
|
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. |
|
...
|
note | title | UWAGA| | 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 |
|---|
| title | Przykładowa konfiguracja |
|---|
|
 Image Added
|
| Panel |
|---|
| title | Przykład zastosowania |
|---|
|
Przykłady: |
...
| OpisWalidacja 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 AddedWynik Image Modified
|
|
...
| OpisUż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 AddedWynik Image Modified Image Modified
|
|
...
Mapa z przykładową konfiguracją
| View file |
|---|
| name | Testy komponentów - walidatory.zip |
|---|
| page | Walidatory cuf-components |
|---|
| height | 250 |
|---|
|
...
|
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 |
|---|
|
Powiązane zadania| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-8 |
|---|
|
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-98 |
|---|
|
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-152 |
|---|
|
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-238 |
|---|
|
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-296 |
|---|
|
|
