Inicjalizacja
Konfiguracja inicjalizacji listy pozycji umożliwia zdefiniowanie wartości, które mają zostać automatycznie wpisane do wierszy listy pozycji, po otwarciu formularza. Możliwe jest ponadto inicjalizowanie kolumn, które nie są wyświetlane na formularzu (została ograniczona ich widoczność lub zostały oznaczone jako kolumny techniczne).
1. Tryb działania
Wybór trybu działania:
- Inicjalizuj tylko na kroku startowym – opcja inicjalizuje pozycje listy tylko na pierwszym kroku,
- Inicjalizuj na wszystkich krokach (z wyjątkiem końcowych) – opcja umożliwia inicjalizację listy pozycji również na innych krokach z wyjątkiem kroków końcowych w sytuacji, gdy lista nie była dotychczas edytowana i brak wersji z poprzednich kroków w historii.
2. Inicjalizacja
Dostępne opcje inicjalizacji:
- Użyj źródła danych lub połączenia – umożliwia inicjalizację z wykorzystaniem zapytania SQL zwracającego wiersze, z którymi lista zostanie zainicjalizowana, lub mapowania kolumn,
- Użyj inicjalizacji statycznej – opcja umożliwia zdefiniowanie stałego zestawu pozycji, z którymi lista zostanie zainicjalizowana.
Za pomocą przycisków + oraz - można dodać nowe pozycję do listy. Wartość ID musi być liczbą.
Zapytanie powinno mieć następującą konstrukcję: „Select ‘tekst123’ as ‘DET_Att1’, ‘9’ as DET_Att2”. W przypadku tego zapytania wartość „tekst123” trafi do kolumny DET_Att1, a atrybut o numerze ID „9” trafi do kolumny DET_Att2.
ID oraz pole, które odpowiada danemu atrybutowi w bazie, można sprawdzić w podstawowej konfiguracji atrybutu.
Pole Źródło danych umożliwia wybór źródła danych innego niż domyślne, a poprzez to wykonanie zapytania do innego źródła niż baza zawartości. Zapytanie musi zwracać kolumny o nazwach odpowiadających nazwom pól kolumn Listy pozycji w bazie danych.
W przypadku wybrania domyślnego źródła wykonywane jest zapytanie z parametrami połączenia do bazy zawartości.
Jeżeli odwołanie się do zewnętrznego źródła danych nie jest konieczne, należy używać źródła domyślnego, ponieważ jego zmiana ma wpływ na wydajność wykonywanych zapytań.
Przykład inicjalizacji za pomocą zapytania SQL
Przykładowa lista pozycji (lista produktów):
| Nazwa kolumny | Typ |
|---|---|
| Nazwa | Pojedynczy wiersz tekstu |
| Ilość | Liczba zmiennoprzecinkowa bez miejsc po przecinku |
| Cena | Liczba zmiennoprzecinkowa |
| Opis | Wiele wierszy tekstu |
| Zamówiony przez | Wybór z wyszukiwaniem |
Jako źródło danych wykorzystano tabelę SQL Products:
| Nazwa kolumny |
|---|
| ProductName |
| ProductPrice |
| ProductDescription |
| ProductCount |
| OrderedBy |
Tabela została utworzona w domyślnym źródle danych, tj. bazie zawartości.
Przykładowa konfiguracja inicjalizacji:
Zapytanie automatycznie mapuje kolumny źródła danych, kopiując ich wartości do kolumn Listy pozycji, np. kolumna ProductName tabeli źródłowej odpowiada kolumnie DET_Att1 Listy pozycji. Bazodanowa nazwa kolumny Listy pozycji wyświetlana jest w polu Pole w bazie w oknie konfiguracji kolumny .
Tak skonfigurowana inicjalizacja będzie wykonywana tylko na kroku startowym. Wynik inicjalizacji:
