# 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.<br>

   <figure><img src="/files/MhUOM8veXx7r6Xgnyce1" alt="" width="454"><figcaption><p><em><strong>Ilustracja 1.</strong> Okno wyboru zewnętrznego źródła danych z wybranym słownikiem</em></p></figcaption></figure>
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.<br>

   <figure><img src="/files/ecVvsrhXL4hH34H1kQVE" alt=""><figcaption><p><em><strong>Ilustracja 2.</strong> Przykład zmapowania parametrów wejściowych dla słownika z ustalonymi warunkami wyświetlania kluczy</em></p></figcaption></figure>
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 <a href="#podpiecieslownikowegozrodladanych-podpiecieskryptu" id="podpiecieslownikowegozrodladanych-podpiecieskryptu"></a>

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

<figure><img src="/files/mUUSjLpAIpzHJ3ytbHYJ" alt="" width="563"><figcaption><p align="center"><em><strong>Ilustracja 3.</strong> Przykład skryptu zwracającego słownik z parametrami wejściowymi</em></p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/zasilanie-wartosciami-z-zewnetrznych-zrodel/podpiecie-slownikowego-zrodla-danych.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.