Walidacje złożone (własne)

Walidacje złożone wymagające implementacji algorytmu, implementowane są przez programistów i dołączane do biblioteki walidatorów znajdującej się w Eximee Validation. W przypadku gdy walidacja ma się odbywać poprzez usługi zewnętrzne (np. szyna ESB), konieczne jest użycie Service Proxy w celu udostępnienia danej usługi.

Jeśli walidacje nie wymagają połączenia z usługami zewnętrznymi, można skorzystać z lekkich walidatorów skryptowych (więcej w: Walidatory skryptowe (validationScript)). Walidatory złożone można stosować dla pól wniosku, stron lub komponentów złożonych (wykorzystywanych później na wniosku).

Walidacje złożone dla komponentów

Poza wymagalnością i maską, do komponentów można dodawać również specjalizowane walidatory zewnętrzne.

Podpięcie walidatora

Aby podpiąć walidator, należy wejść w tryb edycji artefaktu i wybrać dowolny komponent mający możliwość podpięcia walidatora. Następnie należy kliknąć sekcję Jakość danych w menu właściwości komponentu. Po rozwinięciu sekcji zobaczymy podsekcję WALIDATORY.

Ilustracja 1. Sekcja "Jakość danych" z podsekcją WALIDATORY

Po kliknięciu na WALIDATORY lub ikonę ołówka, wysunięte zostanie okno walidatorów.

Ilustracja 2. Okno walidatorów

Po wybraniu opcji Wybierz walidator będziemy mogli wyszukać oraz wybrać dany walidator. Na liście zawarte są standardowe walidatory oraz walidatory skryptowe. Dla walidatora można zdefiniować warunek wywołania (pole Dodaj warunek). Jest to warunek JavaScriptowy, w którym można użyć pól lub zmiennych sesyjnych dostępnych na wniosku. Sposób tworzenia warunków został opisany w Język wyrażeń definiowania warunków (warunki z getValue).

Ilustracja 3. Dodanie walidatora

Symulacja

Walidatory, tak samo jak w przypadku usług zewnętrznych, wspierają możliwość zastąpienia ich działania skryptem symulacyjnym. Podpinanie takiego skryptu wymaga wybrania w oknie walidatorów zakładki Symulacja oraz wybrania z listy dostępnego skryptu symulacyjnego.

Ilustracja 4. Zakładka podpięcia skryptu symulacyjnego

Z tego poziomu możemy również zdecydować się na utworzenie nowego skryptu klikając przycisk Generuj nowy skrypt. Nowo utworzony skrypt będzie miał automatycznie wygenerowaną treść zgodną z walidatorem oraz opisanymi wydzielonymi sekcjami kodu.

Ilustracja 5. Tworzenie skryptu symulacyjnego

Należy pamiętać, że takie skrypty zostaną uruchomione jedynie w przypadku wejścia na wniosek z włączonym trybem symulacji logiki wniosku!

Walidacje złożone na stronie

Dodanie walidatorów na stronie

Walidatory można dodawać również na stronie:

• Jeżeli strona nasłuchuje na pola, które przekazujemy do walidatora, walidator jest wołany przy zmianie pola, na które strona nasłuchuje.

• Jeżeli strona nie będzie nasłuchiwać na pola, walidator zostanie wywołany dopiero po kliknięciu przycisku Dalej/Wyślij.

Ilustracja 6. Panel właściwości z dodanymi dwoma walidatorami dla strony Page1

Dodanie walidatorów na komponencie złożonym

Istnieje możliwość dodania walidatorów na komponencie złożonym. Będą one działały tak, jakby były dodane na stronie, na której znajduje się komponent złożony.

Dodanie tłumaczeń komunikatów walidacji

Każdy walidator zwraca komunikat walidacyjny. Treść komunikatu może być już przetłumaczona na język polski lub może być w innym języku. Po podpięciu walidatora należ przejść do zakładki Tłumaczenia i wyszukać właściwy klucz błędu w celu zmiany tłumaczenia.

Jeśli komunikat walidatora zawiera parametry, to w tłumaczeniu należy je także umieścić w odpowiednim miejscu.

Ilustracja 7. Przykład tłumaczeń komunikatu dla walidatora z przekazywaniem parametrów

Więcej informacji w Tworzenie walidatorów.