Výrazy v definicích procesů

funkce	popis, příklad
`now()`	vrací aktuální datum a čas
`today()`	vrací aktuální datum
`withLastDayOfMonth(LocalDate date)`	vrací zadaný datum upravený na poslední den v daném měsíci
`formatDate(LocalDate date)`	vrací zadaný datum ve formátu 'den.mesic.rok' `formatDate(today())`
`formatDate(LocalDate date, String format)`	vrací zadaný datum dle zadaného formátu `formatDate(today(), 'yyyy-MM-dd')`
`formatDateTime(LocalDate date)`	vrací zadaný datum ve formátu 'dd.MM.yyyy HH:mm' `formatDateTime(now())`
`formatDateTime(LocalDate date, String format)`	vrací zadaný datum dle zadaného formátu `formatDate(today(), 'yyyy-MM-dd HH:mm:ss')`
`parseDate(String date)`	vrací datum (LocalDate) dle zadaného řetězce
`parseTime(String time)`	vrací čas (LocalTime) dle zadaného řetězce
`parseDateTime(String dateTime)`	vrací datum a čas (LocalDateTime) dle zadaného řetězce
`formatNumber(double value)`	vrací zadané číslo formátované dle národních zvyklostí
`formatCurrency(double value)`	vrací zadané číslo formátované dle národních zvyklostí pro měnu (zaokrouhlení)
`listOf(...)`	vrací seznam ze zadaných hodnot
`sum(List<?> seznam)`	vrací součet hodnot seznamu např. `sum(listOf(1,2,3))` vrátí `6`
`min(List<?> seznam)`	vrací nejmenší hodnotu v seznamu
`max(List<?> seznam)`	vrací největší hodnotu v seznamu
`filter(List<?> seznam, Closure filter)`	filtruje seznam pomoci zadané funkce např. `filter(listOf(1,2,3,4,5), (item) -> { item > 2 })` vrátí list `{3,4,5}`
`select(List<?> seznam, Closure mapper)`	mapuje seznam objektů na jiné objekty dle dané funkce např. `select(listOf(1,2,3), (item) -> { 'ID:' + item })` vrátí list `{'ID:1', 'ID:2', 'ID:3'}`
`filterSelect(List<?> seznam, Closure filter, Closure mapper)` `selectFilter(List<?> seznam, Closure mapper, Closure filter)`	analogicky k funkcím `filter`/`select` s tím, že se v jednom volání použijí oba postupy, jen v příslušném pořadí
`parseLong(String number)` `parseDouble(String number)`	vrací číselnou hodnotu dle zadaného řetězce, nebo null pokud nejde převést na číslo
`round2(double value)`	zaokrouhlí na dvě desetinná místa
`round(double value, int scale)`	zaokrouhlí na zadaný počet desetinných míst
`roundToInt(double value)`	zaokrouhlí na celé číslo
`isNotBlank(String parameter)`	vrací logickou hodnotu (true/false) pro test, zda je `parametr` prázdný
`defaultIfBlank(String parameter)`	vrací parameter, nebo prázdný řetězec, pokud je parameter null
`defaultIfBlank(String parameter, String default)`	vrací parameter, nebo zadaný výchozí řetězec, pokud je parameter null
`join(List<?> list)`	vrací řetězec tvořený spojením jednotlivých položek seznamu (oddělovač je čárka)
`join(List<?> list, String oddelovac)`	vrací řetězec tvořený spojením jednotlivých položek seznamu, se zadaným oddělovačem
`capitalize(String parameter)`	vrací zadaný řetězec s velkým prvním písmenem ('ahoj' -> 'Ahoj')
`getEnumLabel(String enumId, String code)`	vrací popisek zadaného enum dle jeho kódu ve výchozím jazyce
`getEnumLabel(String enumId, String code, int languageId)`	vrací popisek zadaného enum dle jeho kódu v jazyce podle zvoleného id
`findState(String nazevEntity, String kod)`	vrací stav (EntityState) pro zadaný název entity a kód stavu
`findCountryById(long countryId)`	vrací zemi (Country) pro zadané id `findCountryById(1).name`
`findEntityById(String entityName, long id)`	vrací entitu typu `entityName` pro zadané id, pokud nenajde hodí chybu `findEntityById('Company',1)`
`findEntityByIdIfPresent(String entityName, long id)`	vrací entitu typu `entityName` pro zadané id, pokud nenajde vrací null `findEntityById('Company',1)`
`findEntityByIdIfPresent(@NotNull String entityName, String id)`	vrací entitu typu `entityName` pro zadané id typu String, pokud nenajde vrací null `findEntityByIdIfPresent('Currency', 'CZK')`
`findEntitiesByFieldIfPresent(String entityName, String fieldName, Object value)`	vrací entitu typu `entityName`. Zadanou hodnotu `value` hledá v políčku `fieldName` . Pokud nenajde, vrací prázdnou kolekci `findEntitiesByFieldIfPresent('Goods','code','SAMPLE-code')`
`findEntitiesByFieldIfPresent(String entityName, String fieldName, Collection<?> value)`	vrací entitu typu `entityName`. Zadanou hodnotu `value` hledá v políčku `fieldName` . Pokud nenajde, vrací prázdnou kolekci `findEntitiesByFieldIfPresent('Goods','code',listOf('SAMPLE-code-1','SAMPLE-code-2'))`
`findEntitiesByFieldsIfPresent(String entityName, Map<String, Object>)`	vrací entitu typu `entityName`. Hledá podle zadané mapy klíč (`fieldName`) hodnota (`value`). Jednotlivé položky v mapě se přádávají jako podmínky hledání spojené výrazem AND. Pokud nenajde, vrací prázdnou kolekci `findEntitiesByFieldsIfPresent('Goods', {'code':listOf('SAMPLE-code-1','SAMPLE-code-2'), 'parameterA': 10})`
`generatePdfDocument(long documentId, long entityId)`	vygeneruje a uloží PDF pro dané parametry
`createNew(String nazevEntity)`	vytvoří novou entitu dle zadaného jména
`persist(BaseModel entita)` `persistInAccountingUnit(BaseModel entita, AccountingUnit unit)`	vynutí uložení entity, nutné např. při změnách cen položek objednávky, aby proběhl správně přepočet hodnot, lze specifikovat v jaké účetní jednotce má uložení proběhnout
`persistSilently(BaseModel entita)` `persistSilentlyInAccountingUnit(BaseModel entita, AccountingUnit unit)`	vynutí uložení entity, např. při vytvoření nové, kdy následně potřebujeme získat její Id, lze specifikovat v jaké účetní jednotce má uložení proběhnout
`buildFreeAttributes(FreeAttributes source)` `buildFreeAttributes(Map<String, Object> source)`	vytvoří nový objekt volných atributů, pokud je source null, bude prázdný, jinak zkopíruje FA ze zdrojového objektu
`copyValues(FreeAttributes source, FreeAttributes target)`	kopíruje volné atributy ze zdrojového do cílového objektu
`copyMatchingFields(FreeAttributes source, BaseModel targetEntity)`	kopíruje hodnoty volných atributů (source) do políček cílového objektu (targetEntity)
`setFieldValue(List<BaseModel> list, String fieldName, Object value)`	u všech položek v seznamu nastaví určené pole na zadanou hodnotu
`setFieldValueByExpression(List<BaseModel> list, String expression)`	u všech položek v seznamu provede zadaný výraz položka je ve výrazu dostupná přes proměnnou `item`
`getDefaultValue(String entityName, String fieldName)`	vrací výchozí hodnotu políčka z nastavení entity
`getTableValueByKeyInColumn(Table table, int keyColumn, String keyValue, int columnKey)`	vrátí ze zadané tabulky hodnotu ve sloupci `columnKey`, řádek dohledá dle zadané hodnoty `keyValue` ve sloupci `keyColumn`. Používá se, pokud načtený CSV soubor obsahuje sloupec, který se dá použít pro vyhledání. Pro získání hodnoty čistě dle číselných indexů se použije interní funkce tabulky, např. `context['tabulka'].get(řádek,sloupec)`
`informUser(String message)` `informUser(String message, Long personId)` `warnUser(String message)` `warnUser(String message, Long personId)` `informUserError(String message)` `informUserError(String message, Long personId)` `informUserSuccess(String message)` `informUserSuccess(String message, Long personId)`	pošle informativní zprávu uživateli Pokud není specifikován, je poslána aktuálnímu přihlášenému uživateli který spustil proces. Typ zprávy (warn, error, suceess) určuje barvu zprávy (oranžová, červená, zelená)

funkce	popis, příklad
`accounting.uploadBankStatements(String format, List<String> fileUrls)` `accounting.uploadBankStatements(String format, List<String> fileUrls, Long accountingUnitId)`	nahraje a zprocesuje bankovní výpis (alternativa k UI funkci). Jako třetí parametr jde zadat účetní jednotku pro kterou se má metoda spustit. Užitečné v případě automatizovaného procesu.

funkce	popis, příklad
`czech.isMale(jmeno)`	test zda se jedná o mužské jméno
`czech.vokativ(jmeno)`	vrací 5. pád (oslovujeme/voláme) zadaného jména (Zdeněk -> Zdeňku)
`czech.vokativ(jmeno,isWoman,isLastName)`	vrací 5. pád zadaného jména, se specifikací zda se jedná o ženu a případně její příjmení

funkce	popis, příklad
`files.pathOf(String ...)`	vrací Path, složenou z více řetězců např. `files.pathOf('/home/uzivatel','data','soubor.txt')` vrátí cestu /home/uzivatel/data/soubor.txt
`files.compressFiles(String filename, List<Path> files)`	seznam souborů `files` zkomprimuje do ZIP souboru `filename`
`files.extractArchiveFile(Attachment priloha)`	vrací adresář (Path), kde je rozbalený obsah zadané přílohy
`files.deleteTempDirectory(Path tempDir)`	smaže zadanou cestu (musí být vytvořena předchozím voláním metody `extractArchiveFile`)
`files.listFilesInDirectory(String cesta, boolean recursive)` `files.listFilesInDirectory(Path cesta, boolean recursive)`	vrátí seznam souboru v zadaném adresáři
`files.listDirsInDirectory(String cesta, boolean recursive)` `files.listDirsInDirectory(Path cesta, boolean recursive)`	vrátí seznam adresářů v zadaném adresáři
`files.uploadFile(Path path)` `files.uploadTemporaryFile(Path path)`	uloží zadaný soubor do storage složky, vrací UploadedFile. V případě dočasného souboru bude tento vymazán při příštím startu aplikace.
`files.addAttachmentsToEntity(BaseModel entity, List<Path> files)`	přidá zadaný seznam souborů k entitě jako přílohy (pokud je daná entita podporuje) Pozor! Udělá kopii souboru do storage složky aplikace. Pokud už zadané url ve storage složce je tak vytvoří duplicitu!
`files.createAttachment(String entityName, String name, String url)` `files.createAttachment(String entityName, Multilingual name, String url)`	vytvoří novou přílohu se zadaným jménem a url. Url se nekopíruje do storage složky, ale použije se tak jak je zadané. Přílohu je pak třeba přidat k přílohám cílové entity. např. `entity.getAttachments().add(files.createAttachment('OpportunityAttachment', 'název', 'storage/cesta/k/priloze.txt'));` Lze takto přidat přílohu, která odkazuje na externí službu (např. www odkaz)
`files.parseCSV(Path soubor)` `files.parseCSV(Path soubor, char separator)` `files.parseCSV(Path soubor,char separator, String charset)`	parsuje zadaný soubor a vrátí tabulku vytvořenou z dat v souboru výchozí oddělovač je čárka a znaková sada UTF-8 vrácená tabulka je pouze v paměti, řádky a sloupce jsou indexovány číselně (Integer, od 0) a hodnoty jsou řetězce (String) viz pomocná funkce `getTableValueByKeyInColumn`
`files.parseExcel(Path soubor, String sheetName)`	parsuje zadaný soubor a vrátí tabulku načtenou ze zadaného listu v dokumentu Excel vrácená tabulka je pouze v paměti, řádky a sloupce jsou indexovány číselně (Integer, od 0) a hodnoty jsou řetězce (String) viz pomocná funkce `getTableValueByKeyInColumn`
`files.saveCSV(Path soubor, String separator, String charset, List<Map<String, Object>> data)`	uloží data do CSV souboru
`files.saveText(Path soubor, String text)` `files.saveText(Path soubor, String text, String charset)`	zapíše obsah proměnné `text` so souboru. Lze určit znakovou sadu (výchozí je UTF-8)
`files.createTempFile(String prefix, String suffix)`	vytvoří pracovní soubor v dočasném adresáři (po restartu aplikace bude smazán). Vrací cestu k novému souboru.

funkce	popis, příklad
`hr.findPersonContract(person)`	vrací pracovní smlouvu pro zadanou osobu `hr.findPersonContract(entity.createdBy)`
`hr.findNextOrEqualWorkingDay(date)`	vrací zadaný datum pokud je pracovním dnem, případně další následující pracovní den `hr.findNextOrEquealWorkingDay(today())`
`hr.findPersonByIdIfWorking(personId)`	vrací osobu, pokud pracuje (je v práci nebo na home office)

funkce	popis, příklad
`planning.createProjectFromTemplate(long templateId, String code, Multilingual name, LocalDate startAt)`	vytvoří a vrátí nový projekt dle zadané šablony

funkce	popis, příklad
`prod.releaseBatch(id)`	uvolní dávku do výroby (jako parametr očekává id dávky)
`prod.findSupply(goodsId,stockId,batchId)`	vrátí dostupnou zásobu pro výrobu
`prod.reloadAndFinishBatch(BatchEntity batch,List<UsedSupply>)`	dokončí výrobní dávku
`prod.findBatchesByRootBatchId(long batchId)`	najde skladové dávky vytvořené ze zadané výrobní dávky
`prod.findScheduledJobs(Long salesOrderId, Long goodsId, Long stageId)`	najde aktuálně naplánované úkoly dle parametrů jednotlivé parametry funkce můžou být `null`

funkce	popis, příklad
`queryService.queryString()` `queryService.queryString(String url)` `queryService.queryString(String url, String location)`	použití převážne pro šablony dokumentů, vrací kombinaci location + url v případě nezadání location, nebo varianta bez parametrů, vrací `http://localhost:<port>` např. `queryService.queryString('storage/123/obrazek.png')` vrátí 'http://localhost:8080/storage/123/obrazek.png'
`queryService.createQueryRequest()`	vytvoří dotazovací požadavek
`queryService.createColumnFilter()` `queryService.createColumnFilter(String operator, Object value)`	vytvoří filtr pro dotazovací požadavek
`queryService.createQueryExternalParameters()`	vytvoří objekt pro dotazovací požadavek
`queryService.remoteQuery(String url, String securityToken, QueryRequest request)` `queryService.remoteQuery(String url, String securityToken, String request)`	spustí vzdálený dotaz, vrací seznam příklad
`query(String sql)`	spustí SQL dotaz v lokálním prostředí, vrací List<Map<String, Object> (reprezentace výsledné tabulky)
`query(String entityName, QueryRequest request)`	spustí dotaz v lokálním prostředí, dle zadaných vyhledávacích parametrů. Vrací seznam entit, nebo prázdný list.

funkce	popis, příklad
`reportingService.loadReportData(long reportId)` `reportingService.loadReportData(String secretUid, String param)`	vrací data reportu ve formátu List<Map<String, Object>>
`reportingService.saveReportAsCSV(long reportId, Path filePath)`	uloží data reportu do zadaného souboru (viz. files.pathOf()))

funkce	popis, příklad
`.with(funkce)`	`with` obaluje argument pro filtrování, `.filter(with(funkce))`
`.to(funkce)`, `.as(funkce)`	`to` a `as` jsou stejné funkce s jiným názvem, používají se pro mapování prvků z jednoho typu na další, `.map(to(funkce))`, (také použito pro `Collectors.toMap`)
`filter(kolekce, funkce)`	zafiltruje danou kolekci podle `funkce`, která vrací boolean
`.comparator(funkce)`	seřadí kolekci pomocí zadané funkce. Porovnávací funkce musí vracet záporné číslo (první objekt je menší než druhý, 0 pokud jsou stejné, nebo kladné číslo, pokud je první objekt větší než druhý, viz: ukázka logiky: `comparator( (item1, item2) -> { if (item1 < item2) { return -1; } else if (item1 > item2) { return 1; } else { return 0; } )`

Typ	Operátory
aritmetické	+, -, *, /, %, ^, div, mod
relační	<, >, ==, !=, <=, >=, lt, gt, eq, ne, le, ge
logické	and, or, not, &&, \|\|, !
podmíněné	?:
regulární	=~ , !~

klíčové slovo	popis
`if (podmínka) {` `..` `} else if (podmínka2) {` `..` `} else {` `..` `}`	v případě že podmínka `if` vyhoví (`true`), provedou se příkazy zadané mezi závorkami pokud prvotní podmínka v `if` není splněna, následující `else if` se postupně vyhodnocují (může jich být libovolný počet), dokud se nenajde podmínka, která vyhoví pokud ani jedna podmínka nebyla vyhodnocena a je přítomný `else` příkaz, spustí se kód v `else` větvi jak `else if` tak `else` jsou libovolné, tj. mohou a nemusí být přítomny, počet `else if` je libovolný, avšask `else` může být jen jeden a musí být poslední (tj. za `if` nebo `else if`)
`for (var item : list) {}`	iteruje zadaný seznam a provádí blok příkazů mezi závorkami aktuální iterovaná položka je dostupná v proměnné `item` `break;` ukončí běh cyklu
`return null;`	ukončí běh skriptu


`$$ for (var item : list) {` ... `$$}`	celá řádka je JEXL výraz, lze začít if/for a ukončit na jiné řádce
`${entity.name}`	obsah závorek je výraz

¶ Jazyk

¶ Změny oproti předchozímu jazyku

¶ Specifické funkce

¶ Proměnné

¶ Základní Api funkce

¶ Accounting Api

¶ Czech Api

¶ Files Api

¶ HR Api

¶ Planning Api

¶ Prod Api

¶ QueryService Api

¶ Reporting Api

¶ Filtrování kolekcí / Java stream Api

¶ Příklady výrazů

¶ Nastavení typu zboží

¶ Nastavení cílového skladu

¶ Vytvoření nákupního ceníku a nastavení dodavatele

¶ Test hodnoty volného atributu

¶ Příklad rekurzivní funkce

¶ Výrazy pro definici procesu "Schválení nepřítomnosti"

¶ QueryService Api

¶ Stream Api

¶ if/for

¶ Výrazy v definicích procesů

¶ Operátory

¶ Aritmetické operátory

¶ Relační operátory

¶ Logické a podmíněné operátory

¶ Regulární výrazy

¶ Přístup k seznamům a mapám

¶ Operátor bezpečné navigace

¶ Komentáře ve skriptu

¶ Řídící struktury ve skriptech

¶ JxltTemplate