.. _pkgs_pkginf:

=============================
Základní informace o balíčku
=============================

Základní informace o balíčku jsou předávány v metadatovém souboru 
označovaném :file:`PACKAGE-INFO.xml`. Tento soubor je předáván 
jako součást metadat celého balíčku. V případě požadavku na poskytnutí
jen základních informací o balíčcích je předáván pro každý balíček 
pouze samostatně tento soubor a žádný další.

Samostatně předaný soubor MUSÍ splňovat všechny požadavky kladené na tento soubor 
v rámci metodiky :ref:`nmet1`. Nad rámec těchto výchozích požadavků
MUSÍ obsahovat:

  - informaci o celkové velikosti balíčku
  - informaci o aktuální verzi balíčku v digitálním archivu

Způsob zápisu těchto informací do datového souboru je popsán v :ref:`nmet1`.
Uvedené rozšíření obsahu :file:`PACKAGE-INFO.xml` se uplatní vždy,
když je předáván do softwaru pro zpracování, tj. i v případě zpřístupnění 
obsahu balíčku v podobách: :ref:`pkgs_archinf` a :ref:`pkgs_content`.


Způsob získání základních informací
====================================

Pro získání základních informací 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="package_info"`` určující výslednou podobu dat.


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 obsahuje vždy jeden soubor pojmenovaný 
:file:`PACKAGE-INFO.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)
    ** AIP2 (složka) 
    *** PACKAGE-INFO.xml (soubor)
    @endwbs