Versions Compared

Old Version 22

changes.mady.by.user Adrian Kozica

Saved on

compared with

New Version Current

changes.mady.by.user Joanna Jankowiak

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Added

 

Polish

  ← Powrót do listy dostępnych akcji

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

Opis akcji

W przypadku umieszczenia na formularzu akcja zadziała tylko w momencie, gdy warunek wykonania warunkowego zostanie spełniony. (Od wersji

Panel
titlePodstawowe informacje

Kategoria: Baza danych

Umiejscowienie akcji: Formularz, Przycisk formularza, Zmienna

Poprzednie nazwy: Wykonanie zapytania z bazy

Dostępna od wersji: 1.0.4

Panel
titleOpis

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.

Panel
titleWywołanie akcji

Akcja wykonuje się po spełnieniu wykonania warunkowego, naciśnięciu przycisku lub po zmianie zmiennej na której została umieszczona.

Wykonanie warunkowe

Info

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

Umiejscowienie akcjiOd wersjiDziałanie parametru "Wykonanie warunkowe"Warunek wywołania akcji
Formularz1.0.32
)

W przypadku umieszczenia na przycisku akcja zadziała tylko w momencie, gdy podczas kliknięcia warunek wykonania warunkowego będzie spełniony.

W przypadku umieszczenia na zmiennej akcja zadziała tylko w momencie, gdy podczas zmiany wartości warunek wykonania warunkowego będzie spełniony.

Umiejscowienie akcji

Formularz (wykonanie po spełnieniu wykonania warunkowego) (Od wersji 1.0.32)

Przycisk (wykonanie po naciśnięciu przycisku)

Zmienna formularza (wykonania po zmianie wartości tej zmiennej)

Przykładowa konfiguracja akcji

Image Removed

Parametry konfiguracyjne

Konfiguracja połączenia z bazą danych ( typ : wartość tekstowa ) -

Wywołuje akcję

Zmiana wartości "Wykonania warunkowego" na "prawdę"

Zmienna1.0.4Uaktywnia akcję

Zmiana wartości zmiennej na której znajduje się akcja

Przycisk1.0.4Uaktywnia akcję

Naciśnięcie przycisku na którym znajduje się akcja

Panel
titleParametry konfiguracyjne
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Baza danych1.0.4Nazwa konfiguracji zdefiniowana w ustawieniach eksploratora danych.Tekst Pole edytowalne 
Tabela z zapytaniami
( typ : wartość tekstowa ) -
1.0.4Nazwa tabeli, w której przechowywane są zapytania wywoływane przez aplikację. 
Tabela powinna zawierać kolumny query_name (identyfikator zapytania) i query (samo zapytanie).
W
 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 edytowalneParametr jest opcjonalny. Jeżeli go nie uzupełnimy, to pytanie zostaje pobrane stąd: Tabela z zapytaniami do bazy
Nazwa zapytania
( typ : wartość tekstowa ) -
*1.0.4Identyfikator zapytania przechowywanego w bazie danych.Tekst Pole edytowalne 
Parametry dla zapytania
( typ: tablica wartości tekstowych ) -
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.

Zmienne docelowe ( typ : tablica zmiennych ) -
Tablica wartości tekstowych Pole edytowalneOd wersji 1.0.24 istnieje możliwość nie przekazywania żadnych parametrów do zapytania.
Zmienne docelowe*1.0.4Tablica 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
( typ : wartość tekstowa ) -
1.0.4Opcjonalny parametr, warunkujący zapis danych wynikowych do tabeli dynamicznej.Tekst Pole edytowalne 
Obsługa wielu wartości
( typ : wartość tekstowa ) -
1.0.11Opcjonalny 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:

Block - brak obsługi wielu wartości
First - do pola trafia pierwsza zwracana wartość
Unique - do pola trafią wszystkie unikatowe wartości rozdzielone średnikiem

Od wersji 1.0.21:

Nadpisanie danych ( typ : wartość logiczna, domyślnie: PRAWDA ) - Parametr określa, czy nadpisać dane w kolumnach tabeli dynamicznej

 

Film instruktażowy

 

Mapa z przykładową konfiguracją

Wartość wyświetlanaWartość przekazywana
Rzuć wyjątekBLOCK

Pobierz pierwszą wartość

FIRST
Pobierz unikalne wartości rozdzielone średnikiemUNIQUE
Sposób dodawania danych*1.0.83

Parametr umożliwiający określenie sposobu dodawania danych do tabeli dynamicznej. Do wyboru są 3 typy:

  • Nadpisz całą tabelę- nadpisane zostają wszystkie wartości w tabeli,
  • Nadpisz aktualizowane kolumny- nadpisane zostają wszystkie wartości w kolumnie określonej w zapytaniu,
  • Dopisz wartości- pobrane wartości zostają dopisane do istniejących.
TekstDopisz wartościLista wyboru 

Parametr*- pole wymagane

Panel
titlePrzykładowa konfiguracja

Image Added

 

Przykładowa konfiguracja, gdzie jako parametr przekazywana jest zmienna z tabeli dynamicznej
(do zapytania parametr trafia jako zmienna tekstowa, w której wartości rozdzielone są średnikami).

Image Added

Panel
titleChange 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 (obowiązująca dokumentacja)

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

1.0.83 (obowiązująca dokumentacja)

  • Zmiana parametru "Nadpisanie danych" na "Sposób dodawania danych"

1.0.128

  • Poprawiono odczytywanie wartości parametrów ze zmiennych formularza
  • Poprawiono mapowanie zmiennych typu Boolean
  • Poprawiono błąd związany z mapowaniem wartości w przypadku wybrania opcji "Pobierz pierwszą wartość" w obsłudze wielu wartości
Panel
titlePakiet z przykładowym formularzem wykorzystującym akcję

View file
nameTesty komponentów - akcje - [AKCJA] Wykonanie zapytania z bazy 2019-10-14 10_22_51.zip

pageAkcje cuf-components

height250

 
Hide If
special@anonymous

Powiązane zadania

Aktualne

Archiwalne

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-66

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-101

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-102

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-86

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-106

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-199

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-118

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-158

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-160

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-181

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-256

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-433

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-459

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-476

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-501

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-495

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-557

JIRA
server192.168.1.52 JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-662

English

  ← Return to the list of available actions

Info

If you have a problem understanding how the action works, check: Action, Conditional execution, Components parameters

Panel
titleBasic information

Category: Database

Action location: Form, Button, Variable

Previous names: Perform a query from the database

Available from version: 1.0.4

Panel
titleDescription

The action retrieves the SQL query from the database, executes it and assigns the results to variables whose identifiers correspond to the column aliases in the database.

Places in the database query, where the values from parameters defined by us are to be marked, are marked with "?" If several parameters are defined, the order in which the parameters are defined determines where each value will go.

It should be remembered that writing data to the dynamic table is possible only after passing the table identifier in the last parameter.

In the absence of data returned from the database, the component sets no value.

Panel
titleAction call-up
Info

Leaving an empty conditional field is equal to setting it to "true".

Action location

From version

Conditional execution parameter action

Action call-up condition

Form

1.0.32

Call-up action

The "Conditional execution" parameter will return "true"

Variable1.0.4Activates actionChange the value of the variable on which the action is located

Button

1.0.4

Activates action

Pressing the button

Panel
titleConfiguration parameters

Parameter name

From version

Description

Paremeter type

Default value

Field type

Comments and restrictions

Database

1.0.4

The configuration name defined in the data explorer settings.

Text

 

Editable field

 

Table with queries1.0.4

The name of the table in which queries triggered by the application are stored.
The table should contain the columns query_name (query ID) and query (query only). 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 fieldThe parameter is optional. If we do not complete it, the question is taken from here: Table with database queries
Query Name*1.0.4ID of the query stored in the database.Text Editable field 
Parameters for the query1.0.4An 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.An array of text values Editable fieldSince version 1.0.24 it is possible not to pass any parameters to the query.
Target Variables*1.0.4Array of variables into which the values from the database are to reach. Binding based on the variable id and returned alias from the database.Array of variables Editable field 
Dynamic table id1.0.4An optional parameter conditioning the saving of result data to a dynamic table.Text Editable field 
Multiple value support1.0.11An optional parameter that allows handling of many values returned by the database dedicated to one header variable.Text Drop-down list

Possible parameter values:

Displayed ValueValue transmitted
Throw an exceptionBLOCK
Get the first valueFIRST
Get unique values separated by a semicolonUNIQUE
Way of adding data*1.0.83

Parameter that allows you to specify the way of adding data. There are 3 types to choose from:

  • Overwrite entire table- all values in the table are overwritten,
  • Overwrite updated columns- all values in the column specified in the query are overwritten,
  • Add values- values taken from DB are added to the existing ones.
TextAdd valuesDrop-down list 

Parameter*- mandatory field 

Panel
titleConfiguration example

Image Added

Panel
titleChange log

1.0.4

  • Adding a component

1.0.9

  • IE error fixing
  • Adding support for '' and '' in the passed parameters

1.0.10

  • Setting the default data retrieval from the pm_dbqueries table

1.0.11

  • Added support for multiple values saved to form variables

1.0.14

  • Adaptation of actions to the Oracle database

1.0.16

  • Polish characters support

1.0.18

  • Correction of the integer conversion error

1.0.21

  • Adding a parameter that allows overwriting data in a dynamic table

1.0.24

  • Adding the option to run a query without parameters

1.0.43

  • Blocking the option of adding an action under the accept button
  • Changing the name from "Executing a query from the database" to "Performing a query retrieving data from the database"

1.0.49

  • Adding a dynamic form with a combobox for the multi-value parameter
  • Fixing the error of setting the total value on Oracle

1.0.53

  • Refreshing the table after downloading data to it

1.0.54

  • Improved handling of the situation when a table or column was not found in the database

1.0.63

  • Improved handling of the situation in which the variable passed in the query parameter was not found

1.0.83

  • Changing "Data Overwrite" parameter to "Way of adding data"

1.0.X

  • Improved retrieving parameter values from form variables

  • Improved mapping of Boolean type variables

  • Fixed error related to mapping of values when "Get the first value" option is selected in Multiple value support