.. _changes_struktura:

===============================
Struktura změnových balíčků
===============================

.. role:: xpath(code)
   :language: xslt

Formát změnových balíčků vychází ze specifikace :ref:`metodika_standardy_eark` a jejího 
českého profilu pro výměnné balíčky dle :ref:`nmet1`.

Ve změnovém balíčku se uvádějí jen soubory, které do balíčku nově přibývají a nezbytně 
nutná průvodní metadata. Změnový balíček je samostatným SIP balíčkem, a to včetně vlastního 
identifikátoru balíčku. Každý vkládaný SIP by měl mít unikátní identifikátor. Určení, 
který AIP balíček je daným změnovým balíčkem doplňován, se provede pomocí metadat 
uvedených ve vkládaném změnovém SIP balíčku.


Základní podoba balíčku
=========================

Základní požadavky na podobu SIP balíčku a jeho identifikátory:

**CZDAP-IPF0101**: Změnový balíček MUSÍ odpovídat specifikaci výměnného balíčku dle :ref:`nmet1`.

**CZDAP-IPF0102**: Identifikátor změnového balíčku MUSÍ být řetězec s délkou maximálně 50 znaků.

**CZDAP-IPF0103**: Identifikátor změnového balíčku BY MĚL mít podobu UUID dle :rfc:`9562`, verze 4.

.. _czdap-ipf0104:

**CZDAP-IPF0104**: Následující pole v kořenovém :file:`METS.xml` MUSÍ mít konkrétní uvedené hodnoty 
dle následující tabulky.

.. list-table:: Hodnoty vybraných polí v METS.xml
   :widths: 20 50 20
   :header-rows: 1

   * - Název elementu
     - Cesta v METS
     - Hodnota
   * - Content Category **czdax-pmt0103**
     - :xpath:`mets/@TYPE`
     - ``Dataset``
   * - Content Information Type Specification **czdax-pmt0105**
     - :xpath:`mets/@csip:CONTENTINFORMATIONTYPE`
     - ``OTHER``
   * - Other Content Information Type Specification **czdax-pmt0106**
     - :xpath:`mets[@csip:CONTENTINFORMATIONTYPE='OTHER']/@csip:OTHERCONTENTINFORMATIONTYPE`
     - ``change_request_v1_0``


Vazba na měněný AIP
==============================

Souhrnné informace o SIP balíčku jsou uvedeny v souboru :file:`PACKAGE-INFO.xml`. 

**CZDAP-IPF0201**: Soubor :file:`PACKAGE-INFO.xml` MUSÍ obsahovat:

 - definici intelektuální entity zdrojového balíčku, a to včetně uvedení jeho verze
 - definici intelektuální entity pro samotný SIP balíček (identifikátor ``_THIS``)
 - definici agenta - osoba provádějící změnu
 - definici agenta - použitý software
 - uvedení události ``ing``, resp. ``ingestion`` dle řízeného slovníku: https://id.loc.gov/vocabulary/preservation/eventType/ing.html,
   zdrojem pro tuto událost je zdrojový balíček

Informace uvedené v souboru :file:`PACKAGE-INFO.xml` jsou zásadní z hlediska 
připojení změny k požadovanému balíčku. 


**CZDAP-IPF0202**: Pokud by došlo k významné změně balíčku oproti poslední 
známé verzi balíčku uvedené v souboru :file:`PACKAGE-INFO.xml`, NESMÍ digitální 
archiv takovou změnu akceptovat, resp. MUSÍ dojít k jejímu odmítnutí s chybou.