eq

eq(v1, v2) : boolean

v1 : object | object[]

Dowolna pierwsza wartość

 v2 : object | object[]

Dowolna druga wartość

Wynik:

True jeżeli podane wartości są sobie równe

// równe
eq( 1, 1.00 )
eq( "tekst", "tekst" )
 
// nie równe
eq( 1, 1.01 )
eq( "tekst", "Tekst" )

ieq 

ieq(v1, v2) : boolean

v1 : string|string[]

Porównywany tekst

v2 string|string[]

Porównywany tekst

Wynik:

True jeżeli podane teksty są sobie równe bez uwzględnienia wielkości liter

równe
ieq( "tekst", "tekst" )
 
// nie równe
ieq( "tekst", "Tekst" )

 empty

Sprawdza, czy podana wartość jest pusta, bądź posiada jeden pusty element.

empty(value) : boolean

value : object|object[]

Sprawdzana wartość dowolnego typu

Wynik:

True jeżeli wartość jest pusta lub posiada jeden pusty element

// puste
empty( null ) 
empty( "" )
empty( [] )
empty( $var1 )
empty( [""] )
empty( [null] )  
// nie puste
empty( "tekst" )
empty( [1, 2] )

anyEq

anyEq(v1[], v2) : boolean

v1 : object[]

Dowolna tablica wartości

v2 : object

Wartość tego samego typu co wartości z tabeli v1

Wynik:

True jeżeli którakolwiek z wartości w v1 jest równa v2

// prawda
anyEq([1,2],1)
anyEq([3,2,1],1)
anyEq([1],1)

// fałsz
anyEq([3,2,1],5)

concat

Łączy podane fragmenty tekstu.

concat(strings) : string

strings : string[]

Tablica zawierająca fragmenty tekstu

Wynik:

Tekst powstały z połączenia podanych fragmentów

// zwróci "tekst"
concat(["te", "kst"])

join

Łączy podane fragmenty tekstu używając podanego separatora.

Aktualizacja od wersji 3.2.48 - dodano obsługę nowych typów parametrów (liczby, wartości logiczne, daty, daty z czasem)

join(fragments, [separator] ) : string

fragments : object[]

Tablica zawierająca fragmenty tekstu/liczby/wartości logiczne/daty/daty z czasem

separator : string

Znak którym zostaną połączone wszystkie fragmenty. Domyślnie " " (spacja).

Wynik:

Tekst powstały z połączenia podanych fragmentów separatorem

// zwróci "Jan Kowalski"
join(["Jan", "Kowalski"])
 
// zwróci "1;2;3"
join([1, 2, 3], ";")

// zwroci ";"
join(["", ""], ";");

// zwróci "2;;3"
join([2,null,3], ";");

capitalize

capitalize(text) : string

text : string

Tekst wejściowy

Wynik:

Tekst z pierwszą dużą literą

// zwróci "Tekst"
capitalize("tekst")

lowerCase

Zamienia wszystkie znaki w podanym tekście na małe litery.

lowerCase(text) : string

text : string

Tekst wejściowy

Wynik:

Tekst zapisany tylko małymi literami

// zwróci "tekst"
lowerCase("TEKST")

upperCase

Zamienia wszystkie znaki w podanym tekście na duże litery.

upperCase(text) : string

text : string

Tekst wejściowy

Wynik:

Tekst zapisany tylko dużymi literami

// zwróci "Tekst"
lowerCase("tekst")

substring

Zwraca tekst powstały z wydzielenia części podanego tekstu zgodnie z parametrami.

substring(text, start, [length]) : string

text : string

Tekst wejściowy

start : integer

Index startowy

length : integer [opcjonalny]

Długość wydzielonego podtekstu (domyślnie do końca tekstu wejściowego).

Wynik:

Tekst stanowiący część tekstu wejściowego.

// zwróci "ekst"
substring("tekst", 1)
 
// zwróci "ek"
substring("tekst", 1, 2)

matchesRegexp

Sprawdza, czy podany tekst jest zgodny z podanym wyrażeniem regularnym.

matchesRegex(text, regexp) : boolean

text : string

Sprawdzany tekst

regexp : string

Wyrażenie regularne które musi spełniać tekst.

Wynik:

True jeżeli podany tekst pasuje do podanego wyrażenia regularnego.

// spełnia
matchesRegexp("tekst", "t.*")
 
// nie spełnia
matchesRegexp("tekst", "t")

replace

Zamienia wszystkie wystąpienia podanego tekstu w tekście wejściowym.

replace(text, pattern, replacement) : string

text : string

Tekst wejściowy

pattern : string

Wzorzec

replacement : string

Zamiennik

Wynik:

Tekst z zamienionymi wszystkimi wystąpieniami wzorca w tekście wejściowym.

// zwraca "Dzisiaj jest 2016-01-01"
replace("Dzisiaj jest _data_",
"_data_", #currentDate())

Niewydane replaceDiacritics

replaceDiacritics(text) : string

text: string

Tekst wejściowy

Wynik:

Tekst z zamienionymi znakami diakrytycznymi na ich łacińskie odpowiedniki.

//Zestaw znaków diakrytycznych i ich łacińskie odpowiedniki 
	
	A: 'ÀÁÂÃÄÅĀĄ' 			a: 'àáâãäåāą'  
  	C: 'ÇĆČ' 				c: 'çćč' 
  	D: 'ĐĎ' 				d: 'đď'	
  	E: 'ÈÉÊËĚĒĘ' 			e: 'èéêëěēę'
  	I: 'ÌÍÎÏĪ' 				i: 'ìíîïī'	
  	L: 'Ł'  				l: 'ł'	
  	N: 'ÑŇŃ'  				n: 'ñňń'
  	O: 'ÒÓÔÕÕÖØŌ'  			o: 'òóôõöøō'
  	R: 'Ř'  				r: 'ř'	
  	S: 'ŠŚ'   				s: 'šś'	
  	T: 'Ť'  				t: 'ťŤ'
  	U: 'ÙÚÛÜŮŪ'  			u: 'ùúûüůū'
  	Y: 'ŸÝ'  				y: 'ÿý'	
  	Z: 'ŽŻŹ'  				z: 'žżź'

Niewydane replaceMany

replaceMany(originalString, replaceOptions, replaceFrom[], replaceTo) : string

originalString: string

Tekst wejściowy

replaceOptions: string

Zamień dla- lista wartości Systemu Windows, Systemu Linux, Wartości własnych.

replaceFrom[]: string[]

Zamień dla- parametr pojawia się w przypadku wyboru opcji "Wartości własnych" z parametru "Zamień dla".

replaceTo: string

Zamiennik.

Wynik:

Tekst z zamienionymi wartościami przekazanymi w parametrze replaceTo, w tekście wejściowym.

// zwraca "XbcXe"
replaceRegexp(":bc!e", "WINDOWS", "X")

Niedozwolone znaki dla nazw w systemie Windows- < > : " / | \ ? *

Niedozwolony znak dla nazw w systemie Linux- /

replaceRegexp

replaceRegexp(text, regex, replacement) : string

text : string

Tekst wejściowy

regex : string

Wyrażenie regularne

replacement : string

Zamiennik

Wynik:

Tekst z zamienionymi wszystkimi spełniającymi przekazane wyrażenie regularne wystąpieniami w tekście wejściowym.

// zwraca "XbcXe"
replaceRegexp("abcde", "[ad]", "X")

trim

Usuwa wszystkie białe znaki z początku i końca podanego tekstu.

trim(text) : string

text : string

Tekst wejściowy

Wynik:

Tekst wejściowy z usuniętymi białymi znakami z początku i końca

// zwraca "przykładowy tekst"
trim(" przykładowy tekst  ")

emptyString

emptyString() : string

Wynik:

Tekst w postaci: ""

// zwraca pusty łańcuch znaków
emptyString()

format

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

value : float/integer

Wartość liczbowa 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 tekstowej

// zwraca "9 999,1230"
format(9999.123, 4, ",", " ")

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

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

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

formatText

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

schema : string

Schemat, 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:

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

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

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

substringLast

substringLast(s, nChars) : string

s : string

Oryginalna wartość tekstowa.

nChars : integer

Ilość znaków.

Wynik:

Ciąg znaków o zdefiniowanej długości lub krótszy, jeżeli oryginalny ciąg jest krótszy niż pożądana liczba zwróconych znaków (wtedy funkcja zwraca oryginalny ciąg).

// zwraca cd
substringLast("abcd", 2)

// zwraca ab
substringLast("ab", 3)

length

length(text) : integer

text : string

Tekst

Wynik:

Długość tekstu

// zwraca 0
length(null)
length("")

// zwraca 11
length("text - text")

indexOf

Zwraca nr wystąpienia ciągu znaku w podanym tekście. Szuka od początku do końca podanego tekstu.

Gdy nie znajdzie zwraca -1;

Pierwsza pozycja w tekście ma index 0

indexOf(text,searchText) : integer

indexOf(text,searchText,start) : integer

text : string

Tekst do przeszukania

searchText : string

Szukany ciąg znaków

start : integer

Pozycja początkowa - pozycja w tekście od której ma zacząc przeszukiwać

Wynik:

Długość tekstu

// zwraca 7
indexOf("Ala ma kota, kot ma ale, i wszytko kończy się happy endem.","ko")
// zwraca 13
indexOf("Ala ma kota, kot ma ale, i wszytko kończy się happy endem.","ko",10)
 

lastIndexOf

Zwraca nr wystąpienia ciągu znaku w podanym tekście. Szuka od końca do początku podanego tekstu.

Gdy nie znajdzie zwraca -1;

Pierwsza pozycja w tekście ma index 0

lastIndexOf(text,searchText) : integer

lastIndexOf(text,searchText,start) : integer

text : string

Tekst do przeszukania

searchText : string

Szukany ciąg znaków

start : integer

Pozycja początkowa - pozycja w tekście od której ma zacząc przeszukiwać

Wynik:

Długość tekstu

// zwraca 35
lastIndexOf("Ala ma kota, kot ma ale, i wszytko kończy się happy endem.","ko")

// zwraca 7
lastIndexOf("Ala ma kota, kot ma ale, i wszytko kończy się happy endem.","ko",10)
 

split

Rozdziela tekst na tablice za pomocą podanego wzorca (tekst lub wyrażenie regularne)

split(text,regexp):string[]

text : string

Tekst wejściowy

regex : string

Wzorzec (wyrażenie regularne lub tekst)

// zwraca ["Ala ma kota" , "kot ma ale"]
split("Ala ma kota, kot ma ale",",")

// zwraca ["Ala" , "kota, kot" , "ale"]
split("Ala ma kota, kot ma ale","ma")
// zwraca ["Ala", "Ewa", "Marta"]
split("Ala12423423Ewa1234Marta","\d+")
 

newLine

Wstawia znak nowego wiersza

newLine() : string

Wynik:

Tekst w postaci: "\r\n"

// zwraca znak nowego wiersza
newLine()

abs

System Plusworkflow

abs(value) : integer|float

value : integer|float

Dowolna liczba

Wynik:

Wartość bezwzględna z podanej liczby

//zwraca 1.23
sum( -1.23 )

calc

System Plusworkflow

calc(num1, operator, num2) : integer|float

num1 : integer|float

Dowolna liczba

operator : string

Operator:

• +: dodawanie
• -: odejmowanie
• *: mnożenie
• /: dzielenie

num2 : integer|float

Dowolna liczba

Wynik:

Wynik działania zgodny z podanym operatorem

// dodawanie
expr( 2, '+', 2 )
// odejmowanie
expr( 2, '-', 2 )
// mnożenie
expr( 2, '*', 2 )
// dzielenie
expr( 2, '/', 2 )

le

System Plusworkflow

le(num1, num2) : boolean

num1 : integer|float

Dowolna liczba

num2 : integer|float

Dowolna liczba

Wynik:

True jeżeli liczba num1 jest mniejsza od lub równa liczbie num2.

// 'false'
le(11, 10)
// 'true'
le(10, 10)
// 'true'
le(9, 10)

lt

System Plusworkflow

lt(num1, num2) : boolean

num1 : integer|float

Dowolna liczba

num2 : integer|float

Dowolna liczba

Wynik:

True jeżeli liczba num1 jest mniejsza od liczby num2.

// 'false'
lt(11, 10)
// 'false'
lt(10, 10)
// 'true'
lt(9, 10)

ge

System Plusworkflow

ge(num1, num2) : boolean

num1 : integer|float

Dowolna liczba

num2 : integer|float

Dowolna liczba

Wynik:

True jeżeli liczba num1 jest większa od lub równa liczbie num2.

// 'true'
ge(11, 10)
// 'true'
ge(10, 10)
// 'false'
ge(9, 10)

gt

System Plusworkflow

gt(num1, num2) : boolean

num1 : integer|float

Dowolna liczba

num2 : integer|float

Dowolna liczba

Wynik:

True jeżeli liczba num1 jest większa od liczby num2.

// 'true'
gt(11, 10)
// 'false'
gt(10, 10)
// 'false'
gt(9, 10)

ceil

System Plusworkflow

ceil(value) : integer

value : float

Zaokrąglana liczba

Wynik:

Najmniejsza liczba całkowita większa lub równa podanej liczbie.

//zwraca 3
ceil( 3 )
ceil( 2.11 )

floor

System Plusworkflow

floor(value) : integer

value : float

Zaokrąglana liczba

Wynik:

Najmniejsza liczba całkowita mniejsza od lub równa podanej liczbie.

//zwraca 2
ceil( 2 )
ceil( 2.65 )

round

System Plusworkflow

round(value, [places]) : float

value : float

Zaokrąglana liczba

places : integer [opcjonalny]

Liczba miejsc po przecinku do których zaokrąglamy. Domyślnie zaokrąglanie do części całkowitej (0) .

Wynik:

Liczba zaokrąglona do podanej liczby miejsc po przecinku

//zwraca 12
round( 12.236 )
 
//zwraca 12.24
round( 12.236, 2 )

min

System Plusworkflow

min(numbers) : integer|float

numbers : integer[]|float[]

Tablica liczb

Wynik:

Zwraca najmniejszą z podanych liczb.

//zwraca 1
min( [1, 10, 5] )

max

System Plusworkflow

max(numbers) : integer|float

numbers : integer[]|float[]

Tablica liczb

Wynik:

Zwraca największą z podanych liczb.

//zwraca 10
min( [1, 10, 5] )

sum

System Plusworkflow

sum(numbers) : float

numbers : integer[]|float[]

Tablica liczb

Wynik:

Zwraca sumę wszystkich podanych liczb.

//zwraca 6
sum( [1, 10, -5] )

anyLe

System Plusworkflow

anyLe(num1[], num2) : boolean

num1[] : integer|float

Dowolna tabela liczb

num2 : integer|float

Liczba tego samego typu co liczby w tabeli num1

Wynik:

True jeżeli jakakolwiek liczba z num1 jest mniejsza lub równa liczbie num2.

// zwraca true
anyLe([1,2,3],1)
anyLe([0,2,3],1)

// zwraca false
anyLe([2,2,3],1)

anyLt

System Plusworkflow

anyLt(num1[], num2) : boolean

num1[] : integer|float

Dowolna tabela liczb

num2 : integer|float

Liczba tego samego typu co liczby w tabeli num1

Wynik:

True jeżeli jakakolwiek liczba z num1 jest mniejsza od num2.

// zwraca true
anyLt([0,2,3],1)

// zwraca false
anyLt([1,2,3],1)
anyLt([2,2,3],1)

anyGe

System Plusworkflow

anyGe(num1[], num2) : boolean

num1[] : integer|float

Dowolna tabela liczb

num2 : integer|float

Liczba tego samego typu co liczby w tabeli num1

Wynik:

True jeżeli jakakolwiek liczba z num1 jest większa lub równa liczbie num2.

// zwraca true
anyGe([1,2,3],1)
anyGe([2,2,3],1)

// zwraca false
anyLt([0,0,-1],1)

anyGt

System Plusworkflow

anyGt(num1[], num2) : boolean

num1[] : integer|float

Dowolna tabela liczb

num2 : integer|float

Liczba tego samego typu co liczby w tabeli num1

Wynik:

True jeżeli jakakolwiek liczba z num1 jest większa od num2.

// zwraca true
anyLt([1,0,3],1)
// zwraca false
anyLt([1,0,1],1)
anyLt([0,0,-2],1)

not

System Plusworkflow

not(value) : boolean

value :boolean

Wartość logiczna

Wynik:

Zwraca negację przekazanej wartości.

//zwraca false
not( true )

and

System Plusworkflow

and(values) : boolean

values :boolean[])

Tablica wartości logicznych

Wynik:

Zwraca iloczyn logiczny wszystkich przekazanych wartości

//zwraca true
and( true, true )
 
//zwraca false
and( false, true )
 
//zwraca false
and( false, false )

or

System Plusworkflow

or(values) : boolean

values (boolean[])

Tablica wartości logicznych

Wynik:

Zwraca sumę logiczną wszystkich przekazanych wartości

//zwraca true
or( true, true )
 
//zwraca true
or( false, true )
 
//zwraca false
or( false, false )

currentYear

currentYear() : integer

Wynik: 

Pełny rok, np. 2017.

calculateDaysDifference

Oblicza różnicę w dniach między dwoma datami.

calculateDaysDifference() : integer

firstDate : date

Data pierwsza.

secondDate : date

Data druga.

includeFreeDays : boolean

Uwzględnienie dni wolnych. Jeśli uwzględnimy dni wolne, różnica będzie większa o liczbę dni wolnych wypadających między datami (uwzględniając te daty).

Funkcja ta bierze pod uwagę systemowy parametr "CustomHolidays" . Parametr ten zawiera listę dodatkowych dni wolnych oddzielonych średnikiem ( ; ). Daty mogą być wpisane w formie pełnej (2018-05-02) lub skróconej (05-02). np: 2018-05-02;05-04 

Wynik:

Ilość dni wynikająca z obustronnie domkniętego przedziału wyznaczanego przez dwie daty. Jako że przedział jest domknięty obustronnie, w przypadku podania dwóch sąsiednich dni spełniających kryterium, funkcja zwróci wartość 2.

calculateTimeDifference

calculateDaysDifference() : integer

Pierwsza data(firstDate) : datetime

Data pierwsza.

Druga data (secondDate) : datetime

Data druga.

Uwzględnij dni wolne(includeFreeDays) : boolean

Uwzględnienie dni wolnych. Jeśli uwzględnimy dni wolne, różnica będzie większa o liczbę dni wolnych wypadających między datami (uwzględniając te daty).

Uwzględnij zmianę czasu(timeShift): boolean

Uwzględnia w obliczeniach zmianę czasu z zimowego na letni i odwrotnie

Typ zwracanych danych(returnType) : String (Lista wyboru)

Typ zwracanych danych. Określa w jakiej jednostce czasu zwracany jest wynik [Sekundy, Minuty, Godziny, Miesiące, Tygodnie, Lata]

Funkcja ta bierze pod uwagę systemowy parametr "CustomHolidays" . Parametr ten zawiera listę dodatkowych dni wolnych oddzielonych średnikiem ( ; ). Daty mogą być wpisane w formie pełnej (2018-05-02) lub skróconej (05-02). np: 2018-05-02;05-04. 

Wynik:

Ilość czasu zwracanego między dwoma datami. W zależności od typu zwracanego, reprezentacja jest w innych jednostkach czasu np.

dla 2020-05-01 10:00:30 i 2020-06-01 10:00:30 z uwzględnieniem dni wolnych i zmiany czasu. Wyniki dla poszczególnych jednostek czasu

calcDateWorkingDays

calcDateWorkDays(date, workingDays) : date

date : date

Data wejściowa

workingDays : integer

Dni robocze

Wynik:

Obliczona data

// data początkowa:
 
//zwraca 2020-01-09
calcDateWorkingDays(2019-12-06, 20);
 
//zwraca 2019-12-18
calcDateWorkingDays(2019-12-27, -5);
 
//zwraca 2019-12-23
calcDateWorkingDays(2019-12-25, -1);

currentDate

currentDate() : date

Wynik:

Aktualna data.

//zwraca aktualną datę
//np. 2016-01-01
currentDate()

currentDateTime

currentDateTime() : datetime

Wynik:

Aktualna data wraz z czasem.

//zwraca aktualną datę z czasem
//np. 2016-01-01 12:30:45
currentDateTime()

formatDate

Formatuje podaną datę do postaci tekstowej zgodnie z podanym formatem.

formatDate(date, format) : string

date : date|datetime

Formatowana data

format : string

Format daty. Dostępne są formaty wbudowane:

• datetime np. 2015-12-31 12:33:44
• date np. 2015-12-31
• time np. 12:33:44
• year np. 1991
• month np. 06
• day np. 12

Wynik:

Aktualna data wraz z czasem.

// 2015-12-31 12:33:44
 
//zwraca "2015-12-31"
formatDate(#currentDateTime(), "date")

calcDate

Oblicza datę na podstawie przekazanych parametrów. Umożliwia dodawanie/odejmowanie od podanej daty lat, miesięcy, dni etc.

calcDate(date, interval, unit) : date

date : date

Data bazowa

interval : integer

Okres czasu który zostanie dodany/odjęty od podanej daty

unit : string

Jednostka czasu, jedna z:

• y lub year - rok
• m lub month - miesiąc
• w lub week - tydzień
• d lub day - dzień

Wynik:

Obliczona data

// 2015-12-31
 
//zwraca 2015-12-32
calcDate(#currentDate(), 1, "day");
 
//zwraca 2014-12-32
calcDate(#currentDate(), -1, "y");

calcDateTime

calcDateTime(date, interval, unit) : datetime

date : datetime

Data bazowa

interval : integer

Okres czasu który zostanie dodany/odjęty od podanej daty

unit : string

Jednostka czasu, jedna z:

• y lub year - rok
• m lub month - miesiąc
• w lub week - tydzień
• d lub day - dzień
• h lub hour - godzina
• i lub minute - minuta
• s lub second - sekunda

Wynik:

Obliczona data

// 2015-12-31 12:33:44
 
//zwraca 2015-12-32 12:33:44
calcDate(#currentDateTime(), 1, "day");
 
//zwraca 2014-12-32 12:33:44
calcDate(#currentDateTime(), -1, "y");

le

le(date1, date2) : boolean

date1 : date/datetime

Pierwsza data do porównania

date2 : date/datetime

Druga data do porównania

Wynik:

Prawda lub fałsz

// data1 to obiekt LocalDate o wartości "2016-12-24"
// data2 to obiekt LocalDate o wartości "2016-12-24"
// zwraca true
le(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDate o wartości "2016-12-24T12:35:22"
// zwraca true
le(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDate o wartości "2016-12-24T12:35:23"
// zwraca true
le(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDate o wartości "2016-12-24T12:35:21"
// zwraca false
le(data1, data2)

lt

lt(date1, date2) : boolean

date1 : date/datetime

Pierwsza data do porównania

date2 : date/datetime

Druga data do porównania

Wynik:

Prawda lub fałsz

// data1 to obiekt LocalDate o wartości "2016-12-24"
// data2 to obiekt LocalDate o wartości "2016-12-24"
// zwraca false
lt(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// zwraca false
lt(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:23"
// zwraca true
lt(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:21"
// zwraca false
lt(data1, data2)

ge

ge(date1, date2) : boolean

date1 : date/datetime

Pierwsza data do porównania

date2 : date/datetime

Druga data do porównania

Wynik:

Prawda lub fałsz

// data1 to obiekt LocalDate o wartości "2016-12-24"
// data2 to obiekt LocalDate o wartości "2016-12-24"
// zwraca true
ge(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// zwraca true
ge(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:23"
// zwraca false
ge(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:21"
// zwraca true
ge(data1, data2)

gt

gt(date1, date2) : boolean

date1 : date/datetime

Pierwsza data do porównania

date2 : date/datetime

Druga data do porównania

Wynik:

Prawda lub fałsz

// data1 to obiekt LocalDate o wartości "2016-12-24"
// data2 to obiekt LocalDate o wartości "2016-12-24"
// zwraca false
gt(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// zwraca false
gt(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:23"
// zwraca false
gt(data1, data2)

// data1 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:21"
// zwraca true
gt(data1, data2)

anyLe

anyLe(dates[], date2) : boolean

dates[] : date/datetime

Tablica dat do porównania

date2 : date/datetime

Druga data do porównania

Wynik:

Prawda lub fałsz

// dates to obiekt LocalDate o wartości ["2016-12-25", "2016-12-26"]
// data2 to obiekt LocalDate o wartości "2016-12-24"
// zwraca false
anyLe(dates, data2)
 
// dates to obiekt LocalDateTime o wartości ["2016-12-25T12:35:22", "2016-12-26T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// zwraca false
anyLe(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-24T12:35:22", "2016-12-26T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:23"
// zwraca true
anyLe(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-23T12:35:22", "2016-12-26T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:21"
// zwraca true
anyLe(dates, data2)

anyLt

anyLt(dates[], date2) : boolean

dates[] : date/datetime

Tablica dat do porównania

date2 : date/datetime

Druga data do porównania

Wynik:

Prawda lub fałsz

// dates to obiekt LocalDate o wartości ["2016-12-25", "2016-12-26"]
// data2 to obiekt LocalDate o wartości "2016-12-24"
// zwraca false
anyLt(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-25T12:35:22", "2016-12-26T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// zwraca false
anyLt(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-23T12:35:22", "2016-12-26T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:21"
// zwraca true
anyLt(dates, data2)

anyGe

anyGe(dates[], date2) : boolean

dates[] : date/datetime

Tablica dat do porównania

date2 : date/datetime

Druga data do porównania

Wynik:

Prawda lub fałsz

// dates to obiekt LocalDate o wartości ["2016-12-22", "2016-12-23"]
// data2 to obiekt LocalDate o wartości "2016-12-24"
// zwraca false
anyGe(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-22T12:35:22", "2016-12-23T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// zwraca false
anyGe(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-22T12:35:22", "2016-12-24T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:23"
// zwraca true
anyGe(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-22T12:35:22", "2016-12-26T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:21"
// zwraca true
anyGe(dates, data2)

anyGt

anyGt(dates[], date2) : boolean

dates[] : date/datetime

Tablica dat do porównania

date2 : date/datetime

Druga data do porównania

Wynik:

Prawda lub fałsz

// dates to obiekt LocalDate o wartości ["2016-12-22", "2016-12-23"]
// data2 to obiekt LocalDate o wartości "2016-12-24"
// zwraca false
anyGt(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-22T12:35:22", "2016-12-23T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:22"
// zwraca false
anyGt(dates, data2)

// dates to obiekt LocalDateTime o wartości ["2016-12-23T12:35:22", "2016-12-26T12:35:22"]
// data2 to obiekt LocalDateTime o wartości "2016-12-24T12:35:21"
// zwraca true
anyGt(dates, data2)

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 emptyArray, 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

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)

Niewydane getSelectedRowNo

getSelectedRowNo(tableId) : integer

tableId: string

Tekst wejściowy

Wynik:

Liczba całkowita

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

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()

Niewydane getFullName

getFullName(userName) : string

userName : string

Login użytkownika

Wynik:

Wartość tekstowa.

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

Niewydane getFullNames

getFullNames(userNames) : string[]

userNames : string[]

Loginy użytkowników

Wynik:

Tablica wartości tekstowych.

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

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, ou) : string[]

roleId (string)

Rola

ou (string)

Jednostka organizacyjna (symbol)

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

numberOfDocumentsFromCurrentProcess

Tylko komponenty serwerowe

numberOfDocuments() : integer

Wynik:

Liczba dokumentów

numberOfDocumentsFromCurrentProcess

Tylko komponenty serwerowe

numberOfDocuments(className) : integer

className : string

Nazwa klasy dokumentów

Wynik:

Liczba dokumentów

generateUniqueCode

Wszystkie komponenty

generateUniqueCode() : string

Wynik:

Tekst zawierający kod alfanumeryczny, np. oYWz3wVp1pj

groupBy

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

Szczegółowy opis funkcji.

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

Wynik:

Obiekt TableStore.

toJsonObject

Wszystkie komponenty

Generuje ciąg tekstowy JSON w postaci obiektu.

Szczegółowy opis

toJsonObject(keys, values, types) : string

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

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 

Wynik:

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