item

Zwraca element tablicy o podanym indeksie. 

item(index, array) : object

index : integer

Indeks elementu

array : object[]

Tablica dowolnego typu

Wynik:

Element z podanego indeksu

//zwraca  "b"
 item(1, ["a", "b"]);

length

 Zwraca długość tablicy. W przypadku sprawdzania, czy długość tablicy wynosi 0 należy używać funkcji emptyArrayempty dla typów tablicowych, ponieważ length zwraca niepoprawny wynik dla tablic o długości 0.

length(array) : integer

array : object[]

Tablica dowolnego typu

Wynik:

Długość tablicy

 //zwraca 2 
length(["a", "b"]);

formatArray

format(value[], decimalLen, decimalSeparator, thousandSeparator) : string[]

value : float[]/integer[]

Tablica wartości liczbowych do sformatowania

decimalLen : integer

Liczba miejsc po przecinku

decimalSeparator : string

Separator ułamkowy

thousandSeparator : string

Separator tysięczny (w przypadku pustego łańcucha znaków separator nie pojawi się)

Wynik:

Sformatowana wartość liczbowa w postaci tablicy tekstowej

// zwraca ["9 999,1230","1 234,0000", "4 234,1234"]
format([9999.123 , 1234 , 4321.12345], 4, ",", " ")

// zwraca ["9,999.1230"]
format( [9999.123], 4, ".", "," )

// zwraca ["10000"]
format([10000.123], 0, ",", "")

// zwraca ["149,13"]
format([149.125], 2, ",", " ")

formatTextArray

formatText(schema[], parameters, [customRegex]) : string[]

schema : string[]

Tablica schematów, w którym kolejne znaki #(lub podane jako opcjonalny parametr customRegex) zostaną zastąpione przez kolejne znaki z parameters.

parameters : string[]

Parametry tekstowe, których kolejne znaki zostaną wpisane do schematu

customRegex : string

Parametr, który zmienia domyślnie podmieniany znak "#" w schemacie, na inny, dowolny

Wynik:

Tablica łańcuchów znaków sformatowany według schematu

// zwraca ["AAA-BBB-123","ACAFA123"]
formatText(["###-BBB-###","#C#F####"], ["AA", "A123"])

// zwraca ["#1234BB","12034##BB"]
formatText("#ZZZZZZ",ZZ0ZZ##ZZ ["1234BB"], "Z")

intersect

Wspólna część dwóch tablic. Zwraca elementy, które znajdują się zarówno w pierwszej, jak i w drugiej tablicy, bez powtórzeń.

intersect(arr1, arr2) : object[]

arr1 : string[] | integer[] | float[] | date[]

Pierwsza tablica wartości

arr2 : string[] | integer[] | float[] | date[]

Druga tablica wartości

Wynik:

Tablica wartości (wspólna część tablic) o typie zależnym od wybranych parametrów.

// Zwraca ["aaa"]
intersect(["aaa", "ccc"], ["aaa", "bbb"])

// Zwraca [5]
intersect([null, 4, 5], [5, 1])

// Zwraca []
intersect([true], [false, null])

except

Różnica dwóch tablic. Zwraca elementy, które znajdują się w pierwszej, ale nie znajdują w drugiej tablicy, bez powtórzeń.

except(arr1, arr2) : object[]

arr1 : string[] | integer[] | float[] | date[]

Pierwsza tablica wartości

arr2 : string[] | integer[] | float[] | date[]

Druga tablica wartości

Wynik:

Tablica wartości (różnica tablic) o typie zależnym od wybranych parametrów.

// Zwraca ["ccc"]
except(["aaa", "ccc"], ["aaa", "bbb"])

// Zwraca [null, 4]
except([null, 4, 5], [5, 1])

// Zwraca [true]
except([true], [false, null])

union

Suma dwóch tablic. Zwraca elementy, które znajdują się w pierwszej lub w drugiej tablicy, bez powtórzeń.

union(arr1, arr2) : object[]

arr1 : string[] | integer[] | float[] | date[]

Pierwsza tablica wartości

arr2 : string[] | integer[] | float[] | date[]

Druga tablica wartości

Wynik:

Tablica wartości (suma tablic) o typie zależnym od wybranych parametrów.

// Zwraca ["aaa", "ccc", "bbb"]
union(["aaa", "ccc"], ["aaa", "bbb"])

// Zwraca [null, 4, 5, 1]
union([null, 4, 5], [5, 1])

// Zwraca [true, false, null]
union([true], [false, null])

symmetricDifference

Różnica symetryczna dwóch tablic. Zwraca elementy, które nie znajdują się jednocześnie w pierwszej i drugiej tablicy, bez powtórzeń.

symmetricDifference(arr1, arr2) : object[]

arr1 : string[] | integer[] | float[] | date[]

Pierwsza tablica wartości

arr2 : string[] | integer[] | float[] | date[]

Druga tablica wartości

Wynik:

Tablica wartości (różnica symetryczna tablic) o typie zależnym od wybranych parametrów.

// Zwraca ["ccc", "bbb"]
symmetricDifference(["aaa", "ccc"], ["aaa", "bbb"])

// Zwraca [null, 4, 1]
symmetricDifference([null, 4, 5], [5, 1])

// Zwraca [true, false, null]
symmetricDifference([true], [false, null])

unionAll

Suma dwóch tablic. Tworzy nową tablicę scalając dwie tablice przekazane w parametrze.

unionAll(arr1, arr2) : object[]

arr1 : string[] | integer[] | float[] | date[]

Pierwsza tablica wartości

arr2 : string[] | integer[] | float[] | date[]

Druga tablica wartości

Wynik:

Tablica wartości (suma tablic) o typie zależnym od wybranych parametrów.

// Zwraca ["aaa","ccc", "aaa", "bbb"]
unionAll(["aaa", "ccc"], ["aaa", "bbb"])

// Zwraca [null, 4, 5, 5, 1]
unionAll([null, 4, 5], [5, 1])

// Zwraca [true, false, null]
unionAll([true], [false, null])

distinct

Funkcja zwracająca tablicę wartości bez powtórzeń z tabeli przekazanej w parametrze.

distinct(array) : object[]

array :string[] | integer[] | float[] | date[]

Tablica wartości

Wynik:

Tablica z wartościami o typie zależnym od typu przekazanego w parametrze

// Zwraca ["aaa", "bbb"]
distinct(["aaa", "bbb", "aaa"]) 

// Zwraca [null, 4, 5]
distinct([null, 4, 5, null, 4)

// Zwraca [true, false]
distinct([true, true, true, false, false])

filter

Cuf-components od wersji 1.0.55 do 1.0.101

od wersji 1.0.106 funkcja została przywrócona

(została zastąpiona przez TableStore.filter)
Funkcja filtrująca elementy tablicy wg podanych kryteriów. Pozostawia te wartości, które spełnią wszystkie z filtrów. Filtr może być pojedyńczy lub tablicowy.

Filtry pojedyncze porównują wartości z pola Kolumny do filtrowania z wartością w polu Wartości filtrujące.

Filtry tablicowe porównują wartości z pola Kolumny do filtrowania z odpowiadającymi im (pod względem kolejności) wartościami podanymi w polu Kolumny filtrujące.

filter(array, singleVariables, singleFilterTypes, singleFilter, multiVariables, multiFilterTypes multiFilter) : string[] | integer[] | float[] | date[]

array : string[] | integer[] | float[] | date[]

Tablica wartości

singleVariables : variable[]
Kolumny do filtrowania (dla pojedyńczych wartości)

singleFilterTypes : string[]

Rodzaj filtrowania

singleFilter : string[]

Wartości filtrujące

multiVariables : variable[]

Kolumny do filtrowania (dla wartości tabelarycznych)

multiFilterTypes : string[]

Rodzaj filtrowania

multiFilter : variable[]

Kolumny filtrujące

subArray

subArray(array,from,to) : string[] | integer[] | float[] | date[] | datetime[] | boolean[]

Tablica(array) : string[] | integer[] | float[] | date[] | datetime[] | boolean[]

Taablica oryginalnej wielkości

Od(from) : integer

Indeks początkowy (z tym indeksem)

Do(to) : integer

Indeks końcowy (bez tego indeksu)

Wynik:

Tablica stanowiąca cześć orginalnej tablicy wejściowej

// zwróci [2]
subArray([1,2,3], 1,2)
 
// zwróci [2,3]
subArray("[1,2,3], 1,6)
 
// zwróci [1,2]
subArray("[1,2,3], -1,2)

getSelectedRowNo

Funkcja zwracająca indeks zaznaczonego wiersza. Numeracja wierszy rozpoczyna się od 0. W przypadku niezaznaczenia wiersza, wynikiem funkcji jest -1.

getSelectedRowNo(tableId) : integer

tableId: string

Tekst wejściowy

Wynik:

Liczba całkowita

// zwróci 2
getSelectedRowNo("id_tabeli")

itemOrElse

itemOrElse(index, array, otherValue) : object

index : integer

Indeks elementu

array : object[]

Tablica dowolnego typu

otherValue: object

Wartość dowolnego typu

Wynik:

Element z podanego indeksu lub określona wartość

//zwraca  "c"
 itemOrElse(2, ["a", "b"], "c");

createStringArray

createStringArray(length, initialValue) : string[]

length : integer

Długość tablicy

initialValue : string [opcjonalny]

Wartość inicjująca

Wynik:

Nowa tablica wartości

// zwraca ["", "", ""]
createStringArray(3);

// zwraca ["a", "a", "a"]
createStringArray(3, "a");

createIntegerArray

createIntegerArray(length, initialValue) : integer[]

length : integer

Długość tablicy

initialValue : integer [opcjonalny]

Wartość inicjująca

Wynik:

Nowa tablica wartości

// zwraca [0, 0, 0]
createIntegerArray(3);

// zwraca [100, 100, 100]
createIntegerArray(3, 100);

createFloatArray

createFloatArray(length, initialValue) : float[]

length : integer

Długość tablicy

initialValue : float [opcjonalny]

Wartość inicjująca

Wynik:

Nowa tablica wartości

// zwraca [0.0, 0.0, 0.0]
createFloatArray(3);

// zwraca [1.23, 1.23, 1.23]
createFloatArray(3, 1.23);

createDateArray

createDateArray(length, initialValue) : date[]

length : integer

Długość tablicy

initialValue : date [opcjonalny]

Wartość inicjująca

Wynik:

Nowa tablica wartości

// zwraca [null, null, null]
createDateArray(3);

// zwraca [2024-01-31, 2024-01-31, 2024-01-31]
createDateArray(3, 2024-01-31);

toString

System Plusworkflow

Konwertuje podaną wartość do jej domyślnej postaci tekstowej. Możliwa jest konwersja z:

• wartości logicznej (boolean)
  • true = "true"
  • false = "false"
• liczby całkowitej (integer)
  
  • 123 = "123"
• liczby zmiennoprzecinkowej
  • 123.12 = "123.12"
• datyformatuje datę używając domyślnego formatu "yyyy-MM-dd"
  
  • 2016-01-01 = "2016-01-01"
• daty i czasu (datetime) - formatuje datę używając domyślnego formatu "yyyy-MM-dd HH:mm:ss"
  
  • 2016-01-01 12:11:22 = "2016-01-01 12:11:22"

toString(value) : string

value : boolean|integer|float|date|datetime

Konwertowana wartość

Wynik:

Tekst reprezentujący wartość

//zwraca "false"
toString(false);

toStringArray

System Plusworkflow

toStringArray(array) : string[]

array : variable|boolean[]|integer[]|float[]|date[]|datetime[]

Konwertowana tablica wartości

Wynik:

Tablica wartości tekstowych

//zwraca ["false", "true"]
toStringArray([false, true]);

toBoolean

System Plusworkflow

• wartości tekstowej (string)
  • "true" = true
  • "false" = false
• liczby całkowitej (integer)
  
  • 0 = false reszta true
• liczby zmiennoprzecinkowej (float)
  
  • 0.0 = false reszta true

toBoolean(value) : boolean

value : string|integer|float

Konwertowana wartość

Wynik:

Wartość logiczna

//zwraca true
toBoolean("true");

toBooleanArray

System Plusworkflow

toBooleanArray(array) : boolean[]

 array : string[]|integer[]|float[]

Konwertowana tablica wartości

Wynik:

Tablica wartości logicznych

//zwraca [false, true]
toBooleanArray([0, 1]);

toInteger

System Plusworkflow

Konwertuje podaną wartość do liczby całkowitej. Możliwa jest konwersja z:

• wartości logicznej (boolean)

  • true = 1

  • false = 0

• wartości tekstowej (string)

  • "123" = 123

• liczby zmiennoprzecinkowej (float) - zaokrąglanie do najbliższej liczby całkowitej

  • 123.56 = 124

toInteger(value) : integer

value : boolean|string|float

Konwertowana wartość

Wynik:

Liczba całkowita

//zwraca 123
toInteger("123");

toIntegerArray

System Plusworkflow

toIntegerArray(array) : integer[]

array : variable|boolean[]|string[]|float[]

Konwertowana tablica wartości

Wynik:

Tablica liczb całkowitych

//zwraca [1, 2]
toIntegerArray(["1", "2"]);

toFloat

System Plusworkflow

Konwertuje podaną wartość do liczby zmiennoprzecinkowej. Możliwa jest konwersja z:

• wartości logicznej (boolean)

  • true = 1.0

  • false = 0.0

• wartości tekstowej (string)

  • "123.123" = 123.123

• liczby całkowitej (integer)

  • 123 = 123.0

toFloat(value) : float

 value : boolean|string|integer

Konwertowana wartość

Wynik:

Liczba zmiennoprzecinkowa

//zwraca 123.123
toFloat("123.123");

toFloatArray

System Plusworkflow

toFloatArray(array) : float[]

array : boolean[]|string[]|integer[] | variable

Konwertowana tablica wartości

Wynik:

Tablica liczb zmiennoprzecinkowych

//zwraca [1.0, 2.3]
toFloatArray(["1", "2.3"]);

toDate

Konwertuje podaną wartość tekstową do daty. Formaty przyjmowane przez funkcję:

"Y-M-d", "Y.M.d", "d-M-Y", "d.M.Y"

toDate(value) : date

value: string

Wartość tekstowa

Wynik:

Data uzyskana z tekstu

// zwraca obiekt LocalDate z datą 1991-06-12
toDate("1991-06-12");
// zwraca null
toDate("");
toDate(null);

toDateArray

toDateArray(values) : date[]

values - string[] | variable

Tablica wartości tekstowych / zmiennych

Wynik:

Tablica dat uzyskana z tablicy wartości tekstowych

// Zwraca tablice obiektów LocalDate
toDateArray(["1991-06-12", "1991-06-13"] );
// zwraca pustą tablicę
toDateArray([])

toDateTime

Konwertuje podaną wartość tekstową do daty z czasem. Formaty przyjmowane przez funkcję:

"Y-M-d", "Y.M.d", "d-M-Y", "d.M.Y",
"Y-M-d H:m:s", "Y.M.d H:m:s", "d-M-Y H:m:s", "d.M.Y H:m:s"

toDateTime(value) : datetime

value - string

Wartość tekstowa

Wynik:

Data i czas z wartości tekstowej

// zwraca obiekt LocalDateTime z datą 1991-06-12 11:09:22
toDateTime("1991-06-12 11:09:22");
// zwraca null
toDateTime("");
toDateTime(null);

toDateTimeArray

toDateTimeArray(values) : datetime[]

values - string[]

Tablica wartości tekstowych

Wynik:

Tablica wartości z datą i czasem stworzona z tablicy wartości tekstowych

// zwraca tablicę wartości LocalDateTime
toDateTimeArray(["1991-06-12 11:09:12", "1991-06-13 11:09:11"] );
// zwraca pustą tablicę
toDateTimeArray([])

currentUser

Zwraca login aktualnego użytkownika.

currentUser() : string

Wynik:

Login aktualnego użytkownika.

// np. "admin"
currentUser()

currentUser

• username: login
• firstname: imię
• lastname: nazwisko
• fullname: pełna nazwa (imię + nazwisko)
• email: adres email
• number: numer użytkownika

currentUser(property) : string

property : string

Nazwa zwracanej właściwości użytkownika

Wynik:

Wartość podanej właściwości aktualnego użytkownika

// np. "admin@suncode.pl"
currentUser("email")

currentUserGroups

Zwraca listę nazw grup aktualnego użytkownika.

currentUserGroups() : string[]

Wynik:

Tablica nazw grup do których należy użytkownik

// np. ["pracownik", "administrator"]
currentUserGroups()

currentUserInGroup

Wszystkie komponenty

currentUserInGroup(group) : boolean

group : string

Nazwa grupy

Wynik:

true jeżeli użytkownik należy do podanej grupy

// true jeżeli należy do grupy
currentUserGroups("pracownik")

currentUserPositions

currentUserPositions() : string[]

Wynik:

Tablica symboli stanowisk użytkownika

// np. ["p01", "d02"]
currentUserPositions()

currentUserPositionNames

currentUserPositionNames() : string[]

Wynik:

Tablica nazw stanowisk użytkownika

// np. ["Pracownik1", "Akceptujący"]
currentUserPositionNames() 

currentUserHasPosition

Wszystkie komponenty

currentUserHasPosition(symbol) : boolean

symbol : string

Symbol stanowiska

Wynik:

true jeżeli użytkownik jest przypisany do podanego stanowiska

 // true jeżeli jest przypisany do stanowiska
currentUserHasPostition("p01")

currentUserUnits

currentUserUnits() : string[]

Wynik:

Tablica symboli jednostek organizacyjnych do których należy użytkownik

 // np. ["kadry", "it"]
currentUserUnits()

currentUserUnitNames

currentUserUnitNames() : string[]

Wynik:

Tablica nazw jednostek organizacyjnych do których należy użytkownik

 // np. ["Kadry", "Dział IT"]
currentUserUnitNames()

currentUserInUnit

Wszystkie komponenty

currentUserInUnit(symbol) : boolean

symbol : string

Symbol jednostki organizacyjnej

Wynik:

true jeżeli użytkownik należy do podanej jednostki organizacyjnej

// true jeżeli należy do jednostki
currentUserInUnit("it")

currentUserHigherPositions

currentUserHigherPostitions() : string[]

Wynik:

Tablica symboli stanowisk nadrzędnych użytkownika

 // np. ["kp"]
currentUserHigherPositions()

currentUserHigherPositionNames

currentUserHigherPostitionNames() : string[]

Wynik:

Tablica nazw stanowisk nadrzędnych użytkownika

// np. ["Kierownik Produkcji"]
currentUserHigherPositionNames() 

currentUserSupervisors

currentUserSupervisors() : string[]

Wynik:

Tablica loginów wszystkich bezpośrednich przełożonych aktualnego użytkownika

// np. ["akowalski"]
currentUserSupervisors() 

currentUserHasSupervisor

Wszystkie komponenty

currentUserSupervisors(username) : boolean

username : string

Login użytkownika

Wynik:

true jeżeli podany użytkownik jest bezpośrednim przełożonym aktualnego użytkownika

// true jeżeli "akowalski" jest
// przełożonym użytkownika
currentUserHasSupervisor("akowalski")

isMobile

isMobile() : boolean

Wynik:

true jeżeli formularz jest uruchomiony w aplikacji mobilnej PlusWorkflow Mobile

// true jeżeli formularz jest uruchomiony 
// w aplikacji mobilnej PlusWorkflow Mobile
isMobile()

getFullName

getFullName(userName) : string

userName : string

Login użytkownika

Wynik:

Wartość tekstowa.

// zwróci Jan Kowalski
getFullName("jkowalski")

getFullNames

getFullNames(userNames) : string[]

userNames : string[]

Loginy użytkowników

Wynik:

Tablica wartości tekstowych.

// zwróci ["Jan Kowalski", "Piotr Nowak"]
getFullNames(["jkowalski", "pnowak"])

orginDelegateActivity

orginDelegateActivity() : string[]

Wynik:

Lista nazw użytkowników

 // np. ["akowalski"]
orginDelegateActivity()

currentActivityName

currentActivityName() : string

Wynik:

Nazwa aktualnego zadania.

// np. Zadanie 1
currentActivityName()

ifFn

Funkcja warunkowa (if) - zwraca dany parametr w zależności od warunku

parametry trueParam i falseParam muszą być tego samego typu.

ifFn( condition , trueParam , falseParam ) : integer/float/string/date/datetime/boolean/integer[]/float[]/string[]/date[]/datetime[]/boolean[]

condition : boolean

Warunek funkcji

trueParam : integer/float/string/date/datetime/boolean/integer[]/float[]/string[]/date[]/datetime[]/boolean[]

Wartość zwracana, gdy warunek prawdziwy

falseParam : integer/float/string/date/datetime/boolean/integer[]/float[]/string[]/date[]/datetime[]/boolean[]

Wartość zwracana, gdy warunek nie prawdziwy

Wynik:

Wynikiem jest parametr trueParam lub falseParam w zależności od spełnienia warunku

// zwraca 2
ifFn(true,2,3);
// zwraca "NIE"
ifFn(false,"TAK", "NIE");
// zwraca ["a","b"]
ifFn(false,["AA","BB","CC"], ["a","b"]);

ifFnString

ifFnString( condition , trueParam , falseParam ) : string

condition : boolean

Warunek funkcji

trueParam : string

Wartość zwracana, gdy warunek prawdziwy

falseParam : string

Wartość zwracana, gdy warunek nie prawdziwy

Wynik:

Wartość tekstowa, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnStringArray

ifFnStringArray( condition , trueParam , falseParam ) : string[]

condition : boolean

Warunek funkcji

trueParam : string[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Tablica wartości tekstowych

falseParam : string[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Tablica wartości tekstowych

Wynik:

Tablica wartości tekstowych, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnInteger

ifFnInteger( condition , trueParam , falseParam ) : integer

condition : boolean

Warunek funkcji

trueParam : integer

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Całkowity

falseParam : integer

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Całkowity

Wynik:

Wartość całkowita, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnIntegerArray

ifFnIntegerArray( condition , trueParam , falseParam ) : integer[]

condition : boolean

Warunek funkcji

trueParam : integer[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Tablica wartości całkowitych

falseParam : integer[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Tablica wartości całkowitych

Wynik:

Tablica wartości całkowitych, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnFloat

ifFnFloat( condition , trueParam , falseParam ) : float

condition : boolean

Warunek funkcji

trueParam : float

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Zmiennoprzecinkowy

falseParam : float

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Zmiennoprzecinkowy

Wynik:

Wartość zmiennoprzecinkowa, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnFloatArray

ifFnIntegerArray( condition , trueParam , falseParam ) : float[]

condition : boolean

Warunek funkcji

trueParam : float[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Tablica wartości zmiennoprzecinkowych

falseParam : float[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Tablica wartości zmiennoprzecinkowych

Wynik:

Tablica wartości zmiennoprzecinkowych, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnDate

ifFnDate( condition , trueParam , falseParam ) : date

condition : boolean

Warunek funkcji

trueParam : date

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Datowy

falseParam : date

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Datowy

Wynik:

Wartość datowa, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnDateArray

ifFnDateArray( condition , trueParam , falseParam ) : date[]

condition : boolean

Warunek funkcji

trueParam : date[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Tablica wartości datowych

falseParam : date[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Tablica wartości datowych

Wynik:

Tablica wartości datowych, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnDateTime

ifFnDateTime( condition , trueParam , falseParam ) : datetime

condition : boolean

Warunek funkcji

trueParam : datetime

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Datowy z czasem

falseParam : datetime

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Datowy z czasem

Wynik:

Wartość datowa z czasem, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnDateTimeArray

ifFnDateTimeArray( condition , trueParam , falseParam ) : datetime[]

condition : boolean

Warunek funkcji

trueParam : datetime[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Tablica wartości datowych z czasem

falseParam : datetime[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Tablica wartości datowych z czasem

Wynik:

Tablica wartości datowych z czasem, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnBoolean

ifFnBoolean( condition , trueParam , falseParam ) : boolean

condition : boolean

Warunek funkcji

trueParam : boolean

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Logiczny

falseParam : boolean

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Logiczny

Wynik:

Wartość logiczny, będąca wynikiem jednej z funkcji przekazanych w parametrze

ifFnBooleanArray

ifFnBooleanArray( condition , trueParam , falseParam ) : boolean[]

condition : boolean

Warunek funkcji

trueParam : boolean[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca prawdę. Musi zwracać typ Tablica wartości logicznych

falseParam : boolean[]

Funkcja, której wynik jest zwracany w przypadku, gdy warunek zwraca fałsz. Musi zwracać typ Tablica wartości logicznych

Wynik:

Tablica wartości logicznych, będąca wynikiem jednej z funkcji przekazanych w parametrze

translate

Zwraca tłumaczenie dla podanego klucza. Jeżeli tłumaczenie nie zostanie odnalezione, zwracany jest podany klucz. Pod uwagę brane są serwerowe (scope = SERVER) klienckie translatory oraz tłumaczenia z wtyczek.

translate(text) : string

text : string

Klucz do przetłumaczenia

Wynik: 

Przetłumaczony klucz wyszukany ze wszystkich dostępnych translatorów. 

// np. "Tak", jeżeli użytkownik ma
// ustawiony język polski
translate("yes")

translate

translate(text,translatorName) : string

text : string

Klucz do przetłumaczenia

translatorName : string

Nazwa translatora

Wynik:

Przetłumaczony klucz wyszukany w podanym translatorze.

// np. "Faktury", jeżeli stworzony został kliencki
// translator lub tłumaczenie zostało dodane do wtyczki
// o takim id
translate("invoices", "customTranslatorName")

translate("customKey", "custom-messages")

translate

translate(text, args, translatorName) : string

text : string

Klucz do przetłumaczenia

args : string[]

Parametry przekazywane do translatora. Podstawiane za znaczniki {0}, {1} itd.

translatorName : string

Nazwa translatora

Wynik:

Przetłumaczony klucz wyszukany w podanym translatorze z podstawionymi parametrami

// np. dla translatora o nazwie "customTranslatorName" i klucza
// invoice=Faktura nr {0} z {1}
translate("invoice", ["123", "1000"], "customTranslatorName")
// wynik "Faktura nr 123 z 1000

usersFromGroup

usersFromGroup(groupName) : string[]

groupName (string)

Nazwa grupy

Wynik:

Tablica loginów użytkowników

usersFromGroup

usersFromGroup(groupName, ou) : string[]

groupName (string)

Nazwa grupy

ou (string)

Symbol jednostki organizacyjnej

Wynik:

Tablica loginów użytkowników

usersWithRole

usersWithRole(roleId) : string[]

roleId (string)

Rola

Wynik:

Tablica loginów użytkowników

usersWithRole

usersWithRole(roleId, ouprocessDefId) : string[]

roleId (string)

RolaIdentyfikator roli

ou processDefId (string)

Jednostka organizacyjna (symbol)

Identyfikator definicji procesu

Wynik:

Tablica loginów użytkowników

usersWithRole

roleId (string)

Identyfikator roli

packageId (string)

Identyfikator pakietu

processDefId (string)

Identyfikator definicji procesu

Wynik:

Tablica loginów użytkowników

usersWithRoleFromPackageId

usersWithRoleFromPackageId(roleId, packageId) : string[]

roleId (string)

Identyfikator roli

packageId (string)

Identyfikator pakietu

Wynik:

Tablica loginów użytkowników

userSuperiors

userSuperiors(userName) : string[]

userName : string

Nazwa użytkownika

usersFromOU

Funkcja serwerowa pobierająca loginy użytkowników z jednostki organizacyjnej o podanej nazwie

usersFromOU(ou) : string[]

ou : string

Nazwa jednostki organizacyjnej

Wynik:

Tablica z loginami użytkowników

usersFromOU

Funkcja serwerowa pobierająca loginy użytkowników z jednostki organizacyjnej o podanej nazwie i (opcjonalnie) użytkowników z jednostek podrzędnych do niej.

usersFromOU(ouName, includeSubUnits ) : string[]

ouName : string

Nazwa jednostki organizacyjnej

includeSubUnits : boolean

Dodaj użytkowników z jednostek podrzędnych

Wynik:

Tablica z loginami użytkowników

usersFromOUSymbol

Funkcja serwerowa pobierająca loginy użytkowników z jednostki organizacyjnej o podanym symbolu

usersFromOUSymbol(ousymbol) : string[]

ouSymbol : string

Symbol jednostki organizacyjnej

Wynik:

Tablica z loginami użytkowników

usersFromOUSymbol

Funkcja serwerowa pobierająca loginy użytkowników z jednostki organizacyjnej o podanym symbolu i (opcjonalnie) użytkowników z jednostek podrzędnych do niej.

usersFromOUSymbol(ousymbol, includeSubUnits) : string[]

ouSymbol : string

Symbol jednostki organizacyjnej

includeSubUnits : boolean

Dodaj użytkowników z jednostek podrzędnych

Wynik:

Tablica z loginami użytkowników

userWithPosition

Funkcja serwerowa pobierająca login użytkownika ze stanowiskiem o podanej nazwie

userWithPosition(position) : string

postition : string

Nazwa stanowiska

Wynik:

Login użytkownika

userWithPositionSymbol

Funkcja serwerowa pobierająca login użytkownika ze stanowiskiem o podanym symbolu

userWithPositionSymbol(positionSymbol) : string

postitionSymbol : string

Symbol stanowiska

Wynik:

Login użytkownika

usersWithPositions

Funkcja serwerowa pobierająca loginy użytkowników ze stanowiskami o podanych nazwach

usersWithPositions(positions) : string[]

postition : string[]

Nazwy stanowisk

Wynik:

Loginy użytkowników

usersWithPositionsSymbols

Funkcja serwerowa pobierająca loginy użytkowników ze stanowiskami o podanych symbolach

userWithPositionSymbol(positionsSymbols) : string[]

postitionsSymbols : string[]

Symbole stanowisk

Wynik:

Loginy użytkowników

getSubstitutionsForSubstitute

Funkcja serwerowa zwracająca nazwy (loginy) użytkowników zastępowanych przez wskazanego użytkownika.

getSubstitutionsForSubstitute(userName) : string[]

Username : String

Nazwa użytkownika

Wynik:

Nazwy (loginy) użytkowników

getSubstitutionsForSubstituted

getSubstitutionsForSubstituted(userName) : string[]

Username : String

Nazwa użytkownika

Wynik:

Nazwy (loginy) użytkowników

getUserSuperiorsFromOu

getUserSuperiorsFromOu(userLogin, userPositionOuSymbol) : string[]

userLogin: String

Login użytkownika

userPositionOuSymbol: String

Symbol jednostki organizacyjnej

Wynik:

Tablica nazw przełożonych z podanej jednostki organizacyjnej

usersWithRoleAndOU

usersWithRoleAndOU(roleId, ou) : string[]

roleId : String

Identyfikator roli

ou : String

Symbol jednostki organizacyjnej

Wynik:
Loginy użytkowników

usersWithRoleAndOU

usersWithRoleAndOU(roleId, ou, processDefId) : string[]

roleId : String

Identyfikator roli

ou : String

Symbol jednostki organizacyjnej

processDefId : String

Identyfikator definicji procesu

Wynik:
Loginy użytkowników

usersWithRoleAndOU

usersWithRoleAndOU(roleId, ou, packageId, processDefId) : string[]

roleId : String

Identyfikator roli

ou : String

Symbol jednostki organizacyjnej

packageId: String

Identyfikator pakietu

processDefId : String

Identyfikator definicji procesu

Wynik:
Loginy użytkowników

numberOfDocumentsFromCurrentProcess

Tylko komponenty serwerowe

numberOfDocumentsnumberOfDocumentsFromCurrentProcess() : integer

Wynik:

Liczba dokumentów

numberOfDocumentsFromCurrentProcess

Tylko komponenty serwerowe

numberOfDocumentsnumberOfDocumentsFromCurrentProcess(className) : integer

className : string

Nazwa klasy dokumentów

Wynik:

Liczba dokumentów

documentsFromCurrentProcess

Tylko komponenty serwerowe

documentsFromCurrentProcess(classNames) : integer[]

classNames : string[]

Nazwy klas dokumentów

Wynik:

Lista documentId

latestFileId

Tylko komponenty serwerowe

latestFileId(documentId, className) : integer

documentId: int

Id dokumentu

className : string

Nazwy klas dokumentów

Wynik:

generateUniqueCode

Wszystkie komponenty

generateUniqueCode() : string

Wynik:

Tekst zawierający kod alfanumeryczny, np. oYWz3wVp1pj

generateMacAddress

Wszystkie komponenty

generateMacAddress() : string

Wynik:

Tekst zawierający wygenerowany adres MAC

generateMacAddress()
// Zwraca np. 40-33-43-5A-4C-D4

groupBy

CUF components od wersji 1.0.x

Od wersji 1.0.X zastąpione funkcją TableStore.groupBy

Grupuje i agreguje dane z tabeli (na wzór SQL-owej funkcji groupBy).

Szczegółowy opis funkcji.

groupBy(agregateFunctions, rawColumns, concatSeparator, decimalPlaces, groupByColumns) : string

Wynik:

Obiekt TableStore.

toJsonObject

Wszystkie komponenty

Generuje ciąg tekstowy JSON w postaci obiektu.

Szczegółowy opis

toJsonObject(keys, values, types) : String

keys: String[]

Nazwy kluczy

values: String[]

Wartości kluczy

types: String[]

Typy przechowywanych wartości

Wynik:

Ciąg tekstowy JSON reprezentujący obiekt.

// np. dla kluczy: imię, nazwisko
dla wartości: Adam, Pastewski
dla typów: Wartość tekstowa, Wartość tekstowa 
// wynik: {"imię":"Adam", "Nazwisko":"Pastewski"}

toJsonArray

Generuje ciąg tekstowy JSON w postaci tablicy.

Szczegółowy opis 

toJsonArray(values, type) : String

values: String[]

Wartości kluczy

type: String

Typ przechowywanych wartości

Wynik:

Ciąg tekstowy JSON reprezentujący tablicę.

// np. dla wartości: 5, 10, 15 
dla typu: Wartość całkowita 
// wynik: [5,10,15]

toJsonArrayIterator

Generuje ciąg tekstowy JSON w postaci tablicy obiektów, która może odzwierciedlać zawartość tabeli dynamicznej, dzięki zastosowaniu iteracji.

Szczegółowy opis 

toJsonArrayIterator(function, maxTableLength, counter, type) : String

function: FunctionCall

Funkcja, której wywołanie stanowi wartość tablicy. Funkcja wykonuje się tyle razy, ile wynosi długość tablicy

maxTableLength: Long

Długość tablicy

counter: Variable

Przechowuje bieżącą iterację

type: String

Typ przechowywanych wartości

Wynik:

Ciąg tekstowy JSON z możliwością reprezentowania tablicy obiektów.

TableStore.create

Tworzy obiekt TableStore.

Więcej... 

TableStore.create(variables) : string

Wynik:

Ciąg tekstowy JSON reprezentujący obiekt TableStore.

TableStore.create

Tworzy obiekt TableStore.

Więcej... 

TableStore.create(tableId) : string

Wynik:

Ciąg tekstowy JSON reprezentujący obiekt TableStore.

TableStore.length

Zwraca liczbę rekordów obiektu TableStore.

Więcej... 

TableStore.length(tablestore) : integer

Wynik:

Liczba rekordów obiektu TableStore.

TableStore.keys

Zwraca tablicę ID zmiennych tworzących obiekt TableStore.

Więcej... 

TableStore.keys(tablestore) : string[]

Wynik:

Tablica ID zmiennych tworzących obiekt TableStore.

TableStore.joinField

Zwraca wartości przekazanej kolumny scalone za pomocą przekazanego separatora.

Więcej... 

TableStore.joinField(tablestore, fieldId, separator) : string

Wynik:

String w postaci wartości przekazanej kolumny, złączonych przekazanym separatorem.

TableStore.addRecord

Dodaje rekord do przekazanego obiektu TableStore i zwraca TableStore z dodanym rekordem.

Więcej... 

TableStore.addRecord(tablestore, fieldIds, values) : string

Wynik:

Ciąg tekstowy JSON reprezentujący obiekt TableStore.

TableStore.addRecords

Dodaje rekordy z dwóch przekazanych TableStore'ów.

Więcej... 

TableStore.addRecords(sourcetablestore, tablestoretoadd) : string

Wynik:

Ciąg tekstowy JSON reprezentujący obiekt TableStore.

TableStore.filter

Filtruje rekordy TableStore i zwraca przefiltrowany TableStore.

Więcej... 

TableStore.filter(tablestore, logicalOperator, fieldIds, operators, values) : string

Wynik:

Ciąg tekstowy JSON reprezentujący obiekt TableStore.

TableStore.getItem

Pobiera wartość pola z danego rekordu obiektu TableStore.

Więcej... 

TableStore.getItem(tablestore, fieldid, elementNr) : string

Wynik:

Wartość tekstowa ze wskazanego pola we wskazanym rekordzie obiektu TableStore.

TableStore.getItem(tablestore, fieldid, elementNr) : integer

Wynik:

Wartość całkowita ze wskazanego pola we wskazanym rekordzie obiektu TableStore.

TableStore.getItem(tablestore, fieldid, elementNr) : float

Wynik:

Wartość zmiennoprzecinkowa ze wskazanego pola we wskazanym rekordzie obiektu TableStore.

TableStore.getItem(tablestore, fieldid, elementNr) : date

Wynik:

Wartość datowa ze wskazanego pola we wskazanym rekordzie obiektu TableStore.

TableStore.setItems

Modyfikuje wskazany rekord obiektu TableStore przekazanymi wartościami i zwraca zmodyfikowany TableStore.

Więcej...

TableStore.setItems(tablestore, elementNr, fieldIds, values) : string

Wynik:

Ciąg tekstowy JSON reprezentujący obiekt TableStore.

TableStore.groupBy

Grupuje i agreguje dane z tabeli (na wzór SQL-owej funkcji groupBy).

Więcej...

groupBy(agregateFunctions, rawColumns,filedID, concatSeparator, decimalPlaces, groupByColumns) : string

Wynik:

Obiekt TableStore.

TableStore.sort

Sortuje wiersze istniejącego obiektu TableStore na podstawie wskazanego identyfikatora pola.

Więcej...

sort(tableStoreStr, columnId, sortDirection) : string

Wynik:

Ciąg tekstowy JSON reprezentujący obiekt TableStore.

TableStore.deleteRecord

TableStore.deleteRecord(tableStoreStr, elementNumber) : string

StorageData.getString

Pobiera wartość tekstową z parametru formalnego StorageData

Więcej...

StorageData.getString(paramName) : string

Wynik:

Wartość tekstowa

StorageData.getInteger

Pobiera liczbę całkowitą z parametru formalnego StorageData.

Więcej...

StorageData.getInteger(paramName) : integer

Wynik:

Liczba całkowita

StorageData.getFloat

Pobiera liczbę zmiennoprzecinkową z parametru formalnego StorageData.

Więcej...

StorageData.getFloat(paramName) : float

Wynik:

Liczba zmiennoprzecinkowa

StorageData.getBoolean

Pobiera wartość logiczną z parametru formalnego StorageData.

Więcej...

StorageData.getBoolean(paramName) : boolean

Wynik:

Wartość logiczna

StorageData.getDate

Pobiera datę z parametru formalnego StorageData.

Więcej...

StorageData.getDate(paramName) : date

Wynik:

Data

StorageData.getDateTime

Pobiera datę i czas z parametru formalnego StorageData.

Więcej...

StorageData.getDateTime(paramName) : dateTime

Wynik:

Data i czas

StorageData.getStringArray

Pobiera tablicę wartości tekstowych z parametru formalnego StorageData.

Więcej...

StorageData.getStringArray(paramName) : string[]

Wynik:

Tablica wartości tekstowych

StorageData.getIntegerArray

Pobiera tablicę liczb całkowitych z parametru formalnego StorageData.

StorageData.getIntegerArray(paramName) : integer[]

Wynik:

Tablica liczb całkowitych

StorageData.getFloatArray

Pobiera tablicę liczb zmiennoprzecinkowych z parametru formalnego StorageData.

Więcej...

StorageData.getFloatArray(paramName) : float[]

Wynik:

Tablica liczb zmiennoprzecinkowych

StorageData.getBooleanArray

Pobiera tablicę wartości logicznych z parametru formalnego StorageData.

Więcej...

StorageData.getBooleanArray(paramName) : boolean[]

Wynik:

Tablica wartości logicznych

StorageData.getDateArray

Pobiera tablicę dat z parametru formalnego StorageData.

Więcej...

StorageData.getDateArray(paramName) : date[]

Wynik:

Tablica dat

StorageData.getDateTimeArray

Pobiera tablicę dat i czasu z parametru formalnego StorageData.

Więcej...

StorageData.getDateTimeArray(paramName) : datetime[]

Wynik:

Tablica dat i czasu

StorageData.exist

Sprawdza istnienie parametu w parametrze formalnym StorageData.

Więcej...

StorageData.exist(paramName) : boolean

Wynik:

Wartość logiczna

System.getHomeDirectory

Pobiera ścieżkę do katalogu PlusWorkflow_Home

System.getHomeDirectory() : string

Wynik:

Wartość tekstowa

Przykład:

/home/suncode/PlusWorkflow_Home/temp

System.getWorkingDirectory

System.getWorkingDirectory() : string

Wynik:

Wartość tekstowa

Przykład:

/home/suncode/PlusWorkflow_Home/temp

systemType

systemType() : string

Wynik:

Wartość tekstowa

Przykład:

Production

scheduledTaskStaticIdToId

scheduledTaskStaticIdToId("d5973826-d96a-4262-806e-65a44ddfd0d9") : long

Wynik:

Wartość liczbowa

Przykład:

50

 convertNumberToWord

Zamienia liczby na ich słowna interpretacje. W parametrze można podać następujące wartości: english, german, russian, italian, polish, czech, slovak, latvian, kazakh, ukrainian, serbian, serbian cyrillic, french, turkish, brazilian, portuguese

convertNumberToWord("1000", "polish", "$") : String

Wynik:

Tysiąc $ 00/100

convertNumberToWord("1000", "pl", "$") : String

Wynik:

Tysiąc $ 00/100

System.dbType

System.dbType(): String

Przykładowy wynik:

POSTGRES

isProcessedTable

Zwracana wartośc logiczna: TRUE lub FALSE.