← Powrót do listy dostępnych setterów
Image Added
...
...
Panel |
---|
title | Podstawowe informacje |
---|
| Kategoria: Baza danychDostępne od: 1.0.2 (aplikacja) 1.0.4 (setter) |
Panel |
---|
| 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. |
Panel |
---|
title | 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:- Pobranie danych- parametr dotyczący zapytań zwracających dane, np. SELECT,
- Aktualizacja danych- parametr dotyczący zapytań aktualizujących dane, np. INSERT, UPDATE, DROP.
| 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: Wartość wyświetlana | Wartość przekazywana |
---|
Rzuć wyjątek | Block | Pobierz pierwszą wartość | First | Pobierz unikalne wartości rozdzielone średnikiem | Unique |
| Nadpisanie danych |
|
|
...
| 1.0.21 | Parametr określa, czy nadpisać dane w kolumnach tabeli dynamicznej | Logiczny | Nie | Pole edytowalne | | Wstrzymaj akceptację w przypadku błędu | 1.0.110 | Parametr określa, czy ma przerwać akceptacje w przypadku pojawienia się błędu (wyrzucić wyjątek dalej). | Logiczny | Nie | Pole edytowalne | Tylko dla komponentu typu SETTER ("Mechanizmy uruchamiane po akceptacji") |
|
Panel |
---|
title | Przykładowa konfiguracja |
---|
| - Typ zapytania ustawiony na wartość Pobieranie danych
Image Modified - Typ zapytania ustawiony na wartość Aktualizacja danych
Image Modified
|
|
Panel |
---|
| 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 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 1.0.65 - Poprawna obsługa parametrów tekstowych z "" i ''
x.x - Obsługa zapytań typu INSERT, UPDATE
1.0.110 - Błędna obsługa błędu w Setterze "Wykonanie zapytania z bazy"
|
Panel |
---|
title | Pakiet z przykładowym formularzem wykorzystującym aplikację |
---|
| View file |
---|
name | Testy komponentów - aplikacje - [APLIKACJA] Wykonanie zapytania z bazy 2019-10-17 13_28_42.zip |
---|
height | 250 |
---|
| |
Hide If |
---|
| Powiązane zadania JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-66 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-86 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-199 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-476 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-495 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-19 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-90 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-106 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-116 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-137 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-142 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-160 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-181 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-185 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-557 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-556 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-573 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-561 |
---|
|
JIRA |
---|
server | 192.168.1.52 JIRA |
---|
columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
---|
serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
---|
key | CUFCMP-667 |
---|
|
|
|
English |
---|
← Back to the available automatic tasks list Panel |
---|
| Category: DatabaseAvailable from version: 1.0.2 (application) 1.0.4 (setter) |
Panel |
---|
| Component retrieves SQL query from database, passes it and assigns the results to variables that identify the appropriate column aliases in the database. Places in the database query, where values with range through parameters marked with "?" Are available. When specifying several parameters, where each of the values that decide the order of parameter definition will go. If no data were returned from the database, the component does not set any values.
|
Panel |
---|
title | Configuration parameters |
---|
| Parameter Name | From version | Description | Parameter type | Default value | Field type | Comments and restricitons |
---|
Database* | 1.0.4 | Configuration name defined in the data explorer settings. | Text | | Editable field | | Query table
| 1.0.4 | The name of the table in which queries triggered by the application are stored. The table should contain the query_name (query ID) and query (query only) columns. First, the action tries to search for a table from the system base. If the search fails, a search is made in the defined database. | Text | | Editable field | The parameter is optional. If we do not fill it, the question is taken from here: Tabela z zapytaniami do bazy | Type of query* | x.x | Parameter conditioning the type of database query. There are 2 options to choose from: - Select data- parameter for queries returning data, for example SELECT,
- Update data- parameter for data updating queries, for example INSERT, UPDATE, DROP.
| Text | Select data | List of values | | Query name* | 1.0.4 | ID of the query stored in the database. | Text | | Editable field | | Query parameters | 1.0.4 | An array of text values storing variables / constants for query parameters and type information. An example parameter is "value type" for constants and "@id_variable" for variables. When we want to pass a constant value that has more than one word, we write it in quotation marks "" or "'. Supported types are: string, integer and float. | Text array | | Editable field | Since version 1.0.24 it is possible not to pass any parameters to the query. | Target variables | 1.0.4 | Array of variables into which the values from the database are to reach. Binding based on the variable id and returned alias from the database. | Variable array | | Editable field | On the Oracle database, we will not set a logical type variable due to the lack of a corresponding type in the database. | Multiple values handling
| 1.0.11 | An optional parameter that allows handling of many values returned by the database dedicated to one header variable. | Text | | List of values | Possible values of parameter: Wartość wyświetlana | Wartość przekazywana |
---|
Throw exception | Block | Get first value | First | Get unique values separated by semicolon | Unique |
| Overwrite data | 1.0.21 | The parameter determines whether to overwrite data in the columns of the dynamic table. | Logical | No | Editable field | | Suspend acceptance on error | 1.0.110 | The parameter defines whether to interrupt the acceptance in case of an error (throw the exception next). | Logical | No | Editable field | Only for a SETTER type component ("Mechanisms activated after acceptance") |
|
Panel |
---|
title | Sample configuration |
---|
| - Type of query set to Select data
Image Added - Type of query set toUpdate data
Image Added
|
Panel |
---|
| 1.0.2 Adding component (application)
1.0.4 Adding component (setter)
1.0.10 - Setting the default query table to pm_dbqueries
1.0.21 - Adding overwrite parameter
1.0.49 - Fix for setting the integer value to Oracle
1.0.54 - Improved error handling when a column or table was not found
1.0.7 Support for passing parameters with space - adding "" and '' interpretations
1.0.11 Adding a Multiple values handling parameter
1.0.12 - Fixed converter error for tabular text
1.0.14 New comment support, improved date setting
1.0.15 1.0.18 - Fixing the total column conversion error
1.0.24 - Added query support without parameters
1.0.25 - Improved throwing exceptions
1.0.63 Improved error throwing if the variable passed in the parameter is not found
1.0.64 1.0.65 - Correct handling of text parameters with "" and ''
x.x - Support for INSERT and UPDATE queries
1.0.110 - Incorrect error handling in the "Execution of a query from the database" Setteer
|
|