Versions Compared

Old Version 25

changes.mady.by.user Piotr Szarkiewicz

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 zadań automatycznych

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

 

Panel
titlePodstawowe informacje

Kategoria: Baza danych

Dostępne od: 1.0.2 (aplikacja) 1.0.4 (setter)

Panel
titleOpis

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
titleParametry konfiguracyjne
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Baza danych*1.0.4Nazwa konfiguracji zdefiniowana w ustawieniach eksploratora danych.Tekst Pole edytowalne 
Tabela z zapytaniami1.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 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
 Typ zapytania*x.xParametr 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.
TekstPobieranie danychLista wartości 
Nazwa zapytania*1.0.4Identyfikator zapytania przechowywanego w bazie danych.Tekst Pole edytowalne 
Parametry dla zapytania1.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 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 edytowalneNa bazie Oracle nie ustawimy zmiennej typu logiczna ze względu na brak odpowiadającego mu typu w bazie danych.
Id tabeli dynamicznej1.0.4Opcjonalny parametr, warunkujący zapis danych wynikowych do tabeli dynamicznej.Tekst Pole edytowalne 
Obsługa wielu wartości1.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:

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

Pobierz pierwszą wartość

First
Pobierz unikalne wartości rozdzielone średnikiemUnique
Nadpisanie danych* 1.0.21Parametr określa, czy nadpisać dane w kolumnach tabeli dynamicznejLogicznyNiePole edytowalne 
Wstrzymaj akceptację w przypadku błędu1.0.110Parametr określa, czy ma przerwać akceptacje w przypadku pojawienia się błędu (wyrzucić wyjątek dalej).LogicznyNiePole edytowalneTylko dla komponentu typu SETTER ("Mechanizmy uruchamiane po akceptacji")

 

 

Panel
titlePrzykładowa konfiguracja
  • Typ zapytania ustawiony na wartość Pobieranie danych

 

 

  • Typ zapytania ustawiony na wartość Aktualizacja danych

 

 

Panel
titleChange 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

1.0.110

  • Błędna obsługa błędu w Setterze "Wykonanie zapytania z bazy"

 

 

Panel
titlePakiet z przykładowym formularzem wykorzystującym aplikację

View file
nameTesty komponentów - aplikacje - [APLIKACJA] Wykonanie zapytania z bazy 2019-10-17 13_28_42.zip
height250
 

 

 

Hide If
special@anonymous

Powiązane zadania

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-86

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-476

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-19

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

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-116

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

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

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-185

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

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

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

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

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

English

← 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

 

Panel
titleBasic info

Category:

UserPrevious name: User data (till version 1

Database

Available from version: 1.0.

33)Available from version:

2 (application) 1.0.

0

Description

Application, which upon given login search for user data and writes data to header or tabular variable.
In case of header variable subsequent values are separated by semicolons, e.g. "anowak;jpawlak;knowacki". If there is no value, it writes an empty string to the variable "".
In case of tabular variable subsequent values are written in subsequent cells of the column.

The data that can be obtained is:

  • First Name
  • Last Name
  • E-mail
  • Full Name
  • Number
  • User’s group names
  • User’s position names
  • User’s position symbols
  • Symbols of the user's organizational units
  • The names of the user's organizational units
  • User’s manager’s logins

4 (setter)

Panel
titleDescription
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
titleConfiguration parameters
Parameter NameFrom versionDescriptionParameter typeDefault valueField typeComments and restricitons
User login
Database*1.0.
0Login of the user whose data will be saved to variablesData type*
4Configuration name defined in the data explorer settings.Text Editable field

If the application does not find a user with the given login, it will show an error.

 
Query table
1.0.
0

Types of user data that will be saved to variables.

Table of text values.

 

Non-editable dropdown list

Previous name: Selected data. Note - in older versions it was necessary to enter the type of data manually. Available values from that period can be seen in the table below.

Currently available values to choose from:

  • First Name
  • Last Name
  • E-mail
  • Full Name
  • Number
  • User’s group names
  • User’s job names
  • User’s position symbols
  • Symbols of the user's organizational units
  • The names of the user's organizational units
  • User’s manager’s logins

Variables for data storage*

1.0.0

Variables in which user data will be saved

Variable

 

 

Editable field

Variables should be of text type - header or tabular. In case of headers, subsequent values will be passed after the semicolon, e.g. "position1; position2; position3". In case of tabular variables, subsequent values will be saved in separate rows of the column.

Parameter*- mandatory field

Types of downloaded data

The automatic task allows you to download the user data you are interested in. Part of the data was provided gradually as part of the needs. There was also no drop-down list, which is why the data type had to be passed by entering the value into the field. The table below presents the time of delivery of particular types of data and commands used to download data without using the drop-down list.

 

Data type 

From version

Value of the parameter to enter (without using the drop down list)

First Name 1.0.0

FIRSTNAME

Last Name 1.0.0LASTNAME
E-mail 1.0.0EMAIL
Full Name 1.0.0FULLNAME
Number1.0.0NUMBER
User’s group names 1.0.0GROUPSNAMES

User’s position names 

1.0.0POSITIONSNAMES

User’s position symbols 

1.0.0POSITIONSSYMBOLS

Symbols of the user's organizational units

1.0.17POSITIONSOUSYMBOLS or OUSYMBOLS (both versions are correct) 

The names of the user's organizational units 

1.0.17OUNAMES

User’s manager’s logins 

1.0.27SUPERIORSNAMES

Configuration example

Image Removed

Application example

Expand
titleExample 1
Panel
titleExample

Assume we have a user who validates invoices and issues them to clients. However, before issuing one of the superiors of that user must approve the invoice.

The problem is that the document must contain the name and surname of the user issuing the invoice, and we only have access to his/her login. In addition, we do not have information about who is the superior of this user.

To solve this problem, we can use an automatic task that will save the data for the given user’s login in the selected variables.

Therefore, you need to configure the automatic task "Download user data" as follows:

Image Removed

Where:

Checking person’s login - is a text variable that stores a user login who checks and issues invoices.

Invoice issuer - is a text variable in which we want to save the name and surname of the user in order to later transfer it to the document

Accepting person - is a text variable in which we will write down all the supervisors of this user after the semicolon - we must remember to properly handle both: one and multiple returned values!

The automated task configured in this way is placed at the right time on the process map. Its result should allow further implementation of the set goals.

 

 

Hide If
special@anonymous

Change log

1.0.0

  • Component adding

1.0.17

  • Addition of data types support: "Symbols of user's organizational units" and "Names of user's organizational units"

1.0.27

  • Adding data type support: "User manager's logins"

1.0.33

  • Changing the name from "Generating a document" to "Generating a document from a template"

1.0.??

  • Adding a dynamic form - a drop-down list for the type of data. Changing the parameters name

Tasks related to the component

Current

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

Archive

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

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

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

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 fieldThe 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.
TextSelect dataList of values 
Query name*1.0.4
ID of the query stored in the database.
Text Editable field 
Query parameters1.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 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.Variable array Editable fieldOn 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.11An 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świetlanaWartość przekazywana
Throw exceptionBlock

Get first value

First
Get unique values separated by semicolonUnique
Overwrite data 1.0.21The parameter determines whether to overwrite data in the columns of the dynamic table.LogicalNoEditable field 
Suspend acceptance on error1.0.110The parameter defines whether to interrupt the acceptance in case of an error (throw the exception next).LogicalNoEditable fieldOnly for a SETTER type component ("Mechanisms activated after acceptance")

 

 

Panel
titleSample configuration
  • Type of query set to Select data

 Image Added

 

  • Type of query set toUpdate data

 

Image Added

 

Panel
titleChange log

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

  • Logs adding

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

  • New database support

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