.. _esm_eark:

====================
Export do eARK
====================

Balíčky je možné převádět a exportovat do výměnného formátu eARK dle platného 
českého profilu, viz https://stands.nacr.cz/da-aip/. Převod je realizován dvou krokově:

 - výběr balíčků k exportu na straně ESM
 - volání konverzního nástroje, který balíčky převede do formátu eARK

Obě činnosti jsou dostupné v agendě Exportních dávek.


.. _esm_eark_convert:


Nástroj pro převod
========================

Nástroj pro převod balíčků je samostatná aplikace, která se spouští z příkazové řádky nad 
jednotlivým balíčkem a souvisejícími metadatay. Nástroj je možné také spustit v dávkovém režimu 
prostřednictvím ESM. 

Zdrojový kód nástroje je dostupná v repozitáři: https://gitlab.lightcomp.cz/ukais/earkconvert

Vývojová sestavení jsou dostupná na adrese: https://frnk.lightcomp.cz/download/cuni-ais/snapshots/earkconvert/

Nástroj pro svůj běh vyžaduje Java 17 a vyšší.


Parametrizace nástroje
------------------------

Nástroj je možné spustit vždy pro převod jednoho balíčku.

``earkconvert [--mets|-m <soubor s metadaty>] [--ead|-e <soubor s pomůckou>] [--uuid|-u <UUID cílového balíčku>] [--workdir|-w <adresář>] <input> <output>``

Parametry:

 - :option:`--mets` nebo :option:`-m`: cesta k souboru s metadaty balíčku (METS XML)
 - :option:`--ead` nebo :option:`-e`: cesta k souboru s archivní pomůckou (EAD XML)
 - :option:`--uuid` nebo :option:`-u`: UUID cílového balíčku, pokud není zadáno, bude vygenerováno automaticky
 - :option:`--workdir` nebo :option:`-w`: pracovní adresář, kam se uloží dočasné soubory a výsledný balíček
 - :option:`<input>`: vstupní soubor nebo adresář, který obsahuje datový obsah balíčku
 - :option:`<output>`: výstupní adresáře, kam bude uložen výsledný eARK balíček a jeho protokol

Výsledkem převodu je balíček v podobě :file:`<uuid>.zip` ve výstupním adresáři a protokol s průběhem převodu a případnou chybou 
v souboru :file:`<uuid>.log`.


Nástroj je možné spustit ve třech režimech:

 - s jedním vstupním parametrem (soubor), kdy balíček je předán ve formě jednoho ZIP souboru
 - s jednim vstupním parametrem (adresář), kdy balíček je předán jako adresář, který obsahuje soubor s metadaty a další ZIP soubor s datovým obsahem
 - s více vstupními parametry, kdy je možné předat jak soubor s metadaty, tak datový obsah jako ZIP soubor a také UUID cílového balíčku

Příklad spuštění s více vstupními parametry, výstup bude uložen do adresáře ``D:\earkconvert.work\output``:

``earkconvert -w D:\earkconvert.work\work -u 3b87a2a5-d26f-4475-a979-f6dfe61b339e -m "D:\earkconvert.work\extracted\3b87a2a5-d26f-4475-a979-f6dfe61b339d\3b87a2a5-d26f-4475-a979-f6dfe61b339d_xml_6.xml" "D:\earkconvert.work\extracted\3b87a2a5-d26f-4475-a979-f6dfe61b339d\3b87a2a5-d26f-4475-a979-f6dfe61b339d.zip" D:\earkconvert.work\output``