Smart Events pro integrace

Smart Event je úkol šablony, který místo člověka provede vestavěnou akci a výsledek uloží do proměnných případu. Obecnou obrazovku, na které Smart Event v úkolu nastavujete (výběr typu, vstupy, výstupní proměnné), popisuje článek Smart Event úkol. Tato kapitola se soustředí na to, jaké typy Smart Eventů jsou v TAS 5.19.12 k dispozici pro napojení na externí systémy, co od nich čekat na vstupu a co vrací na výstupu.

Jak Smart Event ukládá výsledek

Všechny typy Smart Eventu ukládají výsledek stejným způsobem – podle nastavení úkolu zapíší:

  • stavovou proměnnou – zda akce proběhla úspěšně (u většiny typů číselný HTTP-like stav, viz tabulka níže),
  • výstupní proměnnou – samotná data odpovědi; je-li odpovědí objekt, uloží se do proměnné jako text ve formátu JSON.

Obě proměnné nastavujete u úkolu bez ohledu na typ Smart Eventu – viz Smart Event úkol.

Typy dostupné vždy (jádro)

TypK čemu sloužíHlavní vstupyStav / výstup
HTTP RequestOdešle HTTP požadavek na libovolný externí endpoint a uloží odpověď. Základní stavební kámen pro napojení na REST/GraphQL API třetích stran.URL, metoda, hlavičky, parametry dotazu, tělo požadavku, časový limit, typ a kódování odpovědi, volitelně Basic autentizace.Stav = číselný kód HTTP odpovědi (např. 200), při selhání 500. Výstup = tělo odpovědi tak, jak ho vrátil server.
FTP / SFTP TransferPřenáší soubory přes FTP nebo SFTP – nahrání, stažení, přesun, smazání nebo výpis adresáře.Připojení (protokol, host, port, přihlašovací údaje nebo privátní klíč), operace (list, upload, download, delete, exists, createDirectory, removeDirectory, rename) a k ní odpovídající cesty.Stav = text success nebo error (ne číselný kód jako u ostatních typů). Výstup závisí na operaci: list vrátí pole souborů, exists ano/ne, ostatní operace text.
JWT GeneratorVygeneruje krátkodobý podepsaný token (JWT) – typicky pro přihlášení k externímu API, které vyžaduje JWT grant.Privátní klíč (PEM nebo JWK), algoritmus podpisu, obsah tokenu (payload, lze v něm použít proměnné případu i odkaz na Trezor), platnost v sekundách (výchozí 300).Stav = 200 při úspěchu, 500 při chybě. Výstup = podepsaný token jako text.
Platform AIOdešle dotaz do AI nakonfigurované v platformě bez další konfigurace přístupu.Prompt, volitelně systémová zpráva.Stav = 200/500. Výstup = odpověď AI jako text (případně s metadaty).
FTP hlásí úspěch/chybu textem, ne číslem
Na rozdíl od ostatních typů stavová proměnná u FTP / SFTP Transfer neobsahuje HTTP-like kód 200/500, ale text success nebo error. Pokud na stavu stavíte podmínku dál v procesu, počítejte s textovou hodnotou.

Typy z doplňkových pluginů

Tyto typy jsou v instalaci k dispozici, jen když je aktivní odpovídající plugin (Administrace › Pluginy):

TypPluginK čemu slouží
Claude AI, OpenAI, Azure OpenAI, Azure OpenAI (Response API), Google Gemini, OllamaclaudeAI, openAI, azureOpenAI, googleGenAI, OllamaOdešlou prompt do konkrétní AI služby (na rozdíl od Platform AI s vlastním připojením/klíčem) a uloží vygenerovanou odpověď.
DOCX GeneratordocxGeneratorVygeneruje DOCX dokument ze šablony dokumentu a dat případu.
ISDOC ReaderisDocNačte ISDOC faktury z dokumentů případu (.isdoc, .isdocx nebo PDF s vloženým ISDOC) a uloží je do výstupní proměnné. Viz také ERP a další integrace.
KSeFksefPráce s fakturami polského národního systému e-faktur KSeF – vyhledání, stažení nebo uložení jejich XML a export, výsledek do výstupní proměnné.

Odkazy na proměnné, Trezor a dokumenty v konfiguraci

Ve všech typech Smart Eventu (jádro i plugin) lze v textových polích konfigurace použít:

  • {ProměnnáPřípadu} – hodnotu proměnné případu nebo úkolu,
  • {vault:název} – tajný klíč z Trezoru, aniž by se jeho hodnota kdekoli zobrazila,
  • odkaz na dokument případu tam, kde typ pracuje se soubory (např. FTP Transfer nebo ISDOC Reader).

Související: Smart Event úkol, REST API: přihlášení a základní volání, ERP a další integrace, Trezor.

ERP a další integrace
Team assistant (opens in a new tab)

Powered by HelpDocs (opens in a new tab)