2.3. Vstupní složka

Vstupní složka je hlavním datovým vstupem transformačního agenta. Do vstupní složky jsou nahrávány soubory tvořící pro jednotlivé typy jednotek publikace. Cesta k této složce je součástí konfigurace. Transformační agent v pravidelných intervalech monitoruje vstupní složku (adresář Input). V případě zjištění nového vstupu je tento zpracován. Úspěšně zpracovaný vstup je přesunut do složky data. Vstup, který se nepodaří zpracovat z libovolného důvodu je přesunut do složky error, případně zůstane přímo ve vstupní složce.

Interval provádění kontrol je možné určit v konfiguraci.

Všechny druhy vstupů mají shodnou základní strukturu. Odlišuje se formát vstupních souborů a jejich pojmenování.

Při zpracování vstupu je vytvářen protokol o průběhu zpracování a zapisován do souboru protokol.txt. Při startu transformačního agenta dojde ke kontrole existence podřízených složek. Pokud některé neexistují, tak jsou automaticky vytvořeny.

2.3.1. Direct

Přímý datový vstup ve formátu jádra (schéma http://www.aron.cz/apux/2020). Hlavní soubor datového vstupu Direct musí být pojmenován apux-<identifikátor>.xml. Případné přílohy jsou jsou uloženy v podsložce files, kde jednotlivý soubor je identifikován svým UUID.

Komponenta soubor načte.Provede ověření prvků popisu a ty, které odkazují na přístupový bod přidá mezi dostupné přístupové body. Pokud XML obsahuje odkazy na DAO, tak přidá tyto DAO do fronty ke zpracování. Následně je XML zařazeno do fronty k odeslání.

2.3.2. Institutions

Datový vstup obsahující data o institucích. Data se nahrávají pomocí XML, které může obsahovat informace o 1..n institucích. Soubor se musí jmenovat institutions-<identifikátor>.xml. Soubor je v nativním formátu Elza.

Při zpracování souboru jsou importovány informace o instituci uvedené v identifikátoru v názvu souboru.

2.3.3. Funds

Informace o archivních souborech. V jednotlivé datové podsložce musí být soubor fund-<identifikace>.xml. Soubor je v nativním formátu Elza.

Pokud archivní soubor odkazuje na instituci, která v transformačním agentovi neexistuje, nelze vstup zpracovat ani při dalším pokusu. Je proto přesunut do složky error a důvod je zapsán do souboru protokol.txt. Vstup ponechaný ve vstupní složce by blokoval zpracování všech vstupů s nižší prioritou, tedy i archivních popisů.

2.3.4. Archdesc

Informace o jednotkách popisu. V jednotlivé datové podsložce musí být soubor archdesc-<identifikace>.xml. Soubor je ve formátu dle schématu Elza.

Pokud archivní popis odkazuje na archivní soubor, který v transformačním agentovi neexistuje, je archivní soubor vytvořen z přijatého archivního popisu - ten obsahuje i údaje o archivním souboru. Popis se zpracuje v některém z následujících cyklů, až archivní soubor vznikne. Vytvoření se zkouší jednou; pokud archivní soubor ani potom neexistuje, je archivní popis odmítnut. Chování lze vypnout volbou archdesc.import-missing-fund (ve výchozím stavu zapnuto), například tam, kde archivní soubory dodává PEvA.

Odmítnutý vstup - chybějící instituce, poškozené XML nebo neúspěšné vytvoření archivního souboru - nelze zpracovat ani při dalším pokusu. Je proto přesunut do složky error, důvod je zapsán do souboru protokol.txt a zpracování se již neopakuje. Pokud data pocházejí z publikace Elzy, je publikace v Elze označena jako chybná (stav PUBLISH_ERROR) včetně uvedeného důvodu.