6.7. 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.

6.7.1. 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:

  • --mets nebo -m: cesta k souboru s metadaty balíčku (METS XML)

  • --ead nebo -e: cesta k souboru s archivní pomůckou (EAD XML)

  • --uuid nebo -u: UUID cílového balíčku, pokud není zadáno, bude vygenerováno automaticky

  • --workdir nebo -w: pracovní adresář, kam se uloží dočasné soubory a výsledný balíček

  • <input>: vstupní soubor nebo adresář, který obsahuje datový obsah balíčku

  • <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ě <uuid>.zip ve výstupním adresáři a protokol s průběhem převodu a případnou chybou v souboru <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