.. _aip_filesec:

======================
Digitální komponenty
======================

V AIS je DOK (digitální komponenta) chápána jako logický soubor, který může mít vazby 
na více fyzických souborů (obsahových verzí, formátových skupin a formátových reprezentací 
viz. :ref:`aip_format_repres`). Skrze číslo DOK jsou v AIS drženy vazby na fyzické soubory. 
Číslo DOK je celočíselný identifikátor DOK v rámci jedné AU, inkrementovaný od 1.

fileSec element obsahuje 1-5 typovaných fileGrp elementů 1. úrovně. 
Hodnota atributu ``USE`` obsahuje typ z výčtu: ``ORIGINAL``, ``NOT_ORIGINAL``, ``LQ_COPY``, ``HQ_COPY``, ``LTP_COPY``.
Každý ``fileGrp`` nejvyšší úrovně obsahuje 1-n ``fileGrp`` elementů 2. úrovně. 
V každém elementu ``fileGrp`` druhé úrovně jsou soubory shluknuty dle čísla DOK a
jsou řazeny od nejstarších verzí po nejnovější, explicitně je navíc pořadí uvedeno v atributu SEQ.

**V žádném případě nelze zpětne dohrát formátovou reprezentaci (HQ/LQ/LTP kopii) k jiné než nejnovější obsahové verzi souboru.**

Vazby (odkazy) mezi formátovými skupinami jsou drženy skrze **GROUPID**. ``GROUPID`` obsahuje číslo DOK a 
číslo obsahové verze.

**ORIGINAL** může být v každé obsahové verzi pouze jeden. Z originálu je možno vytvořit ``LTP_COPY`` (např. konverze do novějšího formátu) i 
``LQ_COPY`` či ``HQ_COPY``.

**LTP_COPY**: V případe LTP_COPY je třeba rozlišit zda soubor v posloupnosti reprezentuje
další obsahovou verzi nebo je pouze LTP kopií - to je zjištěno pomocí atributu ``GROUPID``. 
Stejná ``fileGrp`` a ruzné hodnoty atributu ``GROUPID`` znamená, že se jedná o obsahovou verzi. 
Stejná ``fileGrp`` a stejná hodnota ``GROUPID`` znamenají že se jedná o LTP kopii.
Z LTP kopií je možno vytvořit ``LTP_COPY`` (např. konverze do novějšího formátu) i LQ/HQ copies.

V případě **LQ_COPY/HQ_COPY** s pojmem obsahové verze nepracujeme. Každá obsahová verze 
``NOT_ORIGINAL``/``ORIGINAL``/``LTP_COPY`` souboru může mít n LQ/HQ kopií, ty jsou však obsahově totožné.

**NOT_ORIGINAL** může být v každé obsahové verzi pouze jeden. Z konceptu je možno vytvořit 
``LTP_COPY`` (např. konverze do novějšího formátu) i LQ/HQ copies.

Každý soubor obsahuje jeden **fptr** element s atributy ``LOCTYPE="OTHER"`` a ``xlink:href="cesta k souboru"``.

Příklad filesec
===============

Níže uvedený **příklad** (pro přehlednost neobshuje ``fptr`` elementy) popisuje následující soubory 
(id souboru v závorce):

LS1 obsahuje pouze 2 koncepty (id1,id2)

LS2 obsahuje soubory dle následující posloupnosti událostí:
 - koncept (id3) -> koncept (id4) -> originál (id5) -> lq copy (id6) -> obsahová verze (id7) -> lq copy (id8) -> ltp copy (id9) -> lq copy (id10)

LS3 obsahuje soubory dle následující posloupnosti událostí:
 - koncept (id11) -> digitalizát (id12) -> lq copy (id13) -> ltp copy (id14) -> lq copy (id15) -> obsahová verze (id16)

.. literalinclude:: ukazky/filesec.xml
   :language: xml