# Podpięcie Suggestera – komponent z podpowiedziami

*Suggester* to specjalny rodzaj zewnętrznego źródła danych używany głównie dla pól tekstowych. Jego zadaniem jest podpowiedź lub automatyczna korekta wartości wpisanej przez użytkownika, zgodnie z określonym algorytmem. Suggester działa po stronie serwera – gdy użytkownik wprowadzi dane i opuści pole, usługa suggestera może np. zmodyfikować tę wartość (wymuszając określony format, zakres, itp.) lub zasugerować inną.

**Konfiguracja krok po kroku:**

1. **Wybór komponentu:** Należy zaznaczyć komponent typu **Pole tekstowe** (TextField), dla którego ma zostać włączony mechanizm podpowiedzi lub korekty.
2. **Wybór suggestera:** W panelu Właściwości trzeba przejść do sekcji Interakcje. W polu **Źródło danych zewnętrznych** należy kliknąć **Wybierz serwis**, a następnie z listy dostępnych źródeł wybrać odpowiedni **Suggester**. Po podpięciu w polu powinien pojawić się identyfikator suggestera (np. jego nazwa).
3. **Automatyczna aktualizacja wartości:** W sekcji Pozostałe właściwości pola tekstowego należy zaznaczyć opcję **Automatyczna aktualizacja wartości** (autoServerUpdate). Ustawienie to powoduje, że po każdym zakończeniu edycji pola (np. po wyjściu z pola lub utracie focusa) wartość zostanie przesłana na serwer. Dzięki temu suggester otrzyma wpisaną przez użytkownika wartość i będzie mógł zwrócić ewentualnie zmodyfikowaną. W przypadku braku włączenia opcji autoServerUpdate, suggester nie zadziała – zmiana wartości pola nie zostanie odnotowana po stronie serwera.
4. **Zakończenie konfiguracji:** Po zakończeniu konfiguracji należy zapisać zmiany. Od tego momentu pole tekstowe będzie powiązane z Suggesterem. Gdy użytkownik wpisze wartość i zakończy edycję (np. przejdzie do kolejnego pola), mechanizm suggestera przetworzy wprowadzoną wartość. Jeśli będzie wymagała korekty, system automatycznie podmieni ją na sugerowaną (np. zwiększy do minimalnej dozwolonej wartości). Suggester może również wyświetlać komunikaty dla użytkownika – na przykład informację o dokonanej korekcie.
5. **Dostosowanie komunikatów:** W przypadku, gdy suggester posiada domyślne komunikaty (np. w języku angielskim), warto je spolszczyć. W tym celu należy przejść do zakładki **Tłumaczenia** w edytorze wniosku i odszukać klucze komunikatów powiązane z danym **Suggesterem**. Następnie trzeba dodać odpowiednie tłumaczenia na język polski.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Ffcri0AiiC4sYasi4hx2Q%2Fimage.png?alt=media&#x26;token=0603409b-040e-486b-bb4a-15d1b0956382" alt="" width="563"><figcaption><p align="center"><em><strong>Ilustracja 1.</strong> Przykład podpiętego suggestera w Eximee Designer</em></p></figcaption></figure>

{% hint style="info" %}
Wniosek demo: demoSuggester
{% endhint %}


---

# 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-suggestera-komponent-z-podpowiedziami.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.