Import procesů XML v5.21

Jak import funguje
Audit importu
Plánované importy
Hotové importy
Logy
Parametry cronu

Import procesů XML zakládá případy z XML souborů, které do sdílené složky na serveru ukládá jiný systém (například ERP nebo skener dokumentů). Soubory zpracovává cron XMLProcessImport, tato obrazovka slouží ke kontrole a ručnímu zásahu: co čeká na import, co se naimportovalo, co skončilo chybou. Obrazovku vidí jen administrátor a funguje jen s platnou licencí. Otevřete ji v menu Administrace položkou Import procesů XML v kategorii Integrace a správa dat.

Jak import funguje

V části Crony má cron XMLProcessImport v parametrech nastaveno, ze které složky soubory číst, z jaké šablony a hlavičky zakládat případy a kam soubory po zpracování přesunout (viz Parametry cronu).
Při každém běhu cron projde složku, z každého nalezeného souboru založí případ a hodnotu z XML uloží do proměnné případu. Volitelně k případu přiloží dokument.
Každý soubor se zapíše do auditu importu se stavem. Soubor, který už jednou zpracován byl, cron podruhé neimportuje (pokud to parametry nezmění).

Obrazovka čte jen aktivní crony XMLProcessImport. Pokud žádný aktivní není, jsou záložky Plánované importy a Hotové importy prázdné.

Stavy importu ve sloupci Stav:

Stav	Význam
Ke zpracování	Soubor je zařazen ke zpracování.
Probíhá	Soubor se právě zpracovává.
Dokončený	Případ byl úspěšně založen.
Chyba	Import skončil chybou. Podrobnosti najdete v záložce Logy.
Přeskočeno	Soubor byl ručně přeskočen. Cron ho nebude importovat.

Od verze 5.21
Stav se zobrazuje barevným štítkem se srozumitelným názvem místo dvoupísmenného kódu (QU, EQ, FI, ER, SK). Akce s řádkem najdete v nabídce řádku místo tlačítek nad tabulkou.

Audit importu

Výchozí záložka. Každý řádek je jeden soubor, který TAS zpracoval nebo přeskočil.

Č.	Prvek	K čemu slouží
1	Audit importu	Záznamy o všech zpracovaných a přeskočených souborech.
2	Plánované importy	Soubory, které leží ve vstupní složce.
3	Hotové importy	Soubory v archivní složce po zpracování.
4	Logy	Záznamy logu s kategorií importu XML.
5	Obnovit	Znovu načte tabulku otevřené záložky.
6	Zavřít	Vrátí vás na stránku, ze které jste import otevřeli.
7	Stav	Stav importu. V poli pod záhlavím můžete filtrovat podle stavu.
8	Nabídka řádku	Akce s jedním záznamem.

Akce	K čemu slouží
Detail	Zobrazí všechny údaje záznamu. Stejně funguje dvojklik na řádek.
Vložit poznámku	Připíše k záznamu poznámku, například jak byla chyba vyřešena. Poznámku uložíte tlačítkem Uložit.

Sloupec	Obsah
ID	Číslo záznamu auditu (ID importu). Tabulka je ve výchozím stavu seřazená od nejnovějšího.
ID dávky	Číslo běhu, ve kterém byl soubor zpracován. Soubory z jednoho běhu mají stejné číslo.
ID případu	Případ založený z tohoto souboru.
Název souboru, Cesta k souboru	Název a úplná cesta k souboru na serveru.
Stav	Stav importu (viz tabulka výše).
Začátek, Konec, Doba trvání (ms)	Kdy zpracování začalo a skončilo a jak dlouho trvalo.
ID cronu	Cron, který soubor zpracoval.
Velikost XML souboru, Velikost přílohy	Velikost zpracovaného souboru a přiloženého dokumentu.
Výsledek úlohy	Výsledek zpracování.
Poznámka	Poznámka vložená administrátorem.
Počet importů	Kolikrát byl soubor skutečně naimportován.
Počet opakování	Kolikrát se ho cron pokusil zpracovat, včetně přeskočených pokusů.

Nad tabulkou je tlačítko Filtr pro podrobný filtr. V zápatí je počet záznamů a tlačítka Zobrazení, Přizpůsobit sloupce a Export.

Plánované importy

Soubory, které právě leží ve vstupních složkách aktivních cronů XMLProcessImport. Patří sem i soubory, které už byly zpracovány, ale zůstaly ve složce. Jejich stav a ID importu převezme tabulka z auditu.

Akce v nabídce řádku	K čemu slouží
Detail	Zobrazí všechny údaje souboru. Stejně funguje dvojklik na řádek.
Importovat XML	Okamžitě zpracuje soubor a založí z něj případ, i když už byl dříve naimportován.
Přeskočit XML	Označí soubor stavem Přeskočeno. Cron ho při dalších bězích vynechá.
Stáhnout XML	Stáhne soubor.
Stáhnout přílohu	Stáhne dokument, který se k případu přiloží. Položka je jen u souborů s přílohou.

Sloupce: Název souboru, Cesta k souboru, ID cronu, Poslední úprava, Čas vytvoření, Název přílohy, Velikost přílohy, Stav a ID importu. Po importu nebo přeskočení se tabulka sama obnoví.

Importovat XML zakládá případ hned
Ruční import ani přeskočení se nepotvrzují. Import nečeká na cron a nekontroluje, zda už byl soubor zpracován. Opakovaným importem stejného souboru vznikne další případ.

Hotové importy

Soubory, které cron po zpracování zkopíroval do archivní složky (parametr copyXmlDestination). Bez archivní složky zůstane záložka prázdná.

Akce v nabídce řádku	K čemu slouží
Detail	Zobrazí všechny údaje souboru.
Reimportovat XML	Zkopíruje soubor (a jeho přílohu, pokud ji najde) zpět do vstupní složky a hned ho znovu naimportuje. Vznikne nový případ.
Stáhnout XML, Stáhnout přílohu	Stáhne soubor nebo jeho přílohu z archivu.

Sloupce: Název souboru, Cesta k souboru, Velikost XML souboru, ID cronu, Poslední úprava, Čas vytvoření, Název přílohy, Velikost přílohy.

Logy

Záznamy logu TAS předfiltrované na kategorii importu XML. Sloupce Datum, Zpráva, Kategorie, Level, Trace ID, Doba trvání (ms), ID importu a ID případu. Podle ID importu najdete všechny záznamy k jednomu souboru. Dvojklikem na řádek otevřete celý záznam logu.

Na záložce Logy přibude tlačítko Časový rozsah, které omezí log na období Od – Do. Když je rozsah nastavený, tlačítko je zvýrazněné oranžově. Předvolený filtr kategorie můžete upravit, uložit tlačítkem Uložit filtr nebo zrušit tlačítkem Zrušit filtry.

Parametry cronu

Import nastavuje administrátor v části Crony u cronu XMLProcessImport. Jeden cron zpracovává jednu konfiguraci. Pro další složku nebo šablonu cron zkopírujte. Výchozí stav cronu je neaktivní.

Parametr	K čemu slouží
xmlPath	Složka (nebo více složek oddělených znakem \|) se vstupními soubory.
walkSubfolders	Procházet i podsložky (výchozí ano).
processAllFiles, processFileExt	Zpracovávat všechny soubory, nebo jen soubory s danou příponou (výchozí .xml).
tProcId, headerId	Šablona a hlavička, ze kterých se případ zakládá.
iprocInstOwner, orgstrId	Uživatel, za kterého se případ založí, a jeho organizační jednotka.
iprocName	Název případu. Může obsahovat hodnotu z XML ve složených závorkách.
tvarName, xmlAttr	Proměnná případu, do které se uloží hodnota z XML, a cesta k hodnotě v XML (části oddělené tečkou). Bez cesty se uloží celé XML.
xmlFileTvarName, configTvarName	Proměnné, do kterých se uloží cesta k souboru a konfigurace importu.
addDmsFile, attachSelf	Dokument, který se k případu přiloží (cesta může obsahovat hodnotu z XML nebo název souboru), a zda přiložit i samotný XML soubor.
mustHaveFile	Pokud dokument k přiložení chybí, import skončí chybou.
copyXmlDestination, copyDmsDestination	Archivní složky, kam se soubor a dokument po zpracování zkopírují. Ze složky copyXmlDestination čte záložka Hotové importy.
deleteSourceXml, deleteSourceDmsFile	Smazat zdrojový soubor a dokument po zpracování.
skipProcessedFileName	Každý soubor zpracovat jen jednou (výchozí ano).
limit	Kolik případů nejvýš založit v jednom běhu. Soubory, které už byly naimportovány, skončily chybou nebo byly přeskočeny, se do limitu nepočítají.
maxErroredCount	Po kolika chybách se běh zastaví (výchozí 1, tedy hned po první chybě).
singleProcessTimeout	Časový limit pro jeden soubor v sekundách (výchozí 30).
email	Adresa, na kterou TAS pošle přehled úspěšných a chybných importů.

Uživatele, hlavičku a organizační jednotku vybíráte v parametrech cronu ze seznamu. Parametry, které odkazují na neexistujícího uživatele, šablonu, hlavičku, proměnnou nebo organizační jednotku, nejde uložit.

Povolené složky
Složky v parametrech musí být mezi složkami, ke kterým má TAS na serveru povolený přístup. Jinak import skončí chybou „Path is not allowed for xml process import.“

Související: Crony, Logy.

Sdílené soubory

HR agenda a předání agendy

(opens in a new tab)