← Powrót do listy dostępnych akcji
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 | Typ parametru | Wartość domyślna | Rodzaj pola | Uwagi i ograniczenia | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Baza danych | 1.0.4 | Nazwa konfiguracji zdefiniowana w ustawieniach eksploratora danych. | Tekst | Pole edytowalne | ||||||||||
| 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. | Tekst | Pole edytowalne | 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. | Tekst | Pole edytowalne | ||||||||||
| 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. | Tablica wartości tekstowych | Pole edytowalne | 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. | Tablica zmiennych | Pole edytowalne | ||||||||||
| Id tabeli dynamicznej | 1.0.4 | Opcjonalny parametr, warunkujący zapis danych wynikowych do tabeli dynamicznej. | Tekst | Pole edytowalne | ||||||||||
| 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. | Tekst | Lista wartości | Możliwe wartości parametru:
| |||||||||
| Nadpisanie danych | 1.0.21 | Parametr określa, czy nadpisać dane w kolumnach tabeli dynamicznej | Logiczny | Nie | Pole edytowalne |
Parametr*- pole wymagane
Przykładowa konfiguracja
Change log
1.0.4
- Dodanie komponentu
1.0.9
- Naprawienie błędu działania pod IE
- 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!