2. 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.

2.1. Volba konfigurace

Konfigurace

Charakteristika

Univerzální import

Umožňuje zapsat libovolný prvek popisu v jakémkoli pořadí včetně odkazů na entity.

Úplná tabulka

Tabulka se sloupci v závazném počtu a pořadí, které je třeba dodržet.

2.2. Š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ů.

Konfigurace

Šablona

Univerzální import

import-univerzalni-import-vzor.xlsx

Úplná tabulka

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.

2.3. 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.

2.4. 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í:

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.

2.5. Datace

Todo

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

2.6. 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.

2.7. 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.