Výpočty na úkolu

Záložka Výpočty v editoru úkolu obsahuje skripty, které běží na serveru v určitých okamžicích života úkolu: při spuštění, na konci, při přepočítání, ručně a před převzetím. Výpočty čtou a zapisují proměnné případu, mění údaje úkolu a volají funkce systému. Záložku má každý typ úkolu. U automatického úkolu je výpočet jeho jedinou prací. Číslo u záložky ukazuje počet sekcí výpočtů.

Tento článek popisuje, jak se výpočty na úkolu nastavují a kdy běží. Funkce, které ve výpočtech můžete volat, popisuje sekce Výpočty a skripty.

Č.PrvekK čemu slouží
1VšechnyZobrazí všechny sekce výpočtů. Číslo v závorce je jejich počet.
2Aktivní sekce výpočtůZobrazí jen sekce, které mají zaškrtnutý aspoň jeden okamžik spuštění.
3Neaktivní sekce výpočtůZobrazí jen sekce, které se nespouštějí.
4Vytvořit proměnnouZaloží novou proměnnou šablony bez opuštění úkolu.
5Rozbalit vše / Sbalit všeRozbalí nebo sbalí všechny sekce.
6AktivníPřepínač sekce. Jde jen vypnout: vypnutím se zruší všechny okamžiky spuštění. Zapne se sám, když zaškrtnete některý okamžik.
7Při spuštěníVýpočet běží, když se úkol spustí.
8Na konciVýpočet běží, když se úkol splní.
9Při přepočítáníVýpočet běží, když řešitel v úkolu zvolí Přepočítat.
10RučněVýpočet běží, když uživatel otevře čekající úkol typu Událost v okně Událost případu.
11Před převzetímVýpočet běží těsně předtím, než se úkol nabídne k odběru.
12Sbalit / rozbalitSbalí nebo rozbalí tuto sekci.
13KopírovatVloží kopii sekce hned pod ni.
14OdebratSmaže sekci bez potvrzení. Změna se projeví po uložení úkolu.
15PřesunoutChycením za ikonu změníte pořadí sekce.
16Vložit proměnnouVloží do kódu na místo kurzoru výraz pro čtení proměnné šablony nebo systémové hodnoty úkolu a případu.
17SkriptySkripty výpočtů z administrace, které se k této sekci připojí. Jejich funkce pak můžete v kódu volat. Štítek skriptu otevře jeho detail.
18ZdrojKód výpočtu, jak ho napíšete.
19ES6 syntaxKód, který server z vašeho zdroje vygeneroval a který se skutečně spouští. Záložka je aktivní až po uložení.
20NápovědaOtevře nápovědu k výpočtům.
21Celá obrazovkaOtevře kód v okně Kód výpočtu přes celou obrazovku.
22Přidat sekci výpočtuPřidá novou sekci. Nová sekce je neaktivní, dokud nezaškrtnete okamžik spuštění.

Kdy výpočty běží

OkamžikKdy přesně
Při spuštěníKdyž se úkol aktivuje. U úkolu pro uživatele po určení řešitele. U upozornění e-mailem před odesláním e-mailu, takže výpočet může upravit hodnoty použité v e-mailu. U Smart Eventu až po jeho provedení, takže výpočet může zpracovat výsledek. U spuštění externí události před vyvoláním události. U podprocesu před založením podřízeného případu. U události, když začne čekat.
Na konciKdyž se úkol splní, u všech typů včetně automatických.
Při přepočítáníKdyž řešitel v nabídce Více úkolu zvolí Přepočítat. Formulář se nejdřív uloží. Položka je aktivní, jen když má úkol takový výpočet.
RučněKdyž uživatel v detailu případu otevře v okně Událost čekající úkol typu Událost, ještě před zobrazením jeho proměnných.
Před převzetímKdyž se úkol stává úkolem k odběru, před nabídnutím uživatelům a odesláním upozornění.

V rámci jednoho okamžiku běží sekce v pořadí, v jakém jsou na záložce. Když výpočet skončí chybou, akce, která ho spustila, se nedokončí a uživatel dostane chybové hlášení. Při ladění proto ukládejte a zkoušejte na zkušebním případu.

Kód a připojené skripty

Kód píšete do záložky Zdroj. Editor napovídá názvy proměnných šablony a funkce dostupných knihoven. Proměnné čtete a zapisujete přes objekt vars, například:

const dep = vars['departureDate'].getValue();
vars['travelAllowance'].setValue(days * 600);

Po uložení server ze zdroje vygeneruje kód na záložce ES6 syntax a ten se spouští. Kód připojených skriptů se vloží před kód sekce, takže jejich funkce jsou v sekci k dispozici.

Úprava v ES6 syntax přepíše zdroj
Záložku ES6 syntax můžete upravit. Editor se nejdřív zeptá a změnu povolí, až do potvrzovacího pole napíšete ES6. Po uložení pak upravený kód nahradí váš zdroj.

Pole Vložit proměnnou nabízí proměnné šablony a systémové hodnoty úkolu a případu, například název a komentář úkolu, termín, řešitele, název, stav a vlastníka případu nebo odkaz na případ. Do kódu se vloží výraz, který hodnotu přečte.

Příklad: výpočet cestovních náhrad

Automatický úkol Calculate travel allowance v ukázkové šabloně „Travel request“ má jednu sekci s okamžikem Při spuštění. Spočítá počet dní cesty z data odjezdu a návratu a uloží do proměnné Travel allowance 600 Kč za každý den. Při zkušebním běhu s cestou na tři dny výpočet uložil 1 800 Kč a úkol se hned splnil.

Úkol Fill in the travel request má výpočet Při spuštění, který vyplní proměnnou Traveller vlastníkem případu, pokud je prázdná.

Jak přidat výpočet

  1. Otevřete úkol a klepněte na záložku Výpočty.
  2. Klepněte na Přidat sekci výpočtu.
  3. Zaškrtněte okamžik, kdy má výpočet běžet, například Při spuštění.
  4. Napište kód do editoru. Proměnné vkládejte polem Vložit proměnnou.
  5. Pokud potřebujete funkce ze sdíleného skriptu, vyberte ho v poli Skripty.
  6. Klepněte na Uložit.

Související: Typy úkolů, Dynamické podmínky: builder, sekce Výpočty a skripty.

Automatické dokončení a zrušení úkolu
Team assistant (opens in a new tab)

Powered by HelpDocs (opens in a new tab)