Przejdź do głównej zawartości
Wersja: 2023 R3

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).

Init_screen.png

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.
Inicjalizacja statyczna

Za pomocą przycisków + oraz - można dodać nowe pozycję do listy. Wartość ID musi być liczbą.

./img/Init_custom.png

Zapytanie SQL w inicjalizacji Użyj źródła danych lub połączenia

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.

./img/Init_custom_2.png

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.

informacja

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):

./img/custom.png

Nazwa kolumnyTyp
NazwaPojedynczy wiersz tekstu
IlośćLiczba zmiennoprzecinkowa bez miejsc po przecinku
CenaLiczba zmiennoprzecinkowa
OpisWiele wierszy tekstu
Zamówiony przezWybó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:

./img/custom_2.png

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:

./img/custom_3.png