.. _struktura_uchovaní:

========================
Metadata o uchovávání
========================

.. role:: xquery(code)
   :language: xquery

.. role:: xml(code)
   :language: xml


Metadata o uchovávání se vztahují k jednotlivým souborům, 
které tvoří datový obsah balíčku. Umožňují zachytit statické 
informace o jednotlivých souborech, tj. jejich kontrolní součty,
přesné určení formátu. Dále je možné zapsat informace o provedených 
transformacích jednotlivých souborů a také zachytit jejich vzájemné vazby.
Hlavní motivací pro transformace je zajištění formátové ochrany a 
tím trvalé zachování uchovávaného obsahu. Součástí dokumentovaných 
událostí jsou akce rozbalení kontejnerů, částečné skartace či delimitace komponent.

Metadata o uchovávání je možné uvádět v rámci jediného metadatového souboru,
či je rozprostřít do několika samostatných. Způsob tohoto řešení záleží 
na jednotlivé implementaci digitálního archivu. V případě menšího množství 
uchovávacích metadat je vhodné je uvést všechna ve společném souboru 
pojmenovaném :file:`PREMIS.xml`. Na základě přečtení všech souborů obsahujících 
metadata o uchovávání je možné vytvořit úplný obraz o vztazích mezi jednotlivými 
soubory tvořícími datový obsah balíčku a o jejich vzájemných vztazích.

Na úrovni jednotlivých sémantických jednotek (objektů) odpovídajících fyzickým souborům 
se uvádí vždy aktuální a platná podoba metadat. Pokud by například došlo 
k chybnému výpočtu kontrolního součtu, je toto možné zachytit formou události. 
Chybná hodnota kontrolního součtu se však neuvádí přímo u sémantické jednotky (objektu) souboru.

Metadata o uchovávání se primárně zaměřují na události, kdy dochází ke změně
jednotlivých komponent, resp. odvozování a vzniku nových souborů. Volitelně mohou 
být zaznamenány doplňkové události, které nevytváří datové komponenty, ale obohacují 
či kontrolují metadata. Jsou jimi například: antivirová kontrola, 
tvorba kontrolních součtů, detekce formátů apod.

.. _czdax-pmp0001:

**CZDAX-PMP0001**: V metadatech o uchovávání MOHOU být zapsány jen tzv. 
:ref:`datové <struktura_uchovaní_evtdata>` a :ref:`metadatové <struktura_uchovaní_evtmtdata>` 
události definovaných typů. Jiné typy událostí NESMÍ být uvedeny.



.. _struktura_uchovaní_file:


Komponenta (datový soubor)
============================

Základní metadata o jednotlivé komponentě (datovém souboru) jsou zachycena 
v kořenovém :file:`METS.xml` (viz :ref:`struktura_mets`).
Tato metadata je možné dále upřesnit a rozšířit pomocí samostatné sémantické jednotky,
která popisuje tuto komponentu. V rámci metadat o uchovávání je možné 
zachytit informaci o platných, ale také již zneplatněných komponentách v 
důsladku vymazání, delimitace, formátové migrace apod.

.. _czdax-pmp0101:

**CZDAX-PMP0101**: Na úrovni jednotlivých objektů odpovídajících fyzickým souborům 
(komponentám) MUSÍ být vždy uvedena jen aktuální a platná podoba metadat. 


.. _czdax-pmp0102:

**CZDAX-PMP0102**: Každá komponenta (resp. soubor) tvořící datový obsah balíčku 
by MĚLA být zachycena v odpovídající sémantické jednotce typu ``object`` v elementu
:xml:`<object xsi:type="file">`. Identifikátor sémantické jednotky MUSÍ odpovídat 
identifikátoru komponenty (souboru) v kořenovém :file:`METS.xml`, viz: 
:ref:`CZDAX-PMT0516 <czdax-pmt0516>`.


.. _czdax-pmp0103:

**CZDAX-PMP0103**: Každá zneplatněná a odstraněná komponenta, resp. soubor, který 
dříve tvořil datový obsah balíčku a již není jeho součástí, ale je na něj odkazováno 
z archivního popisu, MUSÍ být uveden formou samostatné sémantické jednotky ``object`` v elementu
:xml:`<object xsi:type="file">`. Identifikátor sémantické jednotky MUSÍ být typu 
``local`` a být shodně použitý v ostatních metadatových souborech.
K odstraněné komponentě MUSÍ existovat odpovídající 
:ref:`událost o jejím smazání <struktura_uchovaní_evt_del>`.


.. _czdax-pmp0104:

**CZDAX-PMP0104**: U každé komponenty BY MĚL být uveden kontrolní součet 
vytvořený pomocí algoritmu *sha512*. U objektu komponenty MŮŽE být uvedeno 
i několik alternativních kontrolních součtů vypočtených podle jiných algoritmů.
Kontrolní součet vypočtený pomocí *sha512* MUSÍ přesně odpovídat hodnotě uvedené 
v :file:`METS.xml`. Kontrolní součet se uvádí v sémantické jednotce fixity 
v elementu :xml:`<fixity>`. Funkce použitá pro výpočet se uvede v souladu 
s řízeným slovníkem `kryptografických funkcí <https://id.loc.gov/vocabulary/preservation/cryptographicHashFunctions.html>`_.
Vlastní hodnota se uvede v elementu :xml:`<messageDigest>`, a to pomocí 
hexadecimálního zápisu hodnoty pomocí znaků *0-9* a *a-f*. Jako součást MŮŽE
být uveden volitelný element :xml:`<messageDigestOriginator>` s hodnotou odkazující 
na agenta, který výpočet provedl.


.. _czdax-pmp0105:

**CZDAX-PMP0105**: U každé komponenty BY MĚLA být uvedena informace o její velikosti.
Velikost se uvádí v bytech v sémantické jednotce **size**, resp. elementu :xml:`<size>`.
Pokud je velikost uvedena MUSÍ odpovídat hodnotě uvedené v kořenovém :file:`METS.xml`.


.. _czdax-pmp0106:

**CZDAX-PMP0106**: U každé komponenty BY MĚL být uveden její původní název.
Název MUSÍ být uveden včetně cesty, jejíž části MUSÍ být oddělěny pomocí 
lomítka (``/``, nikoliv ``\``). Uvedení původního názvu je důležité 
zejména u dat vzniklých přímo v rámci přejímky. Název se uchovává 
v sémantické jednotce **originalName**, resp. elementu :xml:`<originalName>`.


Formát komponenty
---------------------------

Identifikací a uvedením formátu komponenty je možné zajistit její příslušnou formátovou ochranu, 
data přečíst a dále zpracovávat. Lze předpokládat, že většina dat uchovávaných v digitálních 
archivech bude primárně v obecně známých a využívaných formátech, případně bude známa 
cesta, jak data do interpretovatelné podoby převést. Formát souboru se obvykle uvádí
kombinací zvoleného registru formátů a identifikátorem zvoleného formátu. Tuto 
informaci je vhodné provázat i s vlastní událostí identifikace, aby bylo možné 
určit čas, nástroj a způsob identifikace. Často využívaným formátovým registrem 
je registr PRONOM. Méně formalizovaným registrem je také využívání registru IANA, 
tj. MIMETYPE. Využívání jiných registrů je na dohodě stran předávajících si balíček.

Způsob a čas identifikace formátu lze popsat pomocí samostatné operace :ref:`struktura_uchovaní_evtmtdata_for`.

.. _czdax-pmp0107:

**CZDAX-PMP0107**: Komponenta MŮŽE mít uvedeno několik identifikovaných formátů 
pomocí vzájemně různých registrů. Identifikované formáty se zapisují 
pomocí sémantické jednotky ``format`` v elementu :xml:`<format>`.

.. _czdax-pmp0108:

**CZDAX-PMP0108**: Komponenta MUSÍ mít uveden vždy co nejvíce specializovaný identifikovaný 
formát. 

Pokud se jedná například o formát DOCX, uvede se formát 
(MIME type: ``application/vnd.openxmlformats-officedocument.wordprocessingml.document``)
a nikoliv ZIP (MIME type: ``application/zip``), přestože se současně jedná i o tento formát.
Uvedením formátu DOCX je možné zajistit správnou interpretaci uložených dat v takovém 
souboru.

.. _czdax-pmp0109:

**CZDAX-PMP0109**: Zjištěný název formátu a jeho verze MUSÍ být uvedeny v rámci sémantické 
jednotky **formatDesignation**. Jmenovitě v elementu :xml:`<formatName>` se uvede jméno formátu 
a v elementu :xml:`<formatVersion>` se uvede identifikátor verze formátu. Název formátu 
a verze BY MĚL vycházet z hodnoty uvedené v příslušném formátovém registru použitém při jeho 
identifikaci.

.. _czdax-pmp0110:

**CZDAX-PMP0110**: Každý identifikovaný formát souboru MUSÍ mít uveden zdrojový 
registr označení daného formátu v sémantické jednotce **formatRegistry**, resp. v elementu
:xml:`<formatRegistry>`.

.. _czdax-pmp0111:

**CZDAX-PMP0111**: Každá komponenta BY MĚLA mít uveden identifikovaný formát
dle registru *PRONOM*. V případě jednoznačné identifikace formátu dle registru *PRONOM*
MUSÍ být tato informace uvedena. Jako název registru v elementu :xml:`<formatRegistryName>`
MUSÍ být uvedena hodnota ``PRONOM``. V elementu :xml:`<formatRegistryKey>` MUSÍ
být uvedena odpovídající hodnota trvalého identifikátoru formátu, tzv. *PUID*.

.. _czdax-pmp0112:

**CZDAX-PMP0112**: Každá komponenta BY MĚLA mít uveden identifikovaný formát
dle registru IANA/MIME type (dle :rfc:`6838`). Jako název registru v elementu :xml:`<formatRegistryName>`
MUSÍ být uvedena hodnota ``MIME``. V elementu :xml:`<formatRegistryKey>` MUSÍ
být uvedena odpovídající hodnota.


.. code-block:: xml
  :caption: Příklad objektu komponenty

  <object xsi:type="file">
    <objectIdentifier>
      <objectIdentifierType>local</objectIdentifierType>
      <objectIdentifierValue>uuid-8e78c90f-21e6-4799-a77a-2700c34bc9b2</objectIdentifierValue>
    </objectIdentifier>
    <objectCharacteristics>    
      <!-- Kontrolní součet -->
      <fixity>
        <messageDigestAlgorithm>sha512</messageDigestAlgorithm>
        <messageDigest>88DF182D958BCFB7F95B392543654BA1D070DEBDCB982E7856D08BB0C6B1069E89A2F8B44BABE125E1A7F5383DB06778CBC249BE0380555BF2969EA89500FF94</messageDigest>
        <messageDigestOriginator>uuid-18074e4a-05e5-492b-9a21-a650baca17c8</messageDigestOriginator>
      </fixity>
      <!-- Typ dle PRONOM -->
      <format>
        <formatDesignation>
          <formatName>Acrobat PDF/A - Portable Document Format</formatName>
          <formatVersion>1a</formatVersion>
        </formatDesignation>
        <formatRegistry>
          <formatRegistryName>PRONOM</formatRegistryName>
          <formatRegistryKey>fmt/95</formatRegistryKey>
        </formatRegistry>
      </format>
      <format>
        <formatRegistry>
          <formatRegistryName>MIME</formatRegistryName>
          <formatRegistryKey>application/pdf</formatRegistryKey>
        </formatRegistry>
      </format>
    </objectCharacteristics>
    <originalName>komponenty/priloha.pdf</originalName>
  </object>


.. _struktura_uchovaní_evtdata:

Datové události
==================

Datovými událostmi rozumíme takové, které mají dopad na datový obsah balíčku.
Následující tabulka poskytuje přehled událostí, které lze reprezentovat v metadatech 
o uchovávání, a jejich význam. 

Základní charakteristikou datových událostí je, že jejich výsledkem musí být změna 
v komponentách, které tvoří balíček. Změna může znamenat vznik nebo zánik komponenty.

.. _czdax-pmp0201:

**CZDAX-PMP0201**: Výsledkem každé datové události MUSÍ být vznik nebo zánik alespoň
jedné datové komponenty.


.. _czdax-pmp0202:

**CZDAX-PMP0202**: Pokud existuje související vnitřní či vnější změna v evidenci,  
MĚLA BY být zapsána formou odkazu u této události. Odkaz na změnu se zapisuje 
pomocí role ``out`` (viz `outcome <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_
a s uvedením příslušného identifikátoru ``CZ_NAD_VNIZ``, resp. ``CZ_NAD_VNEZ`` (viz :ref:`struktura_premis_slovnik`).


.. list-table:: Události s dopadem na datový obsah balíčku
   :widths: 20 50
   :header-rows: 1

   * - Událost
     - Význam
   * - | **ingestion**
       | :ref:`přejímka <struktura_packageinfo_ingest>`
     - Váže se k celé reprezentaci a balíčku, viz :ref:`struktura_packageinfo_ingest`.
   * - | **creation**
       | :ref:`vznik a digitalizace <struktura_uchovaní_evt_cre>`
     - | Dokumentace individuální komponenty vzniklé jiným způsobem,
       | než je výběr archiválií od původce, např: digitalizace analogových archiválií.
   * - | **deletion**
       | :ref:`smazání <struktura_uchovaní_evt_del>`
     - Dokumentace individuálního zániku dříve existující komponenty (skartace, delimitace).
   * - | **migration**
       | :ref:`formátová migrace <struktura_uchovaní_evt_mig>`
     - | Migrace dat z jednoho formátu na jiný. Jedna nebo více komponent 
       | může být migrováno na jednu nebo více jiných komponent.
   * - | **packing**
       | :ref:`zabalení <struktura_uchovaní_evt_pac>`
     - | Přidání jedné nebo více komponent do obalujícího kontejneru, např. do formátu ZIP.
   * - | **unpacking**
       | :ref:`rozbalení <struktura_uchovaní_evt_unp>`
     - | Extrakce jedné nebo více komponent z kontejneru a jeho zánik, např. z formátu ZIP.


.. _struktura_uchovaní_evt_cre:

Vznik a digitalizace
---------------------

Datový balíček může být obohacen jiným způsobem, než je formální akt :ref:`přejímky <struktura_packageinfo_ingest>`.
Příkladem je digitalizace analogových archiválií, k nimž existují digitální metadata.

Jedná se o událost, která může být spojena s vnitřní či vnější změnou, může u ní vystupovat jeden 
nebo několik aktérů. Výsledkem události jsou nové doposud neexistující komponenty v balíčku.


.. _czdax-pmp0203:

**CZDAX-PMP0203**: Vznik či digitalizace obsahu MUSÍ být zapsána jako událost 
typu **cre** (viz `creation <https://id.loc.gov/vocabulary/preservation/eventType/cre.html>`_) 
v elementu :xml:`eventType`.


.. _czdax-pmp0204:

**CZDAX-PMP0204**: Událost vzniku či digitalizace MUSÍ mít uveden alespoň 
jeden (či několik) výsledných datových souborů. Výsledkem MŮŽE být odkaz 
na celou reprezentaci namísto jednotlivých komponent. Výsledek MUSÍ být 
zapsán pomocí role ``out`` (viz `outcome <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením příslušného identifikátoru komponenty, případně reprezentace.


.. _struktura_uchovaní_evt_del:

Smazání
------------------

Z datového balíčku mohou být odstraněny v důsledku delimitace jeho jednotlivé 
datové komponenty. Každé odstranění je nutné zdokumentovat pomocí příslušné 
události. Jako vstup do události smazání se zapisují jednotlivé odstraňované 
komponenty.


.. _czdax-pmp0205:

**CZDAX-PMP0205**: Smazání jedné nebo více komponent MUSÍ být zapsáno jako událost 
typu **del** (viz `deletion <https://id.loc.gov/vocabulary/preservation/eventType/del.html>`_) 
v elementu :xml:`eventType`.


.. _czdax-pmp0206:

**CZDAX-PMP0206**: Událost smazání MUSÍ mít uveden vztah na jednotlivé 
datové soubory, které jsou v jejím důsledku dále neplatné. 
Odkaz je realizován pomocí role ``sou`` (viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru.



.. code-block:: xml
  :caption: Příklad smazání komponenty

  <event>
    <eventIdentifier>
      <eventIdentifierType>local</eventIdentifierType>
      <eventIdentifierValue>uuid-5f17a93d-447f-4762-bee7-183a7a9eb24c</eventIdentifierValue>
    </eventIdentifier>
    <eventType>del</eventType>
    <eventDateTime>2023-08-21T12:58:30+02:00</eventDateTime>
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-8e78c90f-21e6-4799-a77a-2700c34bc9b2</linkingObjectIdentifierValue>
      <linkingObjectRole>sou</linkingObjectRole>
    </linkingObjectIdentifier>
    <!-- odkaz na související vnitřní změnu -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>CZ_NAD_VNIZ</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>100/2023</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>
  </event>



.. _struktura_uchovaní_evt_mig:

Formátová migrace
------------------

Formátové migrace umožňují z jednoho nebo více souborů vytvořit nové datové komponenty. 
Jsou podporovány různé scénáře převodů, nejobvyklejší je převod 1:1, tj. z jedné vstupní 
komponenty vzniká jedna výstupní. Obecněji jsou možné i složitější migrace, když z *n* vstupních 
komponent vzniká *m* nových komponent. Při formátové migraci se uvede krom vstupních 
a výstupních komponent také odkaz na aplikaci použitou pro migraci, případně lze formou 
doplňujících informací zapsat protokol o převodu.

Pokud dochází k vzájemně nezávislé migraci více komponent, dokumentuje se každá z těchto 
migrací v samostatné události.


.. _czdax-pmp0207:

**CZDAX-PMP0207**: Formátová migrace komponent MUSÍ být zapsána jako událost 
typu **mig** (viz `migration <https://id.loc.gov/vocabulary/preservation/eventType/mig.html>`_) 
v elementu :xml:`eventType`.


.. _czdax-pmp0208:

**CZDAX-PMP0208**: Událost formátové migrace MUSÍ mít uveden vztah na jednotlivé 
datové komponenty, které jsou předmětem migrace. Minimálně MUSÍ být uvedena alespoň jedna vstupující 
komponenta.
Odkaz je realizován pomocí role ``sou`` (viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru vstupující komponenty.

.. _czdax-pmp0209:

**CZDAX-PMP0209**: Událost formátové migrace MUSÍ mít uveden vztah na jednotlivé 
datové komponenty, které jsou výsledkem migrace. Minimálně MUSÍ být uvedena alespoň jedna 
komponenta, která je výsledkem migrace.
Odkaz na výsledek MUSÍ být zapsán pomocí role ``out`` (viz `outcome <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru vstupující komponenty.


.. _czdax-pmp0210:

**CZDAX-PMP0210**: Software nebo postup použitý pro migraci MUSÍ být 
zaznamenán pomocí sémantické jednotky **linkingAgentIdentifier**, a to rolí 
v elementu :xml:`<linkingAgentRole>` s hodnotou ``imp`` (viz `implementer <https://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole/imp.html>`_).


.. _czdax-pmp0211:

**CZDAX-PMP0211**: Doplňující informace o migraci, její parametry apod. MOHOU být 
zaznamenány v sémantické jednotce **eventDetail**, resp. v odpovídajícím elementu
:xml:`<eventDetail>`.



.. _struktura_uchovaní_evt_pac:

Zabalení
------------------

Událost zabalení dokumentuje vložení jedné nebo více komponent do jednoho 
kontejneru (např. ve formátu ZIP, PDF apod.). Při zabalení dochází ke vzniku nebo 
rozšíření datové komponenty o definované dříve samostatné komponenty. 
Při akci zabalení nedochází ke zneplatnění zdrojových komponent, resp. tento akt je možné 
zdokumentovat formou samostatné návazné události :ref:`struktura_uchovaní_evt_del`.
 

.. _czdax-pmp0212:

**CZDAX-PMP0212**: Zabalení komponent MUSÍ být zapsáno jako událost 
typu **pac** (viz `packing <https://id.loc.gov/vocabulary/preservation/eventType/pac.html>`_) 
v elementu :xml:`eventType`.


.. _czdax-pmp0213:

**CZDAX-PMP0213**: Událost zabalení MUSÍ mít uveden vztah na jednotlivé 
datové komponenty, které jsou předmětem vložení do kontejneru. Minimálně MUSÍ být uvedena alespoň jedna vstupující 
komponenta.
Odkaz je realizován pomocí role ``sou`` (viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru vstupující komponenty.


.. _czdax-pmp0214:

**CZDAX-PMP0214**: Událost zabalení MUSÍ mít uveden vztah na právě 
jednu komponentu, která je výsledkem operace.
Odkaz na výsledek MUSÍ být zapsán pomocí role ``out`` (viz `outcome <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením příslušného identifikátoru výsledné komponenty.

.. note:: 

  V případě postupného vkládání více komponent do jednoho kontejneru může
  existovat více operací zabalení se shodným výsledným kontejnerem.



.. _czdax-pmp0215:

**CZDAX-PMP0215**: Software použitý pro zabalení BY MĚL být 
zaznamenán pomocí sémantické jednotky **linkingAgentIdentifier**, a to rolí 
v elementu :xml:`<linkingAgentRole>` s hodnotou ``imp`` (viz `implementer <https://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole/imp.html>`_).



.. _struktura_uchovaní_evt_unp:

Rozbalení
------------------

Událost rozbalení dokumentuje samostatné uložení (extrakci) jedné nebo více 
komponent z jednoho kontejneru (např. ve formátu ZIP, PDF apod.). 
Při rozbalení dochází ke vzniku nových samostatných datových komponent. 
Při akci rozbalení nedochází ke změně zdrojových komponent. Pokud je zapotřebí 
vyjádřit v důsledku rozbalení vznik nového kontejneru s jiným obsahem (např. bez rozbalených komponent),
může být tento nový kontejner dalším výsledkem operace rozbalení. 
Má-li dojít k zániku původního zdrojového kontejneru, lze to zapsat formou
návazné události :ref:`struktura_uchovaní_evt_del`.


.. _czdax-pmp0216:

**CZDAX-PMP0216**: Rozbalení komponent MUSÍ být zapsáno jako událost 
typu **unp** (viz `unpacking <https://id.loc.gov/vocabulary/preservation/eventType/unp.html>`_) 
v elementu :xml:`eventType`.


.. _czdax-pmp0217:

**CZDAX-PMP0217**: Událost rozbalení MUSÍ mít uveden vztah na právě 
jednu komponentu, která je předmětem rozbalení.
Odkaz na zdroj MUSÍ být zapsán pomocí role ``sou`` (viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru vstupující komponenty.


.. _czdax-pmp0218:

**CZDAX-PMP0218**: Událost rozbalení MUSÍ mít uveden vztah na jednotlivé 
datové komponenty, které jsou předmětem vložení do kontejneru. Minimálně MUSÍ být uvedena alespoň jedna 
nová výsledná komponenta vzniklá v důsledku rozbalení.
Odkaz je realizován pomocí role ``out`` (viz `outcome <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením příslušného identifikátoru nové komponenty.


.. _czdax-pmp0219:

**CZDAX-PMP0219**: Software použitý pro rozbalení BY MĚL být 
zaznamenán pomocí sémantické jednotky **linkingAgentIdentifier**, a to rolí 
v elementu :xml:`<linkingAgentRole>` s hodnotou ``imp`` (viz `implementer <https://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole/imp.html>`_).


.. _struktura_uchovaní_evtmtdata:

Metadatové události
====================

Metadatovými událostmi rozumíme takové, které mají dopad pouze na metadatovou část balíčku.
Následující tabulka poskytuje přehled událostí, které lze reprezentovat v metadatech 
o uchovávání, a jejich význam.

.. list-table:: Události s dopadem na metadata
   :widths: 20 50
   :header-rows: 1

   * - Událost
     - Význam
   * - | **creation**
       | :ref:`vznik metadat <struktura_uchovaní_evtmtdata_cre>`
     - | Vznik významných metadatových souborů lze samostatně dokumentovat.
       | Používá se při zápisu :ref:`kontextuálního archivního popisu <struktura_archdesc_kontext>`
       | do DA.
   * - | **fixity check**
       | :ref:`kontrola neporušenosti obsahu <struktura_uchovaní_evtmtdata_fix>`
     - | Pro jednu nebo více komponent lze provést výpočet kontrolního součtu,
       | či ověřit neměnnost obsahu pomocí vhodných kryptografických funkcí.
   * - | **virus check**
       | :ref:`antivirová kontrola <struktura_uchovaní_evtmtdata_vir>`
     - | Pro reprezentaci či komponentu lze provádět antivirovou kontrolu 
       | a zapsat její výsledek.
   * - | **format identification**
       | :ref:`identifikace formátů <struktura_uchovaní_evtmtdata_for>`
     - | Identifikace formátů pomocí daného nástroje. Je možné uvést jeho verzi
       | a čas provedení identifikace.
   * - | **validation**
       | :ref:`validace <struktura_uchovaní_evtmtdata_val>`
     - | Informace o provedení formátové kontroly ve smyslu správnosti formátu
       | a souladu s příslušnou specifikací.



.. _czdax-pmp0301:

**CZDAX-PMP0301**: Každá metadatová událost MUSÍ mít uveden vztah na jednotlivé 
datové soubory, nad nimiž probíhá. Pokud operace probíhá nad celou reprezentací 
a výsledek události není rozdílný pro jednotlivé její části, MŮŽE být vztah uveden
k celé reprezentaci namísto vztahu ke každé jednotlivé komponentě.
Odkaz je realizován pomocí role ``sou`` (viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru.


.. _czdax-pmp0302:

**CZDAX-PMP0302**: Výstup operace MŮŽE být zapsán v sémantické jednotce 
**eventOutcomeInformace**, a to konkrétně v elementech :xml:`<eventOutcome>`
a :xml:`<eventOutcomeDetailNote>`. V obou elementech se uvádí nestrukturovaná 
textová informace, která umožňuje lépe porozumět výsledku operace.

.. _struktura_uchovaní_evtmtdata_cre:

Vznik metadat
-------------

Datový balíček může být obohacen o další metadata.
Příkladem je :ref:`kontextuální archivní popis <struktura_archdesc_kontext>` vytvářený ve specializované aplikaci.

U této události může vystupovat jeden nebo několik aktérů. Výsledkem události jsou 
nová nebo aktualizovaná metadata v balíčku.

.. _czdax-pmp0303:

**CZDAX-PMP0303**: Vznik kontextuálního popisu MUSÍ být zapsán jako událost 
typu **cre** (viz `creation <https://id.loc.gov/vocabulary/preservation/eventType/cre.html>`_) 
v elementu :xml:`eventType`, vztahující se k dané komponentě.


.. _czdax-pmp0304:

**CZDAX-PMP0304**: Událost vzniku (změny) metadat MUSÍ mít uveden alespoň 
jeden (či několik) výsledných datových souborů. Výsledek MUSÍ být 
zapsán pomocí role ``out`` (viz `outcome <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením příslušného identifikátoru komponenty.


.. _struktura_uchovaní_evtmtdata_fix:

Kontrola neporušenosti obsahu
-------------------------------

.. _czdax-pmp0305:

**CZDAX-PMP0305**: Kontrola neporušenosti obsahu MUSÍ být zapsána jako událost 
typu **fix** (viz `fixity check <https://id.loc.gov/vocabulary/preservation/eventType/fix.html>`_) 
v elementu :xml:`eventType`.


.. _czdax-pmp0306:

**CZDAX-PMP0306**: Software použitý pro výpočet kontrolního součtu BY MĚL být 
zaznamenán pomocí sémantické jednotky **linkingAgentIdentifier**, a to rolí 
v elementu :xml:`<linkingAgentRole>` s hodnotou ``val`` (viz `validator <https://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole/val.html>`_).


.. code-block:: xml
  :caption: Příklad kontroly neporušení obsahu

  <event>
    <eventIdentifier>
      <eventIdentifierType>local</eventIdentifierType>
      <eventIdentifierValue>uuid-f225a257-331d-4eb2-ac5f-dba44b3391cb</eventIdentifierValue>
    </eventIdentifier>
    <eventType>fix</eventType>
    <eventDateTime>2023-08-21T12:58:30+02:00</eventDateTime>
    <linkingAgentIdentifier>
      <linkingAgentIdentifierType>local</linkingAgentIdentifierType>
      <linkingAgentIdentifierValue>uuid-18074e4a-05e5-492b-9a21-a650baca17c8</linkingAgentIdentifierValue>
      <linkingAgentRole>val</linkingAgentRole>
    </linkingAgentIdentifier>
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-8e78c90f-21e6-4799-a77a-2700c34bc9b2</linkingObjectIdentifierValue>
      <linkingObjectRole>sou</linkingObjectRole>
    </linkingObjectIdentifier>    
  </event>



.. _struktura_uchovaní_evtmtdata_vir:

Antivirová kontrola
----------------------

.. _czdax-pmp0307:

**CZDAX-PMP0307**: Antivirová kontrola obsahu MUSÍ být zapsána jako událost 
typu **vir** (viz `virus check <https://id.loc.gov/vocabulary/preservation/eventType/vir.html>`_) 
v elementu :xml:`eventType`.


.. _czdax-pmp0308:

**CZDAX-PMP0308**: Software použitý pro antivirovou kontrolu BY MĚL být 
zaznamenán pomocí sémantické jednotky **linkingAgentIdentifier**, a to rolí 
v elementu :xml:`<linkingAgentRole>` s hodnotou ``val`` (viz `validator <https://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole/val.html>`_).

.. _czdax-pmp0309:

**CZDAX-PMP0309**: Antivirová kontrola se MUSÍ vztahovat na jeden 
nebo více datových souborů (případně celou reprezentaci), které jsou kontrolovány.
Odkaz je realizován pomocí role ``sou`` (viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru.

.. _czdax-pmp0310:

**CZDAX-PMP0310**: Výsledek antivirové kontroly MUSÍ být uveden v sémantické 
jednotce **eventOutcome** v elementu :xml:`<eventOutcome>`. V závislosti na 
výsledku kontroly MUSÍ být uvedena jedna z hodnot: **SUCCESS** (hrozba nenalezena)
nebo **VIRUS_THREAT** (zjištěna alespoň jedna hrozba). V případě zjištění hrozby 
MUSÍ být podrobnosti uvedeny v elementu :xml:`<eventOutcomeDetailNote>`.

.. _struktura_uchovaní_evtmtdata_for:

Identifikace formátů
----------------------

.. _czdax-pmp0311:

**CZDAX-PMP0311**: Identifikace formátů MUSÍ být zapsána jako událost 
typu **for** (viz `format identification <https://id.loc.gov/vocabulary/preservation/eventType/for.html>`_) 
v elementu :xml:`eventType`.

.. _czdax-pmp0312:

**CZDAX-PMP0312**: Software nebo postup použitý pro identifikaci formátů BY MĚL být 
zaznamenán pomocí sémantické jednotky **linkingAgentIdentifier**, a to rolí 
v elementu :xml:`<linkingAgentRole>` s hodnotou ``val`` (viz `validator <https://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole/val.html>`_).

.. _czdax-pmp0313:

**CZDAX-PMP0313**: Identifikace formátů MUSÍ probíhat nad jedním
nebo více datovými soubory (případně celou reprezentací), které jsou kontrolovány.
Odkaz je realizován pomocí role ``sou`` (viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru.


.. _struktura_uchovaní_evtmtdata_val:

Validace
-----------------

Událost validace se používá pro záznam o provedení obsahové 
či formátové validace datového souboru.

.. _czdax-pmp0314:

**CZDAX-PMP0314**: Validace MUSÍ být zapsána jako událost 
typu **val** (viz `format identification <https://id.loc.gov/vocabulary/preservation/eventType/for.html>`_) 
v elementu :xml:`eventType`.


.. _czdax-pmp0315:

**CZDAX-PMP0315**: Software použitý pro validaci BY MĚL být 
zaznamenán pomocí sémantické jednotky **linkingAgentIdentifier**, a to rolí 
v elementu :xml:`<linkingAgentRole>` s hodnotou ``val`` (viz `validator <https://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole/val.html>`_).

.. _czdax-pmp0316:

**CZDAX-PMP0316**: Validace MUSÍ probíhat nad jedním
nebo více datovými soubory (případně celou reprezentací), které jsou kontrolovány.
Odkaz je realizován pomocí role ``sou`` (viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou)
s uvedením příslušného identifikátoru.