Lista wyboru (SQL)

Podsumowanie:
Lista wyboru SQL to lista rozwijana, z której można wybrać jedną wartość. Może być używana dla pól różnego typu, o ile definiowana w zapytaniu kolumna [key] będzie zawierać dane zgodnego typu.

Oprócz właściwości typowych dla większości kontrolek, dla listy wyboru SQL należy ustawić 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.

Używaj stałej szerokości...: włączenie tego przełącznika ustala szerokość listy wyboru do wartości podanej w polu Szerokość wybranego elementu; jeśli wyłącznik będzie wyłączony, lista wypełni wszerz dostępne miejsce w sekcji formularza.
Szerokość wybranego elementu: określa szerokość listy w jednostkach rem, a w przypadku listy wielowyboru, szerokość wybranej 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
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 (SQL - Async) |↑ Do góry |→ Lista wyboru (WebService) |