← 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
  • Email
  • 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 akcjiDziałanie parametru "Wykonanie warunkowe"Warunek wywołania akcji
Przycisk formularzaUaktywnia/dezaktywuje wywołanie akcji po naciśnięciu przyciskuWciś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ę"

FormularzWywołuje akcjęParametr "Wykonanie warunkowe" zwróci "prawdę"

Parametry konfiguracyjne

Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Login użytkownika*1.0.27Login użytkownika, którego dane zostaną zapisane do zmiennych.Tekst Pole edytowalneJeżeli aplikacja nie znajdzie użytkownika o podanych loginie, to wyrzuci błąd.
Rodzaj danych*1.0.27Rodzaje 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:

  • Imię
  • Nazwisko
  • Email
  • 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
Zmienne do zapisu danych*1.0.27Zmienne w których zostaną zapisane dane użytkownikaZmienna 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 danychOd wersjiWartość parametru do wpisania (bez użycia rozwijanej listy)
Imię1.0.31

FIRSTNAME

Nazwisko1.0.31LASTNAME
Email1.0.31EMAIL
Imię i nazwisko1.0.31FULLNAME
Numer1.0.31NUMBER
Nazwy grup użytkownika1.0.31GROUPSNAMES

Nazwy stanowisk użytkownika

1.0.31POSITIONSNAMES

Symbole stanowisk użytkownika

1.0.31POSITIONSSYMBOLS

Symbole jednostek organizacyjnych użytkownika

1.0.31POSITIONSOUSYMBOLS lub OUSYMBOLS (obie wersje poprawne)

Nazwy jednostek organizacyjnych użytkownika

1.0.31OUNAMES

Loginy przełożonych użytkownika

1.0.27SUPERIORSNAMES

Przykładowa konfiguracja akcji

Przykład zastosowania

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.

Change log

1.0.27

  • Dodanie komponentu pobierającego informacje o przełożonych użytkownika

1.0.31

  • Dodanie obsługi rodzajów danych:
    • Imię
    • Nazwisko
    • Email
    • 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

1.0.??

  • Zmiana nazwy z "Pobieranie danych użytkownika" na "Pobranie danych użytkownika"

Zadania związane z komponentem

Aktualne

Archiwalne

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
  • Email
  • 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 buttonActivates/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" 

FormCall action Parameter "Conditional execution" will return "truth" 

Configuration parameters

Parameter nameFrom versionDescriptionParameter typeDefault valueField typeComments and restrictions
User login*1.0.27User login whose data will be saved to variables.Text Editable fieldIf the application does not find a user with the given login, it will throw an error.
Data type*1.0.27User 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:

  • First name
  • Last name
  • Email
  • 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
Variables for data storage*1.0.27Variables in which user data will be savedVariable 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 typeFrom versionParameter value to enter (without using the drop down list)
First name1.0.31

FIRSTNAME

Last name1.0.31LASTNAME
Email1.0.31EMAIL
Full name (first and last name)1.0.31FULLNAME
Number1.0.31NUMBER

User group names

1.0.31GROUPSNAMES

User's position names

1.0.31POSITIONSNAMES

User’s position symbols

1.0.31POSITIONSSYMBOLS

User's organizational units symbols

1.0.31POSITIONSOUSYMBOLS lub OUSYMBOLS (obie wersje poprawne)

User's organizational units names

1.0.31OUNAMES

User's superior's logins

1.0.27SUPERIORSNAMES

Sample action configuration

Using 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.

Change log

1.0.27

  • Adding a component that download information about supervisors

1.0.31

  • Data types support adding: 
    • First name
    • Last name
    • Email
    • Full name
    • Number
    • User group names
    • User's position names
    • User’s position symbols
    • User's organizational units symbols
    • User's organizational units names

1.0.??

  • Changing the name from "Downloading user data" to "Download user data"

Tasks related to the component

Current

Archive

A map with an example configuration