← 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
Kategoria: Użytkownik
Poprzednie nazwy: Pobieranie danych użytkownika (do wersji ???)
Umiejscowienie akcji: Zmienna, Przycisk, Formularz
Dostępna od wersji: 1.0.27
Opis akcji
Akcja, która na podstawie podanego loginu wyszukuje dane użytkownika i zapisuje je do zmiennej nagłówkowej lub tabelarycznej.
W przypadku zmiennej nagłówkowej kolejne wartości są rozdzielane średnikami, np. "anowak;jpawlak;knowacki". W przypadku braku wartości zapisuje do zmiennej pusty ciąg znaków "".
W przypadku zmiennej tabelarycznej kolejne wartości są zapisywane w kolejnych komórkach kolumny.
Dane możliwe do uzyskania to:
- Imię
- Nazwisko
- Imię i nazwisko
- Numer
- Nazwy grup użytkownika
- Nazwy stanowisk użytkownika
- Symbole stanowisk użytkownika
- Symbole jednostek organizacyjnych użytkownika
- Nazwy jednostek organizacyjnych użytkownika
- Loginy przełożonych użytkownika
Wywołanie akcji
Pozostawienie pustego pola wykonania warunkowego jest jednoznaczne z ustawieniem go na "prawdę".
| Umiejscowienie akcji | Działanie parametru "Wykonanie warunkowe" | Warunek wywołania akcji |
|---|---|---|
| Przycisk formularza | Uaktywnia/dezaktywuje wywołanie akcji po naciśnięciu przycisku | Wciśnięcie przycisku |
| Zmienna formularza | Uaktywnia/dezaktywuje wywołanie akcji po zmianie wartości zmiennej Wywołuje akcję | Zmiana wartości zmiennej Parametr "Wykonanie warunkowe" zwróci "prawdę" |
| Formularz | Wywołuje akcję | Parametr "Wykonanie warunkowe" zwróci "prawdę" |
Parametry konfiguracyjne
| Nazwa parametru | Od wersji | Opis | Typ parametru | Wartość domyślna | Rodzaj pola | Uwagi i ograniczenia |
|---|---|---|---|---|---|---|
| Login użytkownika* | 1.0.27 | Login użytkownika, którego dane zostaną zapisane do zmiennych. | Tekst | Pole edytowalne | Jeżeli aplikacja nie znajdzie użytkownika o podanych loginie, to wyrzuci błąd. | |
| Rodzaj danych* | 1.0.27 | Rodzaje danych użytkownika, które zostaną zapisane do zmiennych. | Tablica wartości tekstowych | Nieedytowalna lista rozwijalna | Poprzednia nazwa: Wybrane dane. Uwaga - w starszych wersjach istniała konieczność ręcznego wpisywania rodzaju danych. Dostępne wartości z tamtego okresu można zobaczyć w tabeli dostępnej poniżej. Obecne wartości do wyboru:
| |
| Zmienne do zapisu danych* | 1.0.27 | Zmienne w których zostaną zapisane dane użytkownika | Zmienna | Pole edytowalne | Zmienne powinny być typu tekstowego - nagłówkowe bądź tabelaryczne. W przypadku nagłówkowych kolejne wartości zostaną przekazane po średniku, np. "stanowisko1;stanowisko2;stanowisko3". W przypadku zmiennych tabelarycznych kolejne wartości zostaną zapisane w osobnych wierszach kolumny. |
Parametr*- pole wymagane
Rodzaje pobieranych danych
Zadanie automatyczne pozwala na pobranie interesujących nas danych użytkownika. Część danych była dostarczana stopniowo, w ramach zapotrzebowań. Nie istniała także rozwijana lista, dlatego rodzaj danych trzeba było przekazywać wpisując wartość w pole. Poniższa tabela przedstawia czas dostarczenia poszczególnych rodzajów danych oraz komendy służące do pobrania danych bez użycia rozwijanej listy.
| Rodzaj danych | Od wersji | Wartość parametru do wpisania (bez użycia rozwijanej listy) |
|---|---|---|
| Imię | 1.0.31 | FIRSTNAME |
| Nazwisko | 1.0.31 | LASTNAME |
| 1.0.31 | ||
| Imię i nazwisko | 1.0.31 | FULLNAME |
| Numer | 1.0.31 | NUMBER |
| Nazwy grup użytkownika | 1.0.31 | GROUPSNAMES |
Nazwy stanowisk użytkownika | 1.0.31 | POSITIONSNAMES |
Symbole stanowisk użytkownika | 1.0.31 | POSITIONSSYMBOLS |
Symbole jednostek organizacyjnych użytkownika | 1.0.31 | POSITIONSOUSYMBOLS lub OUSYMBOLS (obie wersje poprawne) |
Nazwy jednostek organizacyjnych użytkownika | 1.0.31 | OUNAMES |
Loginy przełożonych użytkownika | 1.0.27 | SUPERIORSNAMES |
Przykładowa konfiguracja akcji
Przykład zastosowania
Przykład
Załóżmy, że mamy użytkownika, który sprawdza poprawność faktur i wystawia je klientom. Zanim jednak dojdzie do wystawienia, jeden z przełożonych tego użytkownika musi zatwierdzić fakturę.
Sęk w tym, że w dokumencie musi znaleźć się imię i nazwisko użytkownika wystawiającego fakturę, a my posiadamy dostęp jedynie do jego loginu. Dodatkowo nie mamy zapisanej informacji o tym, kto jest przełożonym tego użytkownika.
Do rozwiązania tego problemu możemy użyć akcji, która dla podanego loginu użytkownika zapisze dane dotyczące go w wybranych zmiennych.
Konfigurujemy więc akcję "Pobranie danych użytkownika" w następujący sposób:
Gdzie:
Login sprawdzającego - to zmienna tekstowa przechowująca login użytkownika, który sprawdza i wystawia faktury.
Osoba wystawiająca fakturę - to zmienna tekstowa, w której chcemy zapisać imię i nazwisko tego użytkownika, w celu późniejszego przekazania jej do dokumentu
Osoba akceptująca - to zmienna tekstowa, w której zapiszemy po średniku wszystkich przełożonych tego użytkownika - musimy pamiętać, żeby odpowiednio obsłużyć zarówno jedną, jak i wiele zwróconych wartości!
Tak skonfigurowaną akcję umieszczamy w odpowiednim formularzu na mapie procesu. Wynik powinien się pojawić po wczytaniu formularza przez użytkownika.
The license could not be verified: License Certificate has expired!
Mapa z przykładową konfiguracją
← Return to the available actions list
If you have a problem with understanding how the action works, check the descriptions: Action, Conditional execution, Component parameters
Category: User
Previous names: Downloading user data (up to version ???)
Action location: Variable, Button, Form
Available from version: 1.0.27
Action description
An action that searches for user data based on the given login and writes it to the header or table variable.
In case of a header variable, subsequent values are separated by semicolons, e.g. "anowak;jpawlak;knowacki". If there is no value, it is saved an empty string to the variable "".
In case of a table variable, subsequent values are saved in subsequent cells of the column.
Data possible to obtain:
- First name
- Last name
- Full name
- Number
- User group names
- User's position names
- User’s position symbols
- User's organizational units symbols
- User's organizational units names
- User's superior's logins
Action call
Leaving an empty conditional execution field is identical with setting it to "the truth".
| Action location | Parameter operation "Conditional execution" | Action call condition |
|---|---|---|
| Form button | Activates/deactivates the action call after pressing button | Pressing button |
| Form variable | Activates / deactivates the action call after changing the variable value Call action | Variable value change Parameter "Conditional execution" will return "truth" |
| Form | Call action | Parameter "Conditional execution" will return "truth" |
Configuration parameters
| Parameter name | From version | Description | Parameter type | Default value | Field type | Comments and restrictions |
|---|---|---|---|---|---|---|
| User login* | 1.0.27 | User login whose data will be saved to variables. | Text | Editable field | If the application does not find a user with the given login, it will throw an error. | |
| Data type* | 1.0.27 | User data types that will be saved to variables. | Text values table | 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. Current optional data:
| |
| Variables for data storage* | 1.0.27 | Variables in which user data will be saved | Variable | Editable field | Variables should be of text type - header or tabular. In the case of headers, subsequent values will be passed after the semicolon, e.g. "position1;position2;position3". In the case of table variables, subsequent values will be saved in separate rows of the column. |
Parameter*- required field
Downloaded data types
The automatic task allows to download the user data you are interested in. Data part was provided gradually as part of the needs. There was also no drop-down list, so the data type had to be passed by entering the value into the field. The table below presents the delivery time of particular data types and commands used to download data without using the drop-down list.
| Data type | From version | Parameter value to enter (without using the drop down list) |
|---|---|---|
| First name | 1.0.31 | FIRSTNAME |
| Last name | 1.0.31 | LASTNAME |
| 1.0.31 | ||
| Full name (first and last name) | 1.0.31 | FULLNAME |
| Number | 1.0.31 | NUMBER |
User group names | 1.0.31 | GROUPSNAMES |
User's position names | 1.0.31 | POSITIONSNAMES |
User’s position symbols | 1.0.31 | POSITIONSSYMBOLS |
User's organizational units symbols | 1.0.31 | POSITIONSOUSYMBOLS lub OUSYMBOLS (obie wersje poprawne) |
User's organizational units names | 1.0.31 | OUNAMES |
User's superior's logins | 1.0.27 | SUPERIORSNAMES |
Sample action configuration
Using example
Example
Suppose there is a user who validates invoices and issues them to clients. However, before it, one of that user superiors must approve the invoice.
The problem is that the document must contain the full name issuing the invoice user, but you have only access to the login. In addition, you do not have saved information about who is the user's superior.
To solve this problem, you can use an action that will save the data for it in the selected variables for the given user's login.
You should configure the "Download user data" action as follows:
Where:
Checker login - is a text variable that stores a user login that checks and issues invoices.
The person issuing the invoice - is a text variable in which you want to save the user's full name in order to later transfer to the document.
Accepting person - is a text variable in which you will write down all user's supervisors after the semicolon - note that properly handle both one and many returned values!
In this way configured action is placed in the appropriate form on the process map. The result should appear after loaded the form by user.
The license could not be verified: License Certificate has expired!