===========================
Import z tabulek XLSX
===========================

Tato kapitola popisuje principy společné všem konfiguracím XLSX importu.
Podrobnosti jednotlivých konfigurací jsou v samostatných kapitolách.

Volba konfigurace
=================

.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - Konfigurace
     - Charakteristika
   * - :doc:`Univerzální import <03-univerzalni-import>`
     - Umožňuje zapsat libovolný prvek popisu v jakémkoli pořadí včetně odkazů na entity.
   * - :doc:`Úplná tabulka <04-uplna-tabulka>`
     - Tabulka se sloupci v závazném počtu a pořadí, které je třeba dodržet.

.. _sablony-ke-stazeni:

Šablony ke stažení
==================

Každá konfigurace má vzorovou šablonu XLSX. Data připravujte vždy do
šablony zvolené konfigurace – u Úplné tabulky se nesmí měnit pořadí
sloupců, u Univerzálního importu se nesmí smazat řádek s kódy sloupců.

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Konfigurace
     - Šablona
   * - Univerzální import
     - :download:`import-univerzalni-import-vzor.xlsx
       <../../../xlsximport/konfigurace/UniverzalniImport/import-univerzalni-import-vzor.xlsx>`
   * - Úplná tabulka
     - :download:`import-uplna-tabulka-vzor.xlsx
       <../../../xlsximport/konfigurace/UplnaTabulka/import-uplna-tabulka-vzor.xlsx>`

Šablony se do dokumentace přebírají přímo ze složky
``xlsximport/konfigurace`` v repozitáři, takže odpovídají nasazené
konfiguraci.

Struktura tabulky
=================

- Data se čtou z prvního listu sešitu.
- Jeden řádek tabulky odpovídá jedné jednotce popisu.
- Úvodní řádky se záhlavím se přeskakují; jejich počet je dán
  konfigurací.
- Pořadí řádků určuje pořadí jednotek popisu v archivní pomůcce.

Hierarchie jednotek popisu
==========================

Zařazení jednotky popisu do stromu se určuje číslem *úrovně*
(1 = nejvyšší úroveň). Jednotka popisu se zařadí pod nejbližší
předchozí řádek s úrovní o jedna nižší.

Typ úrovně popisu musí odpovídat
`Základním pravidlům pro zpracování archiválií <https://mv.gov.cz/metodicke-pokyny-upravujici-vykon-spisove-sluzby-a-archivnictvi?chapter=2>`_:

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Typ úrovně
     - Povolený nadřízený
   * - série
     - kořen archivního souboru nebo série
   * - složka
     - série nebo složka
   * - jednotlivost
     - série nebo složka
   * - část jednotlivosti
     - jednotlivost nebo část jednotlivosti

Porušení pravidel se zapíše do protokolu.

.. todo::

   Ověřit a popsat chování při porušení pravidel hierarchie (zastavení
   převodu vs. zápis do protokolu) a význam ``firstLevelAsRoot``.

Datace
======

.. todo::

   Popsat podporované zápisy strojové datace (rok, rozsah, století,
   přibližná datace) a vztah strojové a textové datace.

Ukládací jednotky
=================

Ukládací jednotka se skládá z typu (karton, fascikl, …), prefixu, čísla
a postfixu. Typy ukládacích jednotek, které konfigurace rozpoznává, jsou
uvedeny v kapitole dané konfigurace.

.. todo::

   Popsat zápis rozsahu ukládacích čísel (např. ``1-3``) a chování
   nečíselného ukládacího čísla; ověřit proti StorageExtractor.

Kontrola zpracování
===================

Konfigurace kontrolují, zda byl zpracován obsah všech vyplněných buněk.
Buňka, jejíž hodnotu se nepodařilo převést (neznámá hodnota datového typu,
chybná datace, sloupec bez určení prvku popisu), se uvede v protokolu
s číslem řádku a sloupce.