← Back to the available automatic tasks list
In case of any problems with understanding how the automatic task works, check: Automatic task, Conditional execution, Component parameters
Podstawowe informacje
Category: Database
Dostępne od: 1.0.2 (aplikacja) 1.0.4 (setter)
Opis
Komponent 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.
W przypadku braku danych zwróconych z bazy, komponent nie ustawia żadnej wartości.
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 | |||||||||
| Typ zapytania* | x.x | Parametr warunkujący typ zapytania do bazy. Do wyboru są 2 opcje:
| Tekst | Pobieranie danych | Lista wartości | |||||||||
| 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 | Na bazie Oracle nie ustawimy zmiennej typu logiczna ze względu na brak odpowiadającego mu typu w bazie danych. | |||||||||
| 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 |
Sample configuration
- Typ zapytania ustawiony na wartość Pobieranie danych
- Typ zapytania ustawiony na wartość Aktualizacja danych
Change log
1.0.2
- Dodanie komponentu (aplikacja)
1.0.4
- Dodanie komponentu (setter)
1.0.10
- Ustawienie domyślnej tabeli z zapytaniami na pm_dbqueries
1.0.21
- Dodanie parametru nadpisz
1.0.49
- Poprawka dotycząca ustawiania wartości całkowitej na Oracle
1.0.54
- Poprawienie obsługi błędu w przypadku nie znalezienia kolumny lub tabeli
1.0.7
- Obsługa przekazywania parametrów ze spacją - dodanie interpretacji " " i ' '
1.0.11
- Dodanie parametru z obsługą wielu wartości
1.0.12
- Usunięcie błędu konwertera dla tekstowej tabelarycznej
1.0.14
- Nowa obsługa komentarzy, poprawienie ustawiania dat
1.0.15
- Dodanie logów
1.0.18
- Poprawienie błędu konwersji kolumn całkowitych
1.0.24
- Dodanie obsługi zapytań bez parametrów
1.0.25
- Poprawienie rzucania wyjątków
1.0.63
- Poprawienie rzucania błędu w przypadku nie znalezienia zmiennej przekazanej w parametrze
1.0.64
- Nowa obsługa bazy danych
1.0.65
- Poprawna obsługa parametrów tekstowych z "" i ''
x.x
- Obsługa zapytań typu INSERT, UPDATE