.. _pkgs_archinf:

=============================
Archivní metadata
=============================

V některých případech je postačující poskytnutí 
jen tzv. archivních metadat. Ta jsou tvořena 
soubory:

 - :file:`PACKAGE-INFO.xml` - obsahuje základní informace o celém balíčku
 - :file:`EAD-INHERENT.xml` - inherentní archivní popis
 - :file:`EAD-CONTEXT.xml` - kontextuální archivní popis

V případě požadavku na poskytnutí jen archivních metadat 
jsou pro každý balíček samostatně předány tyto tři uvedené soubory
(pokud existují). 

Formát těchto souborů odpovídá jejich definici v :ref:`nmet1`.

Způsob získání archivních metadat
====================================

Pro získání archivních metadat je nutné zaslat příslušný požadavek 
pomocí :ref:`REST rozhraní <baseapi>`, konkrétně pomocí metody 
``POST /download/aips``. Parametrem volání je seznam vyžádaných balíčků 
a parametr ``dipType="archdesc"`` určující výslednou podobu.


Formát výsledných dat
========================

Pro každý požadovaný balíček je předána vždy jedna složka. Název této složky
odpovídá identifikátoru balíčku. Složka vždy obsahuje soubory s pevnými názvy (pokud existují):
:file:`PACKAGE-INFO.xml`, :file:`EAD-INHERENT.xml` a :file:`EAD-CONTEXT.xml`.

.. plantuml::
    :caption: Příklad odpovědi pro balíčky s identifikátory AIP1 a AIP2.
    :scale: 70%
    :align: center 

    @startwbs
    * Výsledek
    ** AIP1 (složka)
    *** PACKAGE-INFO.xml (soubor)
    *** EAD-INHERENT.xml (soubor)
    *** EAD-CONTEXT.xml (soubor)
    ** AIP2 (složka) 
    *** PACKAGE-INFO.xml (soubor)
    *** EAD-INHERENT.xml (soubor)
    @endwbs