Import procesů XML

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 Administrace → Integrace a správa dat → Import procesů XML.

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
QU	Soubor je zařazen ke zpracování (po ručním importu nebo reimportu).
EQ	Soubor se právě zpracovává.
FI	Případ byl úspěšně založen.
ER	Import skončil chybou. Podrobnosti najdete v záložce Logy.
SK	Soubor byl ručně přeskočen. Cron ho nebude importovat.

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	Zavřít	Vrátí vás do menu Administrace.
2	Audit importu	Záznamy o všech zpracovaných a přeskočených souborech.
3	Plánované importy	Soubory, které leží ve vstupní složce.
4	Hotové importy	Soubory v archivní složce po zpracování.
5	Logy	Záznamy logu s kategorií importu XML.
6	Detail	Zobrazí všechny údaje označeného řádku. Stejně funguje dvojklik na řádek.
7	Vložit poznámku	Připíše k označenému záznamu poznámku, například jak byla chyba vyřešena. Poznámku uložíte tlačítkem Uložit.
8	Obnovit	Znovu načte tabulku.

Sloupec	Obsah
ID	Číslo záznamu auditu (ID importu).
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ů.

Tlačítka nad tabulkou pracují s označeným řádkem: nejdřív klepněte na řádek, pak na tlačítko. V zápatí tabulky je stránkování, počet záznamů a tlačítka AutoFit (přizpůsobí šířku sloupců), Excel a csv (export tabulky).

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.

Č.	Prvek	K čemu slouží
1	Detail	Zobrazí všechny údaje označeného souboru.
2	Importovat XML	Okamžitě zpracuje označený soubor a založí z něj případ, i když už byl dříve naimportován.
3	Přeskočit XML	Označí soubor stavem SK. Cron ho při dalších bězích vynechá.
4	Více	Nabídka Stáhnout XML (stáhne soubor) a Stáhnout přílohu (stáhne dokument, který se k případu přiloží).
5	Obnovit	Znovu načte tabulku. Po importu nebo přeskočení ji obnovte, aby se ukázal nový stav.

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.

Importovat XML zakládá případ hned
Ruční 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á.

Č.	Prvek	K čemu slouží
1	Detail	Zobrazí všechny údaje označeného souboru.
2	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.
3	Více	Stáhnout XML a Stáhnout přílohu z archivu.
4	Obnovit	Znovu načte tabulku.

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. Řádky s chybou jsou červené, s varováním oranžové.

Č.	Prvek	K čemu slouží
1	Detail	Otevře celý záznam logu. Stejně funguje dvojklik na řádek.
2	Časový rozsah	Omezí log na období Od – Do. Když je rozsah nastavený, tlačítko je oranžové. Tlačítkem Reset rozsah zrušíte.
3	Obnovit	Znovu načte log.

Sloupce: Datum (s milisekundami), doba od předchozího záznamu, Zpráva, Kategorie, Level (error, warn, info, debug, trace), Doba trvání (ms), ID importu a ID případu. Podle ID importu najdete všechny záznamy k jednomu souboru.

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 souborů nejvýš zpracovat v jednom běhu.
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ů.

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, Licence.

Schéma

Sdílené soubory

(opens in a new tab)