.. _struktura_balicek:

===================
Struktura balíčku
===================

Kapitola popisuje základní struktura balíčku, uložení a 
pojmenování jednotlivých souborů tvořících balíček. Základním 
východiskem je specifikace :ref:`E-ARK CSIP <metodika_standardy_eark_csip>`,
kapitola **4 CSIP structure**.


.. _struktura_balicek_slozky:

Struktura složek
==================

Převzatá pravidla z E-ARK:CSIP: 4.1. Folder structure of the CSIP
-------------------------------------------------------------------

.. _czdax-psp0101:

**CZDAX-PSP0101** (E-ARK:CSIPSTR1, převzato beze změny): Každý balíček je uložen v samostatné (jediné) složce. 

.. _czdax-psp0102:

**CZDAX-PSP0102** (E-ARK:CSIPSTR2, upraveno): Název kořenové složky balíčku MUSÍ odpovídat hodnotě 
atributu :token:`@OBJID` z kořenového elementu v :file:`METS.xml`.

.. _czdax-psp0103:

**CZDAX-PSP0103** (E-ARK:CSIPSTR3, upraveno): Pokud je jednotlivý balíček předáván v zabalené/komprimované podobě, 
MUSÍ v tomto kontejneru (TAR nebo ZIP) být jedna složka nejvyšší úrovně, v níž jsou umístěny všechny další podsložky 
a soubory vytvářející tento balíček. Název této kořenové složky MUSÍ odpovídat hodnotě 
atributu :token:`@OBJID` z kořenového elementu v :file:`METS.xml`.

.. _czdax-psp0104:

**CZDAX-PSP0104** (E-ARK:CSIPSTR4, převzato beze změny): Balíček MUSÍ obsahovat kořenový :file:`METS.xml`.

.. _czdax-psp0105:

**CZDAX-PSP0105** (E-ARK:CSIPSTR5, upraveno): Kořenová složka informačního balíčku MUSÍ obsahovat složku 
s názvem :file:`metadata`, která MUSÍ obsahovat metadata týkající se celého balíčku. 

.. _czdax-psp0106:

**CZDAX-PSP0106** (E-ARK:CSIPSTR6, upraveno): Metadata popisující uchovávání (preservation) MUSÍ být uložena 
v podsložce :file:`preservation`.

.. _czdax-psp0107:

**CZDAX-PSP0107** (E-ARK:CSIPSTR7, upraveno): Popisná metadata MUSÍ být uložena v podsložce :file:`descriptive`. 

.. _czdax-psp0108:

**CZDAX-PSP0108** (E-ARK:CSIPSTR8, převzato beze změny): Pokud jsou k dispozici další metadata, MOHOU být zařazena 
do samostatných podsložek, například do další složky s názvem :file:`other`. 

.. _czdax-psp0109:

**CZDAX-PSP0109** (E-ARK:CSIPSTR9, upraveno): Pokud informační balíček obsahuje data či metadata reprezentací, 
MUSÍ obsahovat k tomu určenou složku pojmenovanou :file:`representations`.

.. _czdax-psp0110:

**CZDAX-PSP0110** (E-ARK:CSIPSTR10, upraveno): Složka reprezentací MUSÍ obsahovat podsložku pro každou jednotlivou 
reprezentaci. Každá složka reprezentace musí mít jedinečný název. Vhodnými kandidáty na název podsložky reprezentace 
může být například název reprezentace a/nebo datum jejího vytvoření. 

Originální data reprezentace převzaté v rámci přejímky balíčku musí být povinně uložena ve složce :file:`submission`.

.. _czdax-psp0111:

**CZDAX-PSP0111** (E-ARK:CSIPSTR11, upraveno): Pokud je reprezentace tvořena daty (nikoliv jen metadaty), MUSÍ být
uložena v podsložce pojmenované :file:`data`.

.. _czdax-psp0112:

**CZDAX-PSP0112** (E-ARK:CSIPSTR12, upraveno): Struktura celého balíčku MUSÍ být popsána v kořenovém :file:`METS.xml`. 
Složky reprezentací obsahující komponenty NESMÍ obsahovat samostatný :file:`METS.xml`. 
Samostatný soubor :file:`MEST.xml`` MŮŽE být uveden jen v případě reprezentací obsahujících 
rozšiřující data či metadata. Požadavky na formát takovýchto složek MUSÍ strany individuálně dohodnout
a odsouhlasit. 

.. _czdax-psp0113:

**CZDAX-PSP0113** (E-ARK:CSIPSTR13, upraveno): Složka reprezentace bez :file:`METS.xml` NESMÍ obsahovat složku :file:`metadata`. 
Složka reprezentace s :file:`METS.xml` by MĚLA obsahovat podsložku pojmenovanou :file:`metadata`, která MŮŽE obsahovat metadata
k dané reprezentaci. 

.. _czdax-psp0114:

**CZDAX-PSP0114** (E-ARK:CSIPSTR14, upraveno): Informační balíček NESMÍ obsahovat žádné dodatečné složky, které nejsou popsány 
v rámci této či doplňující specifikace výměnného balíčku. Pravidlo `CZDAX-PSP0108 <czdax-psp0108>` definuje, jakým způsobem 
lze balíček rozšiřovat o doplňující metadata, avšak ta musí být před přidáním nejprve potvrzena doplňující specifikací 
schválenou předávajícím i přejímajícím archivem.

.. _czdax-psp0115:

**CZDAX-PSP0115** (E-ARK:CSIPSTR15, upraveno): Pokud daný typ předávaného obsahu vyžaduje doplňující schémata dat pro strukturovaná 
metadata, MUSÍ být umístěna ve složce :file:`schemas` v kořenové složce. 

.. _czdax-psp0116:

**CZDAX-PSP0116** (E-ARK:CSIPSTR16, upraveno): Pokud daný typ předávaného obsahu vyžaduje doplňující dokumentaci předávaných 
a uchovávaných dat, MUSÍ být umístěna ve složce :file:`documentation` v kořenové složce.


.. _struktura_balicek_xml:

Struktura XML souborů
=======================

.. _czdax-psp0201:

**CZDAX-PSP0201**: XML soubory s metadaty MUSÍ odpovídat XML ve verzi 1.0. Jako kódování souborů musí být povinně nastaveno UTF-8. 

.. _czdax-psp0202:

**CZDAX-PSP0202**: V metadatových souborech MUSÍ být přímo užíván výchozí jmenný prostor. 

Z důvodu snazší čitelnosti a neopakování informací je v jednotlivých metadatových XML využíván primárně výchozí jmenný prostor 
pro uvádění elementů. Explicitně pojmenované jmenné prostory jsou využívány až pro sekundární schémata použitá 
v rámci daného metadatového souboru. Konkrétní podmínky mohou být dále stanoveny pro jednotlivé typy souborů. 

.. _czdax-psp0203:

**CZDAX-PSP0203**: Předávané metadatové soubory NESMÍ obsahovat další atributy či elementy nad rámec tohoto standardu. 

Cílem výměnného formátu balíčku je plnohodnotné přenesení úplné informace, a to takovým způsobem, 
aby byla shodně vnímána na straně tvůrce balíčku i jejího příjemce. V případě nutnosti doplňujících 
informací je nutná jejich samostatná explicitní definice, případně umístění v k tomu určených strukturách.


.. _struktura_balicek_schemata:

Předávání schémat
=======================

.. _czdax-psp0301:

**CZDAX-PSP0301**: Schémata k definovaným oborovým standardům BY se NEMĚLA předávat. 

Není důvod předávat schémata k uznávaným oborovým standardům, obzvlášť pokud se na nich
dohodnou obě strany. Další schémata se mohou uvést v závislosti na předávaném typu dat a 
jejich specifikaci.


.. _czdax-psp0302:

**CZDAX-PSP0302**: Schémata vybraných standardů se NESMÍ předávat. 

NESMÍ se předávat schémata oborových standardů, zejména: 

  - :ref:`METS <metodika_standardy_mets>`
  - :ref:`PREMIS <metodika_standardy_premis>`
  - :ref:`NSESSS <spisova_sluzba_standardy_nsesss>`
  - :ref:`EAD <metodika_standardy_ead>`

U uvedených standardů se nepředávají ani novější ani starší verze těchto standardů nežli ty,
které jsou uvedené v tomto dokumentu.


.. _struktura_balicek_dokumentace:

Předávání dokumentace
=======================

Dokumentace se uvádí v závislosti na předávaném typu dat a jejich specifikaci. Předaná dokumentace
by měla svou podstatou napomáhat ke zpracování daného informačního balíčku a schopnosti 
interpretovat jeho obsah. Není důvod předávat dokumentaci k uznávaným oborovým standardům, 
obzvlášť pokud se na nich dohodnou obě strany.

.. _czdax-psp0401:

**CZDAX-PSP0401**: MĚLA by se předávat dokumentace k méně obvyklým způsobům uložení dat
a jejich formátům. Dokumentace formátu souborů a jiných oborových standardů obecně známých
BY se NEMĚLA předávat.


Pokud se obě strany dohodnou na předávání dat či metadat nad rámec tohoto standardu, je nutné 
takováto rozšíření náležitě zdokumentovat a vzniklou dokumentaci uchovat.

.. _czdax-psp0402:

**CZDAX-PSP0402**: Formát dat a metadata předávané nad rámec tohoto standardu na základě
vzájemné dohody obou stran MUSÍ být přesně popsány a zdokumentovány. Takováto dokumentace 
MŮŽE být součástí daného balíčku. Pokud se dokumentace týká shodným způsobem většího množství balíčků,
NEMĚLA BY být uvedena u každého balíčku opakovaně, ale MĚLA BY být 
předána jiným způsobem. U daného balíčku MUSÍ být vhodným způsobem vyznačeno, že má vlastnosti 
nad rámec tohoto standardu.


.. _czdax-psp0403:

**CZDAX-PSP0403**: Dokumentace k obvyklým souborovým formátům se NESMÍ předávat, zejména 
se jedná o formáty textových souborů, grafických souborů a jiných dobře popsaných standardů
a specifikací.

Jedná se o nadbytečnou zátěž přijímajícího archivu, která navíc vyžaduje nutnost 
interpretace takové dokumentace. Za dobře zdokumentované soubory lze považovat ty, jejichž
formát je popsán ve zveřejněné a dostupné technické specifikaci. Průvodními znaky dobře 
popsaných formátů je například uvedení formátu ve formátové databázi *PRONOM*, užití formátu 
napříč více organizacemi a obzvláště v mezinárodním prostředí. Zachování technického popisu 
takového formátu může patřit mezi samostatné role archivu nad rámec této specifikace.