Lista wyboru (SQL - Async)

Podsumowanie:
Lista wyboru SQL - Async to lista z funkcją autouzupełniania. Po wpisaniu przez użytkownika określonej liczby znaków wczytywany jest podzbiór pozycji listy, które zawierają wpisany ciąg.

Oprócz właściwości typowych dla większości kontrolek, lista wyboru SQL - Async wymaga ustawienia właściwości:

Pole wartości ustalonej: wybierz z listy kolumnę w tabeli źródłowej formularza, w której zostanie zapisana wartość wyświetlana na liście rozwijanej (wartość z kolumny [value] zwracanej przez zapytanie w konfiguracji listy). Po zapisaniu instancji dokumentu ta wartość będzie wyświetlana na formularzu nawet wtedy, gdy odpowiadająca wartość w źródle danych listy rozwijanej zostanie zmieniona. W takiej sytuacji, po rozwinięciu listy podświetlana będzie zaktualizowana wartość odpowiadająca wartości ustalonej.

Pole wartości ustalonej nie jest widoczne w kontekście formularza ( ), a przypisana do niego kontrolka formularzu nie będzie wyświetlać danych.

Wypełnij po: liczba znaków, po wpisaniu których lista wyświetli pasujące wartości; aby lista działała zgodnie z przeznaczeniem, nie wolno wpisywać wartości 0 ani wartości przekraczającej długość pozycji na liście.

Info

Wpisany ciąg znaków jest wyszukiwany w całym tekście pozycji listy, np. jeśli lista zawiera nazwy miejscowości i wymagane jest wpisanie trzech znaków, dla ciągu rze zostaną zwrócone między innymi Przeworsk, Rzeszów i Zabrze.

Maks. liczba elementów: liczba pozycji listy zgodnych z wpisanym ciągiem, które zostaną wyświetlone na liście; wartość domyślna 50; ma na celu ograniczenie czasu wczytywania pozycji listy.
Ustawienia: kliknięcie przycisku Konfiguracja listy wyboru otwiera okno dialogowe, o tej samej nazwie.
Konfiguracja poprzez SQL: (domyślnie włączone) pozwala definiować źródło danych dla listy jako zapytanie SQL lub (po wyłączeniu) przy użyciu zdefiniowanej osobno kontrolki.
SQL: zapytanie SQL zwracające wartości listy; to zapytanie musi zwracać co najmniej dwie kolumny o nazwach [key] i [value]; wartości z kolumny [key] są zapisywane w polu formularza, a wartości z kolumny [value] (muszą być typu tekstowego) są wyświetlane na liście; zapytanie może zwracać inne kolumny, ich nazwy należy również podać w nawiasach prostokątnych.

SQL dla listy wyboru
Zdefiniowana lista wyboru: lista zdefiniowanych kontrolek (INTERFEJS UŻYTKOWNIKA > Kontrolki)

Wybór predefiniowanej kontrolki
Metoda sortowania zwracanych danych: lista wielowyboru, z której należy wybrać aliasy kolumn zdefiniowanych w zapytaniu SQL w celu posortowania pozycji na liście.
Pokaż zapytanie wynikowe: wyświetla okno edytora SQL z zapytaniem które dopasuje wpisany ciąg znaków i zwróci określoną liczbę pozycji dla listy asynchronicznej; w tym oknie dostępny jest przycisk Wykonaj zapytanie, który pozwala wyświetlić podgląd pozycji zwróconych dla listy z uwzględnieniem ustawionego sortowania.

Podgląd ustawień sortowania dla asynchronicznej listy wyboru

Lista zależności: kolumna - pole formularza: tabelka, która pozwala przypisać kolumnie zapytania źródłowego listy wyboru pole formularza. Kliknij ikonę edycji i wybierz pole formularza z rozwijanej listy. Przypisanie spowoduje, że po wybraniu pozycji z listy w powiązanym polu zostanie ustawiona wartość zwracana przez listę dla tej pozycji w odpowiedniej kolumnie.

Zamiast wybierać pola formularza, w kolumnie Powiązane pole formularza można także wpisać dowolną nazwę; spowoduje to utworzenie zmiennej w kontekście formularza, w której będzie przechowywana wartość zwrócona przez listę. Do takiej zmiennej można odwoływać się w wyrażeniach, używając standardowej składni {@nazwaZmiennej}.

Tryb aktualizacji pól zależnych: dostępne wartości:
- Zawsze: każda operacja otwarcia i odświeżenia formularza oraz zmiana na liście wyboru powoduje aktualizację wartości w polach zależnych.
- Tylko po zmianie na liście wyboru: aktualizacja wartości w polach zależnych odbywa się tylko po zmianie pozycji w liście rozwijanej (zmiana przez użytkownika lub np. przez akcję).
- Tylko gdy wskazane pole jest puste: wartości zwrócone przez listę wyboru są przekazywane do pól zależnych tylko wtedy, kiedy są one puste.

Na efekty działania tej funkcji ma wpływ zachowanie nAxiom przy odświeżaniu formularza. Kliknięcie ikony odświeżania w prawym górnym rogu formularza inicjuje działanie zależnie od typu okna formularza:

Dialog: zostaje ponownie wykonana akcja otwierania formularza z użyciem przekazywanych w niej parametrów.
Link wewnętrzny: formularz i dane rekordu zostają ponownie wczytane z bazy danych; ewentualne parametry przekazywane w akcji otwierania formularza zostają utracone. Tak samo działa przeładowanie strony w przeglądarce klawiszem F5.

Akcja odświeżenia formularza działa tak samo, niezależnie od typu okna formularza, to jest wczytuje ponownie formularz i dane rekordu z bazy danych. Jeśli formularz został otwarty akcją z przekazaniem parametrów, parametry zostaną utracone.

|← Lista wyboru (słownik hierarchiczny) |↑ Do góry |→ Lista wyboru (SQL) |