Smart Event úkol

Úkol typu Smart Event spustí vestavěnou akci systému, například zavolá API jiné aplikace, přenese soubor přes FTP, vygeneruje podepsaný token nebo pošle dotaz AI. Akci a její parametry nastavíte na záložce Smart Event v editoru úkolu. Výsledek a stav akce se uloží do proměnných případu a úkol se hned sám splní. Seznam Smart Eventů vidí jen administrátor.

Č.PrvekK čemu slouží
1Smart EventZáložka s nastavením akce. Je jen u tohoto typu úkolu.
2Smart EventVýběr akce v sekci Konfigurace Smart Eventu. Pod každou akcí je její popis. Povinné. Změna akce vymaže vyplněné parametry.
3Skupina parametrůSekce Vstupy Smart Eventu ukazuje parametry vybrané akce rozdělené do skupin s nadpisem a popisem. Šipkou skupinu sbalíte.
4Název parametruŠtítek vpravo nad polem ukazuje technický název parametru, například url. Otazník u pole otevře nápovědu.
5Přidat proměnnouIkona {} v textovém poli otevře nabídku pro vložení proměnné, tajného klíče nebo dokumentu.
6Vytvořit proměnnouZaloží novou proměnnou šablony, například pro výsledek.
7Uložit stav do proměnnéProměnná, do které se uloží stav provedení. Povinné.
8Uložit hodnotu do proměnnéProměnná, do které se uloží výsledek. Povinné.

Bez vybrané akce ukazuje sekce Vstupy text Vyberte Smart Event. Parametry se kontrolují při vyplňování a znovu při uložení úkolu. Úkol s neplatnými parametry neuložíte.

Vkládání hodnot do parametrů

KartaCo vložíZápis
ProměnnéHodnotu proměnné šablony.{nazevPromenne}
TrezorTajný klíč z trezoru, například heslo nebo API klíč. Hodnota se do úkolu neukládá, dosadí se až při spuštění.{{vault:nazev}}
AI zdrojeObsah dokumentu ze sdílených souborů, složka AI zdroje.{{ai-content:cesta}}
DokumentyOdkaz na dokument ze sdílených souborů, složka Dokumenty.{{documents:cesta}}

Proměnná se dosadí svou uloženou hodnotou. Neznámý název proměnné zůstane v parametru, jak je napsaný.

Hesla patří do trezoru
Hesla, tokeny a klíče nepište do parametrů přímo. Uložte je v administraci do trezoru a do parametru vložte odkaz z karty Trezor. Kdo vidí šablonu, neuvidí tak samotné heslo.

Dostupné Smart Eventy

Smart EventCo děláHlavní parametryStavHodnota
HTTP RequestOdešle HTTP požadavek na zadanou adresu.URL a metoda (povinné), hlavičky, parametry dotazu, tělo, časový limit, typ a kódování odpovědi, přihlášení jménem a heslem, limity přesměrování a velikosti.Kód odpovědi serveru, například 200. Při jakékoli chybě, i když server vrátí 404, je stav 500.Tělo odpovědi. Objekt se uloží jako JSON. Při chybě text chyby.
FTP / SFTP TransferPracuje se soubory na FTP nebo SFTP serveru: výpis, nahrání, stažení, smazání, kontrola existence, vytvoření a smazání složky, přejmenování.Připojení (protokol, server, uživatel, heslo nebo klíč) a operace s cestami.Text success nebo error.Výsledek operace, nebo text chyby.
JWT GeneratorVygeneruje krátkodobý podepsaný token JWT, například pro přihlášení do jiného API.Soukromý klíč, algoritmus a obsah tokenu (povinné), platnost v sekundách, výchozí 300.200, při chybě 500.Token, nebo text chyby.
Platform AIPošle dotaz AI nastavené v systému.Dotaz (povinné), systémová zpráva.200, při chybě 500.JSON s odpovědí AI, při chybě s popisem chyby.

Další Smart Eventy mohou přidat pluginy. Zobrazí se ve stejném seznamu.

Nápověda u stavu
Nápověda u pole Uložit stav do proměnné uvádí stav 200 nebo 500. U FTP / SFTP Transfer se ve skutečnosti ukládá text success nebo error. Podmínky na vazbách za úkolem nastavte podle toho.

Co se stane při spuštění úkolu

  1. Systém doplní do parametrů proměnné, tajné klíče a dokumenty a zkontroluje je.
  2. Spustí akci a počká na její výsledek.
  3. Uloží stav a hodnotu do vybraných proměnných.
  4. Spustí výpočty Při spuštění. Ty už mají k dispozici stav i hodnotu.
  5. Úkol se splní a případ pokračuje výstupními vazbami.

Úkol se splní i tehdy, když akce skončí chybou. Chyba se projeví jen v proměnné se stavem. Pokus se neopakuje. O dalším postupu proto rozhodněte podmínkou na vazbě podle stavu, například stav rovná se 200 pokračuje dál a ostatní stavy vedou na úkol pro ruční vyřešení.

Když chybí proměnná pro stav nebo hodnotu, parametry jsou neplatné, nebo akce v systému neexistuje, úkol se nespustí a akce, která ho aktivovala, skončí chybou.

Příklad

V ukázkové šabloně „Travel request“ úkol Send the booking to the travel agency posílá požadavek HTTP Request metodou GET s parametry dotazu destination = {destination} a reference = {bookingReference}. Stav ukládá do proměnné Booking request status, odpověď do Booking request response. Při zkušebním běhu se do stavu uložilo 200 a do odpovědi text stránky, kterou server vrátil.

Jak nastavit Smart Event

  1. Založte úkol a jako typ vyberte Smart Event.
  2. Na záložce Obecné vyplňte název a uložte úkol.
  3. Na záložce Smart Event vyberte akci.
  4. Vyplňte parametry. Hodnoty z případu vkládejte ikonou {}, hesla z trezoru.
  5. Vyberte proměnné pro stav a hodnotu. Chybějící proměnné založíte tlačítkem Vytvořit proměnnou.
  6. Klepněte na Uložit.
  7. V grafu šablony nastavte za úkolem vazby s podmínkou podle proměnné se stavem.

Související: Typy úkolů, Výpočty na úkolu, Trezor.

Typy úkolů

Instrukce, sekce a otestování úkolu
Team assistant (opens in a new tab)

Powered by HelpDocs (opens in a new tab)