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.

Ilustracja 1. Przykład podpiętego suggestera w Eximee Designer

Wniosek demo: demoSuggester