Lista wielowyboru (SQL)

Podsumowanie:
Lista wielowyboru pozwala wpisać w polu formularza kilka wartości ze zdefiniowanego zbioru. Zbiór wartości definiuje się zapytaniem SQL jako parę kolumn key i value. W polu tabeli powiązanym z kontrolką zapisywane są wartości key dla wybranych pozycji, a na liście wyświetlane sa wartości value dla tych pozycji. Lista wielowyboru jest odpowiednia dla pól formularza o typie danych nvarchar.

Oprócz właściwości typowych dla większości kontrolek, dla listy wielowyboru należy określić następujące zależności:

Zapisz w tabeli relacyjnej: jeśli ten przyłącznik jest wyłączony (domyślnie), wartości wybrane na liście wielowyboru są zapisywane w kolumnie tabeli źródłowej formularza w formacie key1$,$key2$,$key3…, gdzie key1/2/3 to wartości kolumny [key] zwracanej przez zapytanie źródłowe dla kontrolki; po włączeniu przełącznika wartości są zapisywane osobno w tabeli core.FormFIeldEnrollments (razem z id definicji dokumentu, id bieżącego dokumentu i id pola formularza).

Niezależnie od stanu opcji zapisu w tabeli relacyjnej wartości z kolumny key są zapisywane jako tekst. Pozwala to obsłużyć wartości klucza o dowolnym typie danych. Jednak w przypadku, kiedy te wartości mają być następnie przetwarzane w ramach logiki biznesowej, należy pamiętać o ich konwersji na oryginalny typ danych.
Zachowuj wybrane wartości jako ustalone: po włączeniu zapisuje wartości wyświetlane na liście wielowyboru w kolumnie SelectedValue tabeli core.FormFIeldEnrollments; funkcja dostępna tylko wtedy, gdy wybrane wartości są zapisywane w tabeli relacyjnej.
Zaznacz/odznacz wszystko: po włączeniu dodaje do listy polecenie, która pozwala zaznaczyć wszystkie pozycje na liście lub anulować zaznaczenie wszystkich pozycji.
Pokazuj pełny tekst wybranych elementów: domyślnie tekst wartości wyświetlanych na liście może zostać skrócony, po włączeniu tego przełącznika zawsze będzie wyświetlany pełny opis.
Szerokość wybranego elementu: określa szerokość listy w jednostkach rem, a w przypadku listy wielowyboru, szerokość wybranej pozycji listy.

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

Dostępna w oknie dialogowym Konfiguracja listy wyboru tabela Lista zależności: kolumna - pole formularza nie ma zastosowania do listy wielowyboru.

|← Edytor tekstu |↑ Do góry |→ Lista wyboru (interesariusz) |