Podpięcie słownikowego źródła danych

Eximee umożliwia zasilenie komponentów formularza danymi pochodzącymi ze słowników – czyli predefiniowanych list wartości utrzymywanych w Bibliotece platformy. Słowniki są wygodne dla list rozwijanych czy grup przycisków wyboru, gdyż centralnie zarządzają zestawami opcji (np. lista krajów, lista typów dokumentów). Aktualizacja słownika w jednym miejscu może automatycznie wpłynąć na wszystkie wnioski korzystające z niego.

Konfiguracja krok po kroku:

1. Przygotowanie słownika: Należy upewnić się, że wymagany słownik został utworzony w systemie (w module Słowniki biblioteki Eximee). Trzeba sprawdzić, czy zawiera aktualne klucze i wartości, a w razie potrzeby utworzyć nowy słownik zgodnie z wymaganiami (np. ListaKrajów z kodami i nazwami państw).

2. Wybór komponentu: W Eximee Designer należy zaznaczyć komponent, który ma być zasilany ze słownika. Mogą to być: Pole wyboru wartości z listy (Combobox), Pole tekstowe, Radio grupa lub Grupa checkbox – wszystkie te typy obsługują źródła słownikowe.

3. Wybór słownika jako EDS: W panelu Właściwości → Interakcje komponentu należy kliknąć w polu Źródło danych zewnętrznych i wybrać Wybierz serwis. Na liście dostępnych źródeł trzeba odnaleźć nazwę odpowiedniego słownika. Słownik pojawia się na liście tak samo jak usługi. Po wybraniu słownika w polu Źródło danych zewnętrznych pojawi się jego nazwa.

   

   Ilustracja 1. Okno wyboru zewnętrznego źródła danych z wybranym słownikiem
4. Mapowanie parametrów (warunkowe słowniki): W przypadku standardowego słownika (bez warunków) nie jest wymagane żadne mapowanie – komponent automatycznie pobiera wszystkie klucze i wartości. Jeśli jednak używany jest słownik warunkowy, w zakładce Parametry wejściowe pojawią się parametry, które należy zmapować. Zazwyczaj są to inne pola formularza, od których zależy zawartość słownika (np. słownik Miasta zależny od wybranego Województwa). W takim przypadku należy przypisać odpowiednie komponenty do parametrów, analogicznie jak przy mapowaniu wejścia usługi.

   

   Ilustracja 2. Przykład zmapowania parametrów wejściowych dla słownika z ustalonymi warunkami wyświetlania kluczy
5. Zapis: Po zakończeniu konfiguracji należy zapisać zmiany. Podczas działania wniosku komponent zostanie automatycznie wypełniony danymi ze słownika. W przypadku słownika warunkowego lista wartości będzie odświeżana automatycznie po zmianie pola, od którego zależy (np. zmiana Województwa spowoduje przeładowanie listy Miast).

Podpięcie skryptu

Źródłem danych dla komponentu zasilanego słownikowym źródłem może być także serwis skryptowy. Rozwiązanie takie pozwala na napisanie skryptu, który może np. wyliczać wartości słownikowe zależne od parametru wejściowego lub zwracać różne wartości dla różnych języków.

Ilustracja 3. Przykład skryptu zwracającego słownik z parametrami wejściowymi