.. _ug_admin_import: ======================= Import ======================= Obrazovka *Import* slouží k **dávkovému importu** dat do aplikace. Umožňuje najednou importovat více archivních souborů z datových souborů ve formátu EDX2 nebo hromadně doplnit prvky popisu k existujícím jednotkám popisu ze souboru CSV. .. figure:: resources/admin-import.png :align: center Importy Import probíhá prostřednictvím **importních dávek**. Každá dávka má své nastavení, obsahuje jednu nebo více **položek** (vstupních souborů) a během zpracování prochází různými :ref:`stavy `. Na obrazovce je možné založit dva druhy dávek: - **Nová EDX2 dávka** – import archivních souborů z datových souborů ve formátu EDX2 (XML) - **Nová CSV dávka** – doplnění prvků popisu k existujícím jednotkám popisu ze souboru CSV Pod tlačítky pro založení dávky je zobrazen :ref:`přehled importních dávek `. .. note:: Obrazovka je dostupná pouze uživatelům s oprávněním **Administrátor**. Postup importu ================= 1. Založte novou dávku tlačítkem *Nová EDX2 dávka* nebo *Nová CSV dávka* a vyplňte její nastavení. 2. Po stisknutí tlačítka *Založit* se dávka vytvoří ve stavu ``PREPARATION`` a zobrazí se její **detail**. 3. V detailu dávky vložte vstupní soubory pomocí jedné z akcí: - *Nahrát soubor* – nahrání jednoho souboru, - *Nahrát ZIP* – nahrání archivu ZIP, ve kterém se každý soubor stane samostatnou položkou dávky, - *Ze složky na serveru* – výběr souborů ze složky na serveru (dostupné pouze tehdy, pokud je na serveru nakonfigurována složka pro import). 4. Volitelně spusťte **testovací běh** tlačítkem *Testovací běh*, který ověří vstupní soubory bez provedení importu. 5. Spusťte import tlačítkem *Spustit*. Průběh zpracování dávky i jednotlivých položek je průběžně zobrazován. 6. Pokud zpracování některé položky skončí chybou, je možné zobrazit detail chyby, problematickou položku odstranit nebo opravit a dávku spustit znovu. V detailu dávky je dále možné běžící dávku **pozastavit**, dávku **přerušit** nebo ji **smazat**. Po dokončení importu je možné z položky přímo otevřít vytvořený nebo aktualizovaný archivní soubor. .. figure:: resources/admin-import-detail.png :align: center Detail importní dávky .. note:: Testovací běh u dávky EDX2 ověří formální správnost vstupních souborů (validace proti XML schématu). U dávky CSV se testovací běh neprovádí. .. _ug_admin_import-edx2: Nová EDX2 dávka ================= Dávka EDX2 slouží k importu jednoho nebo více archivních souborů z datových souborů ve formátu **EDX2**. Každý vstupní soubor dávky odpovídá jedné položce, která je importována samostatně. .. figure:: resources/admin-import-edx2.png :align: center Nový import – EDX2 Nastavení dávky ----------------- Název - povinný údaj - libovolný název dávky, pod kterým bude dávka zobrazena v přehledu importů Strategie importu fondu - povinný údaj, výchozí hodnota je ``ALWAYS_NEW`` - určuje, zda importovaná data vytvoří nový archivní soubor, nebo budou vložena do již existujícího archivního souboru: - ``ALWAYS_NEW`` – každá položka dávky vždy vytvoří **nový archivní soubor**, párování s existujícími archivními soubory se neprovádí - ``ALWAYS_PAIR`` – každá položka musí být **spárována s existujícím archivním souborem**, do kterého jsou data importována; pokud odpovídající archivní soubor neexistuje, zpracování položky skončí chybou - ``PAIR_AND_CREATE`` – položka je **spárována s existujícím archivním souborem**, pokud existuje; v opačném případě je vytvořen nový archivní soubor Klíč pro párování - nepovinný údaj, výchozí hodnota je *nezvoleno* - určuje, podle jakých údajů je importovaná položka párována s existujícím archivním souborem - ``INSTITUTION_AND_FUND_NUMBER`` – párování podle **kódu instituce** a **čísla archivního souboru**, které jsou uvedeny v importovaném souboru EDX2 - nastavení je nutné u strategií ``ALWAYS_PAIR`` a ``PAIR_AND_CREATE``, u strategie ``ALWAYS_NEW`` se nepoužije Ignorovat kořenové úrovně - pokud je volba zaškrtnuta, kořenové úrovně z importovaného souboru nejsou vytvořeny a jejich podřízené úrovně jsou vloženy přímo pod kořenovou úroveň spárovaného archivního souboru - volbu lze využít pouze v kombinaci s párováním na existující archivní soubor Oblast entit - :ref:`oblast `, do které budou založeny archivní entity obsažené v importovaném souboru - výběr oblasti je pro úspěšný import nutný, bez zvolené oblasti zpracování položek skončí chybou Pokračovat po chybě položky - pokud volba není zaškrtnuta, zpracování dávky se zastaví při první chybě a dávka přejde do stavu ``FAILED`` - pokud je volba zaškrtnuta, po chybě se pokračuje ve zpracování dalších položek; dávka však i v tomto případě skončí ve stavu ``FAILED``, pokud alespoň jedna položka skončila chybou Zachovat vstupní soubory - pokud volba není zaškrtnuta, vstupní soubory dokončené, chybové nebo přerušené dávky jsou automaticky **odstraněny po 30 dnech** od poslední změny jejího stavu; takovou dávku již nelze znovu spustit - pokud je volba zaškrtnuta, vstupní soubory dávky jsou zachovány trvale .. note:: - Při párování musí odpovídat právě jeden archivní soubor. Pokud odpovídá více archivních souborů, zpracování položky skončí chybou. - Spárovaný archivní soubor musí mít otevřenou verzi. Importovaná data jsou vložena pod jeho kořenovou úroveň. - Archivní entity obsažené v importovaném souboru jsou párovány s existujícími archivními entitami automaticky. .. _ug_admin_import-csv: Nová CSV dávka ================= Dávka CSV slouží k hromadnému **doplnění prvků popisu** k již existujícím jednotkám popisu. Jednotky popisu jsou v souboru identifikovány pomocí svého **UUID**. Prvky popisu jsou k jednotce popisu vždy přidány, stávající hodnoty nejsou nahrazovány. .. figure:: resources/admin-import-csv.png :align: center Nový import – CSV Nastavení dávky ----------------- Název - povinný údaj - libovolný název dávky, pod kterým bude dávka zobrazena v přehledu importů Oddělovač - znak, kterým jsou v souboru CSV odděleny jednotlivé hodnoty - na výběr je ``;`` (středník, výchozí hodnota), ``,`` (čárka), tabulátor a ``|`` (svislítko) Kódování - kódování znaků vstupního souboru CSV - na výběr je *UTF-8*, *Windows-1250 (středoevropské)* (výchozí hodnota), *ISO-8859-2 (Latin-2)* a *Windows-1252 (západoevropské)* Pokračovat po chybě položky - význam je shodný s :ref:`dávkou EDX2 ` Zachovat vstupní soubory - význam je shodný s :ref:`dávkou EDX2 ` Formát souboru CSV -------------------- Soubor CSV neobsahuje řádek se záhlavím. Každý řádek odpovídá jedné jednotce popisu a má následující strukturu: ``UUID jednotky popisu;kód typu prvku;[kód specifikace;]hodnota[;kód typu prvku;...]`` - první hodnotou na řádku je **UUID jednotky popisu**, ke které budou prvky popisu doplněny - následuje libovolný počet dvojic **kód typu prvku popisu** a **hodnota** - u prvků popisu se specifikací se mezi kód typu prvku a hodnotu uvádí **kód specifikace** - u prvků popisu typu *výčet* se uvádí pouze kód specifikace bez hodnoty - u prvků popisu odkazujících na archivní entitu se jako hodnota uvádí **ID archivní entity** Podporované :ref:`datové typy: ` - DECIMAL [?] - ENUM - FORMATTED_TEXT [?] - INT - RECORD_REF - STRING - TEXT - UNITID [?] - URI_REF [?] Ostatní datové typy zatím nejsou podporovány. .. note:: - Mezery na začátku a konci hodnot jsou ignorovány. Řádky bez UUID jednotky popisu jsou přeskočeny. - Archivní soubor, do kterého jednotka popisu patří, musí mít otevřenou verzi. .. _ug_admin_import-list: Přehled importů ================= Na obrazovce je zobrazen seznam všech importních dávek seřazených od nejnověji založené. Kliknutím na řádek se otevře **detail dávky**. Přehled se při změně stavu dávky automaticky aktualizuje. Seznam obsahuje tyto sloupce: Název - název dávky zadaný při jejím založení - u importu spuštěného z modulu *Archivní soubory* (import ze souboru) je dávka založena automaticky a jejím názvem je název importovaného souboru Druh - druh importní dávky: - ``EDX2`` – import archivních souborů ze souborů EDX2 - ``ADD_DESC_ITEMS_CSV`` – doplnění prvků popisu ze souboru CSV Stav - aktuální :ref:`stav ` dávky Spuštěno - datum a čas posledního spuštění dávky (včetně testovacího běhu) Dokončeno - datum a čas ukončení zpracování dávky - údaj je zobrazen pouze u dávek ve stavu ``FINISHED``, ``FAILED`` nebo ``CANCELLED`` V zápatí seznamu je možné přecházet mezi stránkami pomocí tlačítek *Předchozí* a *Další* a nastavit počet zobrazených záznamů na stránku (10, 25 nebo 50). .. _ug_admin_import-states: Stavy dávky ------------- .. list-table:: :header-rows: 1 * - Stav - Význam * - ``PREPARATION`` - Dávka je založena a připravena k vložení vstupních souborů a ke spuštění. * - ``TEST_IN_PROGRESS`` - Probíhá testovací běh dávky. * - ``TEST_FINISHED`` - Testovací běh byl dokončen. Dávku je možné spustit nebo do ní vložit další soubory (dávka se tím vrátí do stavu ``PREPARATION``). * - ``IN_PROGRESS`` - Probíhá import dávky. * - ``PAUSED`` - Import byl pozastaven uživatelem nebo restartem serveru. Zpracování je možné znovu spustit, pokračuje se nezpracovanými položkami. * - ``FINISHED`` - Import všech položek dávky byl úspěšně dokončen. * - ``FAILED`` - Zpracování alespoň jedné položky skončilo chybou. Dávku je možné znovu spustit, zpracovány budou chybové a dosud nezpracované položky. * - ``CANCELLED`` - Dávka byla přerušena uživatelem a nelze ji znovu spustit. .. note:: - Pozastavení i přerušení dávky se projeví až po dokončení právě zpracovávané položky. - Dávku ve stavu ``IN_PROGRESS`` nebo ``TEST_IN_PROGRESS`` nelze smazat. Smazáním dávky jsou odstraněny i její vstupní soubory.