.. _struktura_packageinfo:

========================
Informace o balíčku
========================

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

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


Základní informace o historii balíčku, jeho vztahu k archivnímu souboru, 
informace o původci a přejímce, včetně případných předchozích identifikátorů 
jsou uchovány v metadatovém souboru ve formátu :ref:`PREMIS <metodika_standardy_premis>` 
pojmenovaném :file:`PACKAGE-INFO.xml`.

Soubor obsahuje:

 * informace o přejímce
 * informace o archivním fondu a pečujícím archivu
 * informace o původci
 * identifikátory balíčku

Součástí zaznamenaných informací je i historie změn uložení v :term:`digitálním archivu <digitální archiv>`, 
změny příslušnosti k archivnímu souboru a změny v :term:`pečujícím archivu <pečující archiv>`.

.. _czdax-pkg0001:

**CZDAX-PKG0001**: Soubor :file:`PACKAGE-INFO.xml` obsahující základní informace o celém balíčku,
jeho původu a :term:`dlouhodobém uchovávání <dlouhodobé uchovávání>` MUSÍ být součástí 
:term:`administrativních metadat <administrativní metadata>` v souladu se způsobem
jejich odkazování a zápisu dle :ref:`struktura_mets_amdSec`.


Podporované scénáře pro uložení informací jsou:
 * informace o vzniku archiválií a jejich původci
 * zachycení informací o přejímce, jejím času, předávající a přejímající straně
 * možnost vzniku balíčku na základě vnitřní změny
 * možnost přenosu balíčku mezi archivy
 * zachování historických identifikátorů balíčků navázaných na archivní péči v daném čase


.. _struktura_packageinfo_funds:

Archivní soubor
==================

Archivní soubor (fond) je reprezentován formou intelektuální entity. Tato intelektuální entita
má přiřazen svůj identifikátor, uvádí se povinně také identifikátor v rámci evidence NAD 
a příslušnost k archivu. Volitelnou součástí je uvedení názvu archivního souboru.

.. _czdax-pkg0101:

**CZDAX-PKG0101**: Každý archivní soubor, na nějž je odkazováno v rámci :ref:`PREMIS <metodika_standardy_premis>`, 
MUSÍ být popsán v samostatném elementu :xml:`<object>` jako intelektuální entita, tj. v podobě:
:xml:`<object xsi:type="intellectualEntity">`.

.. _czdax-pkg0102:

**CZDAX-PKG0102**: Odkaz na archivní soubor MUSÍ být tvořen jeho lokálním identifikátorem
(viz :ref:`CZDAX-PMS0201 <czdax-pms0201>`). Dále MUSÍ být uvedeno číslo archivního souboru v evidenci NAD. 
To se zapisuje v :xquery:`objectIdentifier/objectIdentifierType[.="FONDS_ID"]` a uvedením 
čísla v :xquery:`objectIdentifier/objectIdentifierValue[.="číslo archivního souboru"]`.

.. _czdax-pkg0103:

**CZDAX-PKG0103**: Objekt reprezentující odkaz na archivní soubor MŮŽE obsahovat volitelný
element :xml:`<originalName>` obsahující jméno archivního souboru v souladu s evidencí NAD.

.. _czdax-pkg0104:

**CZDAX-PKG0104**: Každý archivní soubor, na nějž je odkazováno, MUSÍ mít uveden formou významné 
vlastnosti identifikátor archivu do jehož evidence patří. 
Odkaz na archiv se zapisuje v :xquery:`significantProperties/significantPropertiesType[.="INSTITUTION_ID"]` 
a uvedením čísla archivu v :xquery:`significantProperties/significantPropertiesValue[.="číslo archivu"]`.

.. code-block:: xml
  :caption: Příklad archivního souboru

  <object xsi:type="intellectualEntity">
    <objectIdentifier>
      <objectIdentifierType>local</objectIdentifierType>
      <objectIdentifierValue>uuid-c1e39569-6ff5-415d-a752-903988080c03</objectIdentifierValue>
    </objectIdentifier>
    <objectIdentifier>
      <objectIdentifierType>FONDS_ID</objectIdentifierType>
      <objectIdentifierValue>425</objectIdentifierValue>
    </objectIdentifier>
   <!-- Příslušnost fondu k archivu -->
   <significantProperties>
      <significantPropertiesType>INSTITUTION_ID</significantPropertiesType>
      <significantPropertiesValue>100000010</significantPropertiesValue>
    </significantProperties>
    <originalName>Veselý Hubert, JUDr.</originalName>
  </object>


.. _struktura_packageinfo_representation:

Reprezentace
==================

Předaná data při přejímce jsou součástí samostatné reprezentace dle pravidla 
:ref:`CZDAX-PSP0110 <czdax-psp0110>`. Tato výchozí reprezentace tvoří základní 
datový obsah balíčku. V informacích o balíčku vystupuje minimálně dvakrát:

 - v události vzniku archiválií
 - v události přejímky archiválií do digitálního archivu

Z tohoto důvodu je nutné uvést reprezentaci obsahující data od původce jako samostatný 
objekt v rámci informací o balíčku.

.. _czdax-pkg0201:

**CZDAX-PKG0201**: Součástí základních informací o balíčku MUSÍ být 
objekt reprezentace, která obsahuje data z přejímky. Objekt reprezentace 
MUSÍ mít podobu dle :ref:`struktura_premis_representation`. Tato reprezentace 
MUSÍ být pojmenována ``submission``.


.. code-block:: xml
  :caption: Příklad reprezentace

  <object xsi:type="representation">
    <objectIdentifier>
      <objectIdentifierType>local</objectIdentifierType>
      <objectIdentifierValue>uuid-a13c7fb3-caad-4505-8a3e-144fc6dca744</objectIdentifierValue>
    </objectIdentifier>
    <originalName>submission</originalName>
  </object>



.. _struktura_packageinfo_package:

Balíček
============

V případě událostí v PREMIS je nutné mít možnost zachytit objekt samotného balíčku. 
V případě delimitací, migrací či jiných změn balíčků je vhodné mít možnost odkazovat 
i na další balíčky, a to zejména z důvodu možnosti zachycení jejich původních 
identifikátorů a vyjádření vztahu k aktuálnímu balíčku.

Pokud dochází ke změně identifikátoru balíčku, tak se jedná o novou intelektuální entitu.


.. _czdax-pkg0301:

**CZDAX-PKG0301**: Každý balíček, na nějž je odkazováno v rámci :ref:`PREMIS <metodika_standardy_premis>`,
MUSÍ být popsán v samostatném elementu :xml:`<object>` s uvedením typu ``intellectualEntity``, tj. v podobě:
:xml:`<object xsi:type="intellectualEntity">`. NESMÍ být uváděn žádný balíček, který nemá 
vztah k aktuálnímu balíčku a na nějž není odkazováno z příslušného souboru :file:`PACKAGE-INFO.xml`.


.. _czdax-pkg0302:

**CZDAX-PKG0302**: Všechny objekty balíčků MUSÍ mít uveden lokální identifikátor typu ``local``.
Pro objekt aktuálního balíčku, v němž je :file:`PACKAGE-INFO.xml`, se použije speciální hodota ``_THIS``
v souladu s :ref:`CZDAX-PMS0202 <czdax-pms0202>`.
Pro všechny ostatní balíčky MUSÍ mít lokální identifikátor podobu UUID dle 
:ref:`CZDAX-PMD0101 <czdax-pmd0101>`.


.. _czdax-pkg0303:

**CZDAX-PKG0303**: Pokud je znám identifikátor balíčku z předchozího uložení,
MĚL BY být u balíčku uveden. Jako typ identifikátoru se uvede ``AIP_ID``. Informace o uložení 
balíčku, resp. vztah k danému archivu je určen událostí, v níž balíček vystupuje.


.. _czdax-pkg0304:

**CZDAX-PKG0304**: Balíček MUSÍ mít uveden nanejvýš jeden platný identifikátor ``AIP_ID``
dle :ref:`CZDAX-PKG0303 <czdax-pkg0303>`.
Platný identifikátor balíčku se NEMUSÍ uvádět při použití speciální hodnoty ``_THIS`` 
v souladu s :ref:`CZDAX-PMS0202 <czdax-pms0202>`.


.. code-block:: xml
  :caption: Příklad objektu aktuálního balíčku

    <object xsi:type="intellectualEntity">
    <!-- Definice vlastního balíčku -->
    <objectIdentifier>
      <objectIdentifierType>local</objectIdentifierType>
      <objectIdentifierValue>_THIS</objectIdentifierValue>
    </objectIdentifier>
  </object>



.. code-block:: xml
  :caption: Příklad objektu balíčku uloženého v jiném digitálním archivu

  <object xsi:type="intellectualEntity">
    <!-- Definice vlastního balíčku -->
    <objectIdentifier>
      <objectIdentifierType>local</objectIdentifierType>
      <objectIdentifierValue>uuid-f09b8c3f-7ddd-4797-b9a5-6f854c370c5b</objectIdentifierValue>
    </objectIdentifier>

    <!-- Volitelné vyjádření ID balíčku v DA -->
    <objectIdentifier>
      <objectIdentifierType>AIP_ID</objectIdentifierType>
      <objectIdentifierValue>83552</objectIdentifierValue>
    </objectIdentifier>

    <!-- Volitelné uvedení verze balíčku, povinně se uvádí při poskytnutí 
         samotného PACKAGE-INFO.xml pro zpracování.
         -->
    <significantProperties>
      <significantPropertiesType>AIP_VERSION</significantPropertiesType>
      <significantPropertiesValue>verze balíčku</significantPropertiesValue>
    </significantProperties>

    <!-- Volitelné vyjádření velikosti balíčku -->
    <significantProperties>
      <significantPropertiesType>AIP_SIZE</significantPropertiesType>
      <significantPropertiesValue>velikost v bytech</significantPropertiesValue>
    </significantProperties>

  </object>



.. _struktura_packageinfo_arch_ent:

Agenti - osoby, korporace, archivy
======================================

V událostech vystupují formou rolí jednotliví agenti. 
Agentem se rozumí archivní entita, resp. osoba, korporace, či 
:term:`archiv`. Může se jednat o plně nebo částečně identifikované 
entity. Pro jejich definici je v PREMIS určena sémantická 
jednotka agent, resp. element :xml:`<agent>`.

Agenti jsou určeni svým lokálním identifikátorem, názvem a případně dalšími 
identifikátory z jiných systémů (CAM, celostátní evidence archivů).


.. _czdax-pkg0401:

**CZDAX-PKG0401**: Každý agent (osoba, korporace, archiv) BY MĚL mít uveden 
doplňující identifikátor/-y z jiného systému, které umožní jeho přesnou identifikaci. 
Typ identifikátoru MUSÍ být jeden z:

 - ``CAM_ID`` - identifikátor entity v systému CAM
 - ``INSTITUTION_ID`` - identifikátor archivu v celostátní evidenci archivů


.. _czdax-pkg0402:

**CZDAX-PKG0402**: Každý agent MUSÍ mít uveden svůj název, resp. jméno. To se uvádí 
v elementu :xml:`<agentName>`. Agent MŮŽE mít více názvů, první uvedený se považuje 
za preferované označení, další za variantní označení.


.. _czdax-pkg0403:

**CZDAX-PKG0403**: Každý agent MUSÍ mít určen typ. Ten určuje, zda se jedná o osobu 
nebo korporaci. Typ agenta se uvádí v elementu :xml:`<agentType>` a musí být jedním z typů:

 - ``per`` pro osoby (`person <https://id.loc.gov/vocabulary/preservation/agentType/per.html>`)
 - ``org`` pro korporace (`organization <https://id.loc.gov/vocabulary/preservation/agentType/org.html>`)

Pro jiné typy archivních entit (události, rod/rodina) se MUSÍ jako typ uvést ``organization``.


.. code-block:: xml
  :caption: Příklad uvedení osoby předávající, původce

  <agent>
    <agentIdentifier>
      <agentIdentifierType>local</agentIdentifierType>
      <agentIdentifierValue>uuid-916d7dc2-b19e-43d4-ba28-4c87b5d7c697</agentIdentifierValue>
    </agentIdentifier>
    <!-- Volitelný identifikátor v CAM 
         Lze uvádět i jiné typy identifikátorů, viz dále INSTITUTION_ID
      -->
    <agentIdentifier>
      <agentIdentifierType>CAM_ID</agentIdentifierType>
      <agentIdentifierValue>120348</agentIdentifierValue>
    </agentIdentifier>
    <!-- Musí obsahovat pref. označení -->
    <agentName>Česká tisková kancelář</agentName>
    <agentType>org</agentType>
  </agent>





.. _struktura_package_create:

Vznik archiválií
===================

Základní informací o balíčku a jeho obsahu je informace o vzniku uchovávaných archiválií.
Vznik archiválií je popsán alespoň v rozsahu datace vzniku, odkazu na původce archiválií
a odkazu na jejich reprezentaci.

.. _czdax-pkg0501:

**CZDAX-PKG0501**: Vznik archiválií MUSÍ být popsán v rámci :file:`PACKAGE-INFO.xml`
pomocí samostatné události typu ``cre``, resp. ``creation`` dle řízeného slovníku: 
https://id.loc.gov/vocabulary/preservation/eventType/cre.html. Událost je popisem 
vzniku archiválií na straně původce.


.. _czdax-pkg0502:

**CZDAX-PKG0502**: U události MUSÍ být uvedena datace vzniku archiválií. Zapisuje se 
dle definice :ref:`struktura_premis_datetime`. Vždy MUSÍ být uvedena platná datace, 
případně její odhad, tj. neznámá hodnota datace NESMÍ být použita.


.. _czdax-pkg0503:

**CZDAX-PKG0503**: Původce archiválií reprezentovaný agentem MUSÍ být uveden pomocí 
vztahu ``ORIGINATOR``. V rámci jedné události MŮŽE být uvedeno více původců.


.. _czdax-pkg0504:

**CZDAX-PKG0504**: Událost vzniku MUSÍ odkazovat na odpovídající reprezentaci,
kde jsou data a metadata od daného původce. Odkaz je realizován vztahem na objekt
:ref:`reprezentace <struktura_premis_representation>` pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out).


.. code-block:: xml
  :caption: Příklad uvedení vzniku archiválií

  <event>
    <eventIdentifier>
      <eventIdentifierType>local</eventIdentifierType>
      <eventIdentifierValue>uuid-27c8a259-7cf5-47e2-9bce-3b3da7f7c063</eventIdentifierValue>
    </eventIdentifier>
    <!-- Určení, že se jedná o vznik -->
    <eventType>cre</eventType>
    <eventDateTime>2020-10-12/2023-05-16</eventDateTime>

    <linkingAgentIdentifier>
      <linkingAgentIdentifierType>local</linkingAgentIdentifierType>
      <linkingAgentIdentifierValue>uuid-916d7dc2-b19e-43d4-ba28-4c87b5d7c697</linkingAgentIdentifierValue>
      <!-- původce -->
      <linkingAgentRole>ORIGINATOR</linkingAgentRole>
    </linkingAgentIdentifier>
    <!-- odkaz na submission -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-a13c7fb3-caad-4505-8a3e-144fc6dca744</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>
  </event>


.. _struktura_packageinfo_ingest:

Vložení do digitálního archivu
========================================

Vložení do digitálního archivu (tzv. ingest) je zachyceno jako samostatná událost.
U události se uvede čas vložení, formou rolí se zachytí předávající osoba a přejímající 
archiv, zdrojem pro vložení je obvykle vstupní informační balíček. 
Pomocí napojených odkazů je možné zachytit identifikátory souvisejících externích objektů 
(přejímka, číslo jednací, vnější či vnitřní změna).

Vložení do digitálního archivu může nastat nejen na základě předání archiválií od původce, 
ale například i jejich dohledáním (z evidenčního hlediska vnitřní změnou). 

K události vložení do digitálního archivu dochází také při předání balíčku z jednoho do jiného digitálního archivu, 
případně i při jiné situaci, kdy dochází ke změně čísla (primární identifikace) balíčku.
Při přenosu dat mezi dvěma digitálními archivy je zdrojem dat nikoliv reprezentace, ale 
příslušný zdrojový plně identifikovaný balíček.

.. _czdax-pkg0601:

**CZDAX-PKG0601**: Vložení archiválií do digitálního archivu MUSÍ být popsáno 
v rámci :file:`PACKAGE-INFO.xml` pomocí samostatné události typu ``ing``, 
resp. ``ingestion`` dle řízeného slovníku: https://id.loc.gov/vocabulary/preservation/eventType/ing.html.
Událost zachycuje relevantní část z přejímky, na jejímž základě došlo k převzetí 
archiválií.

.. _czdax-pkg0602:

**CZDAX-PKG0602**: U události MUSÍ být uveden datum a případně čas přejímky. Zapisuje se 
dle definice :ref:`struktura_premis_datetime`, případně se uvede, že informace není známa.

.. _czdax-pkg0603:

**CZDAX-PKG0603**: Předávající strana MUSÍ být zapsána formou agenta a MUSÍ být uvedena pomocí 
vztahu ``SUBMITTER``. V rámci jedné události MŮŽE být uveden nanejvýš jeden předávající.

.. _czdax-pkg0604:

**CZDAX-PKG0604**: Přejímající :term:`archiv` reprezentovaný agentem MUSÍ být uveden, a to pomocí 
vztahu ``CURATOR``. V rámci jedné události MŮŽE být uveden nanejvýš jeden přejímající.

.. _czdax-pkg0605:

**CZDAX-PKG0605**: Reprezentace (viz :ref:`struktura_packageinfo_representation`), která je základem 
balíčku, MUSÍ být uvedena jako jeho zdroj. Toto je zachyceno pomocí role ``sou`` (
viz `source <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/sou). Při předání 
balíčku mezi digitálními archivy MUSÍ být jako zdroj uveden balíček uložený v předávajícím 
archivu, tj. jako zdroj se neuvede reprezentace.

.. _czdax-pkg0606:

**CZDAX-PKG0606**: Událost vložení do digitálního archivu MUSÍ odkazovat na balíček 
(viz :ref:`struktura_packageinfo_package`),
který tímto krokem vznikl. Odkaz je pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
a s uvedením lokální hodnoty identifikátoru balíčku (``local``).

.. _czdax-pkg0607:

**CZDAX-PKG0607**: Událost vložení do digitálního archivu BY MĚLA odkazovat na související 
přejímku. Odkaz je realizován pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením typu identifikátoru (sémantická jednotka linkingObjectIdentifierType) 
přejímky (``INGESTION_ID``) a jeho hodnoty.
Hodnota identifikátoru, resp. jeho význam je specifický pro daný archiv, 
který vystupuje v roli přejímajícího.

.. _czdax-pkg0608:

**CZDAX-PKG0608**: Událost vložení do digitálního archivu, resp. přejímky BY MĚLA odkazovat na související 
číslo jednací. Odkaz je realizován pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením typu identifikátoru (sémantická jednotka linkingObjectIdentifierType) 
čísla jednacího (``REFERENCE_NUMBER``) a jeho hodnoty.
Jedná se o číslo jednací přejímajícího archivu.

.. _czdax-pkg0609:

**CZDAX-PKG0609**: Událost vložení do digitálního archivu, resp. přejímky BY MĚLA odkazovat na související 
změnu v rámci evidence NAD. Odkaz je realizován pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením typu identifikátoru (sémantická jednotka linkingObjectIdentifierType) 
vnější změny (``CZ_NAD_VNEZ``) a jeho hodnoty. Číslo vnější změny je specifické pro přejímající archiv.

.. _czdax-pkg0610:

**CZDAX-PKG0610**: Pokud dochází ke vzniku archiválie pomocí události vnitřní změny, MUSÍ se 
uvést její číslo. Odkaz je realizován pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením typu identifikátoru (sémantická jednotka linkingObjectIdentifierType) 
vnitřní změny (``CZ_NAD_VNIZ``) a jeho hodnoty. Číslo vnitřní změny je specifické pro přejímající archiv.

.. _czdax-pkg0611:

**CZDAX-PKG0611**: Událost vložení do digitálního archivu MUSÍ odkazovat na archivní soubor  
(viz :ref:`struktura_packageinfo_funds`), do něhož je balíček zařazen. Odkaz je realizován pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením lokální hodnoty identifikátoru archivního souboru (``local``).


.. code-block:: xml
  :caption: Příklad události vložení archiválií

  <event>
    <eventIdentifier>
      <eventIdentifierType>local</eventIdentifierType>
      <eventIdentifierValue>uuid-27c8a259-7cf5-47e2-9bce-3b3da7f7c063</eventIdentifierValue>
    </eventIdentifier>
    <!-- Určení, že se jedná o uložení do DA -->
    <eventType>ing</eventType>
    <eventDateTime>2021-10-12T00:00:00+01:00</eventDateTime>

    <linkingAgentIdentifier>
      <linkingAgentIdentifierType>local</linkingAgentIdentifierType>
      <linkingAgentIdentifierValue>uuid-916d7dc2-b19e-43d4-ba28-4c87b5d7c697</linkingAgentIdentifierValue>
      <!-- předávající -->
      <linkingAgentRole>SUBMITTER</linkingAgentRole>
    </linkingAgentIdentifier>
  
    <!-- přejímající archiv, bylo by možné i odkazovat přímo bez uvedení jména -->
    <linkingAgentIdentifier>
      <linkingAgentIdentifierType>local</linkingAgentIdentifierType>
      <linkingAgentIdentifierValue>uuid-65863862-b2a7-4e83-8de9-62130a305b22</linkingAgentIdentifierValue>
      <linkingAgentRole>CURATOR</linkingAgentRole>
    </linkingAgentIdentifier>

    <!-- Zdrojem jsou archiválie ze submission. -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-a13c7fb3-caad-4505-8a3e-144fc6dca744</linkingObjectIdentifierValue>
      <linkingObjectRole>sou</linkingObjectRole>
    </linkingObjectIdentifier>

    <linkingObjectIdentifier>
      <!-- Event outcome - tento balíček -->
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>_THIS</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>

    <!-- Odkaz na přejímku -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>INGESTION_ID</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>5589</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>

    <!-- Číslo jednací -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>REFERENCE_NUMBER</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>NA 210823/1258</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>

    <!-- Event outcome - vnější změna -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>CZ_NAD_VNEZ</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>100/2023</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>

    <!-- Cílový archivní fond -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-c1e39569-6ff5-415d-a752-903988080c03</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>
  </event>


.. _struktura_packageinfo_transfer:

Přesun a delimitace balíčku
========================================

K události přesunu balíčku dochází v případě jeho uložení v digitálním 
archivu a změně jeho archivní péče bez nutnosti jeho exportu vně 
digitálního archivu a nového vložení do digitálního archivu. Při operaci
přesunu je zachováno číslo AIP a nedochází k jeho změně. Operace delimitace 
může obecně znamenat změnu archivního souboru, změnu archivu a někdy i změnu 
digitálního archivu. 

Při změně digitálního archivu se tato událost nepoužije a je nutné zaznamenat
dvě samostatné události: :ref:`export balíčku <struktura_packageinfo_export>` a
:ref:`vložení balíčku <struktura_packageinfo_ingest>` do digitálního archivu.

Událost přesunu se užije v případě přesunu mezi archivními soubory, a to 
v rámci jedné nebo i různých institucí/archivů, avšak vždy v rámci jednoho digitálního 
archivu.


.. _czdax-pkg0701:

**CZDAX-PKG0701**: Přesun archiválií a delimitace balíčku v rámci jednoho 
digitálního archivu MUSÍ být popsány v :file:`PACKAGE-INFO.xml` pomocí samostatné 
události typu ``tra``, resp. ``transfer`` dle řízeného slovníku: 
https://id.loc.gov/vocabulary/preservation/eventType/tra.html.
Událost zachycuje informaci o související změně v evidenci NAD.

.. _czdax-pkg0702:

**CZDAX-PKG0702**: U události MUSÍ být uvedeny datum a případně čas přesunu. Zapisuje se 
dle definice :ref:`struktura_premis_datetime`, případně se uvede, že informace není známa.

.. _czdax-pkg0703:

**CZDAX-PKG0703**: Přejímající :term:`archiv` reprezentovaný agentem MUSÍ být uveden, a to pomocí 
vztahu ``CURATOR``. V rámci jedné události MUSÍ být uveden právě jeden přejímající :term:`archiv`.

.. _czdax-pkg0704:

**CZDAX-PKG0704**: Událost přesunu MUSÍ odkazovat na předmětný balíček 
(viz :ref:`struktura_packageinfo_package`). 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 lokální hodnoty identifikátoru balíčku (``local``).

.. _czdax-pkg0705:

**CZDAX-PKG0705**: Událost přesunu BY MĚLA odkazovat na související 
změnu v rámci evidence NAD. Odkaz je realizován pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením typu identifikátoru (sémantická jednotka linkingObjectIdentifierType) 
vnější změny (``CZ_NAD_VNEZ``) nebo vnitřní změny (``CZ_NAD_VNIZ``) a jeho hodnoty. 
Číslo změny je specifické pro přejímající archiv.

.. _czdax-pkg0706:

**CZDAX-PKG0706**: Událost přesunu MUSÍ odkazovat na archivní soubor  
(viz :ref:`struktura_packageinfo_funds`), do něhož je balíček tímto přesunem nově zařazen. 
Odkaz je realizován pomocí role ``out`` (viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením lokální hodnoty identifikátoru archivního souboru (``local``).


.. code-block:: xml
  :caption: Příklad převodu balíčku

  <event>
    <eventIdentifier>
      <eventIdentifierType>local</eventIdentifierType>
      <eventIdentifierValue>uuid-27c8a259-7cf5-47e2-9bce-3b3da7f7c063</eventIdentifierValue>
    </eventIdentifier>
    <!-- Určení, že se jedná o přenos -->
    <eventType>tra</eventType>
    <eventDateTime>2023-10-12T00:00:00+01:00</eventDateTime>
    <!-- Přejímající archiv -->
    <linkingAgentIdentifier>
      <linkingAgentIdentifierType>local</linkingAgentIdentifierType>
      <linkingAgentIdentifierValue>uuid-65863862-b2a7-4e83-8de9-62130a305b22</linkingAgentIdentifierValue>
      <linkingAgentRole>CURATOR</linkingAgentRole>
    </linkingAgentIdentifier>
    <!-- Uvedeni zdrojoveho balicku -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-86164008-21af-43ab-93c5-6ac9af0cec7f</linkingObjectIdentifierValue>
      <linkingObjectRole>sou</linkingObjectRole>
    </linkingObjectIdentifier>
    <!-- Event outcome - vnější/vnitřní změna -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>CZ_NAD_VNEZ</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>100/2023</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>
    <!-- Cílový archivní fond -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-c1e39569-6ff5-415d-a752-903988080c03</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>
  </event>

.. _struktura_packageinfo_export:

Export balíčku
========================================

Událost exportu balíčku se zaznamenává, pokud se jedná o export balíčku 
do výměnného formátu za účelem jeho předání do jiného digitálního 
archivu. Po exportu balíčku následuje obvykle jeho nové vložení do jiného 
digitálního archivu s novým číslem balíčku. U operace exportu 
je možné uvést instituci provádějící export. Dále je možné
přidat odkazy na související změny v evidenci NAD (systém PEvA).

.. _czdax-pkg0801:

**CZDAX-PKG0801**: Export balíčku BY MĚL být popsán v :file:`PACKAGE-INFO.xml` pomocí samostatné 
události typu ``exp``, resp. ``export`` dle řízeného slovníku: 
https://id.loc.gov/vocabulary/preservation/eventType/exp.html.
Událost zachycuje informaci o související změně v evidenci NAD
archiválií.

.. _czdax-pkg0802:

**CZDAX-PKG0802**: U události MUSÍ být uvedeny datum a případně čas přesunu. Zapisuje se 
dle definice :ref:`struktura_premis_datetime`, případně se uvede, že informace není známa.

.. _czdax-pkg0803:

**CZDAX-PKG0803**: :term:`Archiv <archiv>` provádějící export MUSÍ být uveden, a to pomocí 
vztahu ``CURATOR``. V rámci jedné události MŮŽE být uveden nanejvýš jeden exportující.

.. _czdax-pkg0804:

**CZDAX-PKG0804**: Událost exportu MUSÍ odkazovat na předmětný balíček 
(viz :ref:`struktura_packageinfo_package`). 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 lokální hodnoty identifikátoru balíčku (``local``).
Součástí balíčku, na nějž je odkazováno, MUSÍ být jeho úplný stávající identifikátor 
v digitálním archivu uvedený pomocí identifikátoru typu (``AIP_ID``).

.. _czdax-pkg0805:

**CZDAX-PKG0805**: Událost exportu BY MĚLA odkazovat na související 
změnu v rámci evidence NAD. Odkaz je realizován pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením typu identifikátoru (sémantická jednotka linkingObjectIdentifierType) 
vnější změny (``CZ_NAD_VNEZ``) nebo vnitřní změny (``CZ_NAD_VNIZ``) a jeho hodnoty. 
Číslo změny je specifické pro přejímající archiv.

.. code-block:: xml
  :caption: Příklad exportu balíčku

  <event>
    <eventIdentifier>
      <eventIdentifierType>local</eventIdentifierType>
      <eventIdentifierValue>uuid-27c8a259-7cf5-47e2-9bce-3b3da7f7c063</eventIdentifierValue>
    </eventIdentifier>
    <!-- Určení, že se jedná o přenos -->
    <eventType>exp</eventType>
    <eventDateTime>2023-10-12T00:00:00+01:00</eventDateTime>
    <!-- Exportující archiv -->
    <linkingAgentIdentifier>
      <linkingAgentIdentifierType>local</linkingAgentIdentifierType>
      <linkingAgentIdentifierValue>uuid-65863862-b2a7-4e83-8de9-62130a305b22</linkingAgentIdentifierValue>
      <linkingAgentRole>CURATOR</linkingAgentRole>
    </linkingAgentIdentifier>
    <!-- Uvedeni zdrojoveho balicku, obsahuje AIP_ID -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-f09b8c3f-7ddd-4797-b9a5-6f854c370c5b</linkingObjectIdentifierValue>
      <linkingObjectRole>sou</linkingObjectRole>
    </linkingObjectIdentifier>
    <!-- Vnější/vnitřní změna -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>CZ_NAD_VNEZ</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>100/2023</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>
  </event>


.. _struktura_packageinfo_ipc:

Vznik balíčku
===============

Pomocí samostatné události *vznik balíčku* lze zaznamenat doplňující informace v souvislosti 
s jeho vznikem a vytvořením. Událost je primárně využívána pro uložení technických informací 
a případných vazeb mezi nimi. Není určena pro zachycení standardních archivních procesů,
jako je například :ref:`struktura_packageinfo_ingest`.


.. _czdax-pkg0901:

**CZDAX-PKG0901**: Pro každý balíček v :file:`PACKAGE-INFO.xml` BY MĚLA existovat alespoň jedna 
samostatná událost dokumentující jeho vznik. Tato událost 
je označena jako ``ipc`` (viz `information package creation <https://id.loc.gov/vocabulary/preservation/eventType/ipc.html>`_).


.. _czdax-pkg0902:

**CZDAX-PKG0902**: Událost vzniku balíčku MUSÍ odkazovat na předmětný balíček 
(viz :ref:`struktura_packageinfo_package`). Odkaz je realizován pomocí role ``out`` (
viz `output <https://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out.html>`_,
URI: http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole/out)
s uvedením lokální hodnoty identifikátoru balíčku (``local``).


.. _czdax-pkg0903:

**CZDAX-PKG0903**: Aplikace realizující vznik balíčku MUSÍ být reprezentovaná agentem, a to pomocí 
vztahu ``imp`` (viz `implementer <https://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole/imp.html>`_).
V rámci jedné události MŮŽE být uveden nanejvýš jeden vztah tohoto typu.


.. code-block:: xml
  :caption: Příklad vzniku balíčku

  <event>
    <eventIdentifier>
      <eventIdentifierType>local</eventIdentifierType>
      <eventIdentifierValue>uuid-8267a009-8a04-4162-8559-c1d79d42d8ba</eventIdentifierValue>
    </eventIdentifier>
    <!-- Určení, že se jedná o vznik balíčku -->
    <eventType>ipc</eventType>
    <eventDateTime>2023-10-12T00:00:00+01:00</eventDateTime>
    <!-- software tvořící balíček -->
    <linkingAgentIdentifier>
      <linkingAgentIdentifierType>local</linkingAgentIdentifierType>
      <linkingAgentIdentifierValue>uuid-18074e4a-05e5-492b-9a21-a650baca17c8</linkingAgentIdentifierValue>
      <linkingAgentRole>imp</linkingAgentRole>
    </linkingAgentIdentifier>
    <!-- Uvedeni balicku -->
    <linkingObjectIdentifier>
      <linkingObjectIdentifierType>local</linkingObjectIdentifierType>
      <linkingObjectIdentifierValue>uuid-f09b8c3f-7ddd-4797-b9a5-6f854c370c5b</linkingObjectIdentifierValue>
      <linkingObjectRole>out</linkingObjectRole>
    </linkingObjectIdentifier>
  </event>