.. _dspace_batch:

==============================
Struktura importní dávky
==============================

Dávka je tvořena adresářem obsahujícím jednotlivé Dao a značku o její připravenosti k importu.

Struktura DAO
===============

Jednotlivé DAO jsou uloženy v samostatném adresáři. Pojmenování každého DAO 
má strukturu: CisloArchivu_CisloAS_DAO. Jednotlivé DAO se skládá z následujících 
částí:

 * :ref:`volitelná definice DAO a metadat v souboru dao.xml <dspace_batch_daoxml>`
 * :ref:`jednotlivé binární soubory tvořící dao <dspace_batch_daosimple>` nebo 
   :ref:`složky obsahující soubory pro jednotlivé Bundle <dspace_batch_daobundles>`
 * :ref:`soubor signalizující připravenou dávku <dspace_batch_konec>`


Jednotlivé stránky, které tvoří příslušné DAO mohou být originály s případnými 
připravenými náhledy nebo je možné přímo přiřadit jednotlivé soubory 
do konkrétního Bundle v DSpace (viz samostatná dokumentace k DSpace).


.. _dspace_batch_daosimple:

Zjednodušené DAO
-------------------

Ve zjednodušeném režimu jsou soubory/stránky přímo uloženy ve složce :file:`DAO`, tj. na 
stejné úrovni jako je soubor :file:`dao.xml`. Při importu se hledají soubory 
všechny soubory v této složce. Nalezené soubory jsou načteny a jsou uspořádány abecedně. 
Pokud jsou současně uvedeny v souboru :file:`dao.xml` je jejich pořadí dáno 
pořadím v tomto souboru.

Ke každému souboru ve složce je možné do adresáře vložit 
připravený náhled a případně doplněná metadata. Náhled musí být ve formátu JPEG a musí 
být uložen ve shodně se jmenujícím souboru jako originál s doplněním postfixu :file:`.thumb`.
Metadata lze uložit do souboru ve formátu XML, soubor se opět musí jmenovat shodně
jako originál s doplněním postfixu :file:`.meta`.

Pokud k souboru neexistuje předem vytvořený náhled je tento automaticky
vytvořen v průběhu importu. Obdobně pokud k souboru nejsou definována
metadata jsou základní extrahována přímo ze souboru.

.. _dspace_batch_daobundles:

DAO s napojením na jednotlivé Bundle
---------------------------------------

Pro napojení souborů na jednotlivé Bundle je nutné tyto soubory 
uložit do složky jejíž název odpovídá požadovanému Bundle. Doporučené názvy
pro Bundly jsou:

:token:`ORIGINAL`
     Bundle :token:`ORIGINAL` je výchozí pro uložení originálů souborů. 
     Použije se i v případě pokud žádný není uveden.

:token:`THUMBNAIL`
     Bundle :token:`THUMBNAIL` je určen pro uložení náhledů souborů. 
     Do tohoto Bundle se automaticky generují náhledy. Předem připravené 
     náhledy je možné předat jako součást DAO.

:token:`METADATA`
     Bundle :token:`METADATA` je určen pro uložení samostatných metadat souborů. 
     Do tohoto Bundle se ukládají samostatně připravené XML soubory s metadaty.


V :ref:`souboru dao.xml <dspace_batch_daoxml>` je vhodné pro každý Bundle definovat
samostatnou část pomocí elementu :token:`PAGES`. V této části se určí jednotlivé 
soubory tvořící daný BUNDLE.


.. _dspace_batch_daoxml:

Soubor dao.xml
=========================

Soubor :file:`dao.xml` je volitelný a slouží definici metadat a explicitní
popis uspořádání souborů/stránek v rámci jednoho DAO. Soubor je vytvářen podle 
schématu: :file:`http://elza.tacr.cz/xsd/dspace/dao`.

Definice schématu XSD: :download:`dspace-import-dao.xsd <dspace-import-dao.xsd>`




.. _dspace_batch_konec:

Připravená dávka
==================

Připravená dávka pro import obsahuje soubor :file:`Konec.txt`.


Protokol o zpracování dávky
============================

Při zpracování dávky je vytvářen protokol o jejím zpracování, soubor: :file:`Proto.txt`.
