Image Added
← Powrót do listy dostępnych walidatorów
Opis walidatora
...
| 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. |
...
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)
Film instruktażowy
Mapa z przykładową konfiguracją
| View file |
|---|
| name | Testy komponentów - walidatory.zip |
|---|
| page | Walidatory cuf-components |
|---|
| height | 250 |
|---|
|
...
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" , "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. |
|
| Panel |
|---|
| title | Przykładowa konfiguracja |
|---|
|
 Image Added
|
| Panel |
|---|
| title | Przykład zastosowania |
|---|
|
Przykłady:| Expand |
|---|
| 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 Added
|
|
| Panel |
|---|
|
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 |
|---|
|
|
