Versions Compared

Old Version 12

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

 Akcja

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

Panel
titlePodstawowe informacje

Kategoria: Użytkownik

Poprzednie nazwy: Pobieranie danych użytkownika

Umiejscowienie akcji: Zmienna, Przycisk, Formularz

Dostępna od wersji: 1.0.27

Panel
titleOpis

 Akcja, która na podstawie podanego loginu wyszukuje dane użytkownika i zapisuje je do zmiennej nagłówkowej lub tabelarycznej.


W

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


Rodzaj danych ( typ : wartość tekstowa ) - Rodzaj

W przypadku zmiennej tabelarycznej kolejne wartości są zapisywane w kolejnych komórkach kolumny.

Wywołanie akcji

Wywołanie akcji zależy od jej umiejscowienia.

  • Jeżeli akcja znajdzie się na przycisku, to zostanie wykonana tylko, gdy przycisk zostanie naciśnięty.
  • Jeżeli akcja znajdzie się na zmiennej, to wykona się za każdym razem, gdy zmieni się zmienna na której została umiejscowiona lub warunek wykonania warunkowego zmieni się na prawdę.
  • Jeżeli akcja znajdzie się na formularzu, to zostanie wykonana, gdy warunek wykonania warunkowego zmieni się na prawdę

Wykonanie warunkowe

Wykonanie warunkowe działa w inny sposób dla trzech przypadków:

  • Jeżeli akcja znajdzie się na przycisku, to wykonanie warunkowe "aktywuje" akcję od przycisku - od tej pory po każdym naciśnięciu wywoła się akcja.
  • Jeżeli akcja znajdzie się na zmiennej, to wykonanie warunkowe nie tylko "aktywuje" akcję po każdej zmianie tej zmiennej, ale też natychmiastowo wykonuje ją (za każdym razem, gdy wykonanie warunkowe zmieni się z fałszu na prawdę)
  • Jeżeli akcja znajdzie się na formularzu, to wykonanie warunkowe wykonuje akcję (za każdym razem, gdy wykonanie warunkowe zmieni się z fałszu na prawdę)

Umiejscowienie akcji

Zmienna, Przycisk, Formularz

Przykładowa konfiguracja akcji

Image Removed

Parametry konfiguracyjne

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
Panel
titleWywołanie akcji
Warning

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ę"
Panel
titleParametry 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
zmiennej. Parametr występuje jako lista wyboru z dostępnymi wartościami:

  • 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
  • Przełożeni użytkownika - pobiera loginy przełożonych użytkownika

Login użytkownika ( typ : wartość tekstowa ) - Login użytkownika, którego dane zostaną zapisane do zmiennej. ( jeżeli przypiszemy akcję pod zmienną, to parametr zostanie uzupełniony automatycznie )

Zmienna docelowa ( typ : zmienna ) - Zmienna do której zostaną dane użytkownika.

 

Film instruktażowy

 

Mapa z przykładową konfiguracją

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:

Wartość wyświetlanaWartość przekazywanaOd wersji
ImięFIRSTNAME1.0.31
NazwiskoLASTNAME1.0.31
EmailEMAIL1.0.31
Imię i nazwiskoFULLNAME1.0.31
NumerNUMBER1.0.31
Nazwy grup użytkownikaGROUPSNAMES1.0.31
Nazwy stanowisk użytkownikaPOSITIONSNAMES1.0.31
Symbole stanowisk użytkownikaPOSITIONSSYMBOLS1.0.31
Symbole jednostek organizacyjnych użytkownikaPOSITIONSOUSYMBOLS lub OUSYMBOLS1.0.31
Nazwy jednostek organizacyjnych użytkownikaOUNAMES1.0.31
Loginy przełożonych użytkownikaSUPERIORSNAMES1.0.27
Zmienne do zapisu danych*1.0.27Zmienne w których zostaną zapisane dane użytkownikaTablica zmiennych 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

Panel
titlePrzykładowa konfiguracja

Image Added

Panel
titlePrzykład zastosowania
Expand
titlePrzykład 1
Panel
titlePrzykł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:

Image Added

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.

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

1.0.43

  • Dodanie dynamicznego formularza
Panel
titlePakiet z przykładowym formularzem wykorzystującym akcję

View file
nameTesty komponentów - akcje - [AKCJA] Pobieranie danych u ytkownika 2019-10-14 10_23_35.zip

pageAkcje cuf-components

height250
 

Hide If
special@anonymous

Powiązane zadania

Zadania związane z komponentem

Aktualne

Archiwalne

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

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

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

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: User

Previous names: Downloading user data (up to version ???)

Action location: Variable, Button, Form

Available from version: 1.0.27

Panel
titleDescription

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
Panel
titleAction call-up
Info

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

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" 
Panel
titleConfiguration 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.

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
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*- mandatory field

Panel
titleConfiguration example

Image Added

Expand
titleExample 1
Panel
titleExample

 

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:

Image Added

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.

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