[AKCJA] Wykonanie zapytania pobierającego dane z bazy

Jeśli masz problem ze zrozumieniem jak działa akcja, sprawdź opisy: Akcja, Wykonanie warunkowe, Parametry komponentów

Podstawowe informacje

Kategoria: Baza danych

Umiejscowienie akcji: Formularz, Przycisk formularza, Zmienna

Poprzednie nazwy: Wykonanie zapytania z bazy

Dostępna od wersji: 1.0.4

Opis

Akcja pobiera zapytanie SQL z bazy, wykonuje je i wyniki przypisuje zmiennym, których identyfikatory odpowiadają aliasom kolumn w bazie.

Miejsca w zapytaniu bazodanowym, w które trafić mają wartości ze zdefiniowanych przez nas parametrów oznaczamy znakiem "?". W przypadku zdefiniowania kilku parametrów, o tym, gdzie trafi każda z wartości decyduje kolejność definiowania parametrów.

Należy pamiętać o tym, że zapis danych do tabeli dynamicznej możliwy jest jedynie po przekazaniu identyfikatora tabeli w ostatnim parametrze.

W przypadku braku danych zwróconych z bazy, komponent nie ustawia żadnej wartości.

Wywołanie akcji

Pozostawienie pustego pola wykonania warunkowego jest jednoznaczne z ustawieniem go na "prawdę".

Umiejscowienie akcji	Od wersji	Działanie parametru "Wykonanie warunkowe"	Warunek wywołania akcji
Formularz	1.0.32	Wywołuje akcję	Zmiana wartości "Wykonania warunkowego" na "prawdę"
Zmienna	1.0.4	Uaktywnia akcję	Zmiana wartości zmiennej na której znajduje się akcja
Przycisk	1.0.4	Uaktywnia akcję	Naciśnięcie przycisku na którym znajduje się akcja

Parametry konfiguracyjne

Nazwa parametru	Od wersji	Opis	Uwagi i ograniczenia
Baza danych	1.0.4	Nazwa konfiguracji zdefiniowana w ustawieniach eksploratora danych.
Tabela z zapytaniami	1.0.4	Nazwa tabeli, w której przechowywane są zapytania wywoływane przez aplikację. Tabela powinna zawierać kolumny query_name (identyfikator zapytania) i query (samo zapytanie). W pierwszej kolejności akcja próbuje wyszukać tabelę z bazy systemowej. Jeśli wyszukiwanie się nie powiedzie, następuje wyszukiwanie w bazie zdefiniowanej.	Parametr jest opcjonalny. Jeżeli go nie uzupełnimy, to pytanie zostaje pobrane stąd: Tabela z zapytaniami do bazy
Nazwa zapytania	1.0.4	Identyfikator zapytania przechowywanego w bazie danych.
Parametry dla zapytania	1.0.4	Tablica wartości tekstowych przechowujących zmienne/stałe dla parametrów zapytania i informację o typie. Przykładowy parametr, to "wartość typ" dla stałych i "@id_zmiennej" dla zmiennych. Gdy chcemy przekazać wartość stałą, która ma więcej niż jeden wyraz, zapisujemy ją w cudzysłowie "" lub ''. Wspierane typy to: string, integer i float.	Od wersji 1.0.24 istnieje możliwość nie przekazywania żadnych parametrów do zapytania.
Zmienne docelowe	1.0.4	Tablica zmiennych, do których mają trafić wartości z bazy. Powiązanie na podstawie id zmiennej i zwróconego aliasu z bazy.
Id tabeli dynamicznej	1.0.4	Opcjonalny parametr, warunkujący zapis danych wynikowych do tabeli dynamicznej.
Obsługa wielu wartości	1.0.11	Opcjonalny parametr, pozwalający na obsługę wielu wartości zwróconych przez bazę dedykowanych jednej zmiennej nagłówkowej. Możliwe wartości parametru:	Block - brak obsługi wielu wartości First - do pola trafia pierwsza zwracana wartość Unique - do pola trafią wszystkie unikatowe wartości rozdzielone średnikiem
Nadpisanie danych	1.0.21	Parametr określa, czy nadpisać dane w kolumnach tabeli dynamicznej

Parametr*- pole wymagane

Przykładowa konfiguracja

Change log

1.0.4

Dodanie komponentu

1.0.9

Naprawienie błędu działania pod IE

1.0.9

Dodanie obsługi '' i "" w przekazywanych parametrach

1.0.10

Ustawienie domyślnego pobierania danych z tabeli pm_dbqueries

1.0.11

Dodanie obsługi wielu wartości zapisywanych do zmiennych formularza

1.0.14

Dostosowanie akcji do bazy Oracle

1.0.16

Obsługa polskich znaków

1.0.18

Poprawienie błędu konwersji liczb całkowitych

1.0.21

Dodanie parametru pozwalającego na nadpisaie danych w tabeli dynamicznej

1.0.24

Dodanie możliwości wywołania zapytania bez parametrów

1.0.43

Zablokowanie możliwości dodania akcji pod przycisk akceptacji

Zmiana nazwy z "Wykonanie zapytania z bazy" na "Wykonanie zapytania pobierającego dane z bazy"

1.0.49

Dodanie dynamicznego formularza z comboboxem dla parametru obsługa wielu wartości

Naprawienie błędu ustawiania wartości całkowitej na Oracle

1.0.53

Odświeżanie tabeli po pobraniu do niej danych

1.0.54

Poprawiona obsługa sytuacji, w której nie znaleziono tabeli lub kolumny w bazie danych

1.0.63

Poprawiona obsługa sytuacji, w której nie znaleziono zmiennej przekazanej w parametrze zapytania

The license could not be verified: License Certificate has expired!