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

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 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 přehled importních dávek.

Poznámka

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.

Detail importní dávky

Poznámka

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

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

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

• 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

Poznámka

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

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.

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 dávkou EDX2

Zachovat vstupní soubory

• význam je shodný s 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é datové typy:

• DECIMAL [?]

• ENUM

• FORMATTED_TEXT [?]

• INT

• RECORD_REF

• STRING

• TEXT

• UNITID [?]

• URI_REF [?]

Ostatní datové typy zatím nejsou podporovány.

Poznámka

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

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í 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).

Stavy dávky

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.

Poznámka

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