6.2. ESM API

Modul ESM poskytuje několik integračních rozhraní.

6.2.1. ES1 (FT) Vložení přejímky

Rozhraní pro zápis přejímky z modulu Výběr. Rozhraní umožňuje zapsat nově vloženou přejímku. Přejímka je rozdělena do logických celků podle cílových archivních souborů a původců. Rozdělení je realizováno formou adresářů. Jméno adresáře slouží jako identifikátor příslušné části přejímky. Každý adresář s částí přejímky má následující strukturu:

prilohy:

Adresář obsahuje přílohy / průvodní soubory vnější změny.

sipy:

Adresář obsahuje SIPy tvořící přejímku. Pokud jde o přejímku, kde byly všechny archiválie skartovány, je adresář prázdný.

zarazeni.xml:

Soubor popisující přejímku. Soubor obsahuje identifikátor AS k němuž se váže vnější změna, ID přejímky v modulu Výběr, kompletní metadata přejímky (předávající, číslo jednací apod.)

Soubor zarazeni.xml je ve formátu dle schématu: zarazeni.xsd.

Výběr zasílá přejímku pomocí služby File Tranfser Service. ESM odpovídá Výběru ve dvou fázích. Nejprve skrze volání V2 (WSDL) Zahájení Uložení potvrdí příjem přejímky a následně voláním V3 (WSDL) Výsledek Uložení Přejimky potvrdí uložení AIPů. Parametry předání:

  • type="<PREJIMKA-SR-NSESSS|PREJIMKA-SR-SOUBORY|PREJIMKA-MSK|UPDATE>"

  • id="<id přejímky v modulu výběr>"

  • GenericDataType.binData=<id uzivatele jako pole bajtů v utf-8>

Typy předání:

  • PREJIMKA-SR-NSESSS - předání dat ze skartačního řízeni formou SIPů ze spisové služby

  • PREJIMKA-SR-SOUBORY - předání dat ze skartačního řízení ve formě volných souborů

  • PREJIMKA-MSK - předání dat z mimoskartačního řízení ve formě volných souborů

  • UPDATE - aktualizace SIPů, výsledek volání V1 (WSDL) Založení změny AIPů

Viz Formát SIPu pro ESM

ES3 (WSDL) ctiArchivniSoubor(asId) - vraci DB reprezentaci AS vcetne seznamu jeho priloh

ES4 (WSDL) ctiArchivniPomucku(aaId) - vraci DB reprezentaci AP vcetne seznamu jeji priloh

ES5 (WSDL) ctiVneZ(vnezId) - vraci DB reprezentaci vniZ vcetne seznamu jeji priloh

ES6 (WSDL) ctiVniZ(vnizId) - vraci DB reprezentaci vneZ vcetne seznamu jeji priloh

6.2.2. ES7 (FT) Zpřístupnění metadat AIPů

Funkce vrací metadata aktuálních verzí archiválií včetně souborové struktury a včetně EAD sekce. Funkce umožňuje vrátit metadata jednotlivého AIPu nebo celé množiny. Výsledek funkce je přenášen jako sada souborů v adresářích, kde každý adresář je pojmenován ID AIPu.

GetMetadata_XY(AIP_ID_list)

Data jsou přenášena pomocí FileTransfer.

Parametry požadavku

Parametry operace Begin pro vyžádání dat:

  • type=“GetMetadata_AS“|“GetMetadata_AP“|“GetMetadata_VniZ“|“GetMetadata_VneZ“

  • id=“<id AIPu>“, případně ID více AIPů (čárkou oddělený seznam)

6.2.3. ES8 (FT) Přidání průvodních dokumentů

K archivním entitám AS, VNěZ, VNiZ, AP je možné přidávat průvodní dokumenty formou samostatných souborů. Modul Výběr zasílá sadu přidávaných souborů.

Pokud je přidán soubor, který již v entitě existuje, tak se jedná o jeho aktualizaci. Zasílající modul musí toto vhodným způsobem vyznačit v uživatelském rozhraní (před voláním tohoto endpointu si nejprve vyžádá metadata archivní entity obsahující seznam souborů). Takový soubor musí mít identický název jako původní soubor (bez (1) na konci nebo jiného označení verze). V případě že se zaslaná verze nerovná nejnovější verzi, volání skončí chybou.

ESM odpovídá Výběru skrze volání V4 (WSDL) Výsledek uložení průvodních dokumentů.

Soubory se předávají v adresáři obsahujícím:

prilohy:

Adresář, kde jsou zasílané soubory.

pridani.xml:

Soubor popisující entitu k níž jsou data přidána (typ entity, id entity), jméno uživatele, který soubory přidal. Viz Přidání průvodních dokumentů.

Parametry předání:

  • type="PRILOHY"

  • id="<id přejímky v modulu výběr>"

  • GenericDataType.binData=<id uzivatele jako pole bajtů v utf-8>

6.2.4. ES9 (FT/WSDL) Vložení XML s pomůckou

Funkce pro vložení zpracované pomůcky. Pomůcka se vkládá ve formátu XML. Pro přenos pomůcky se použije služba File Tranfser Service. Z pomůcky jsou na straně ESM vytažena metadata archiválií a popsané archiválie jsou updatovány (popis apod.).

Odpovědí na nahrání pomůcky je potvrzení jejího přijetí nebo odmítnutí s chybou.

Pomůcka je předávána službou s těmito parametry:

  • type = "POMUCKA"

  • id = "CISLO_NAD,CISLO_POMUCKY"

Soubory s pomůckou jsou předány v jednom adresáři, typ předávaného souboru je určen koncovkou v jeho názvu.

Příklad předávaných dat:

  • abc.xml - soubor ve formátu EAD

  • abc.pdf - soubor ve formátu PDF

ES10 (HTTP) ctiSeznamArchivnichSouboru(filterparams)

Podpora stránkování a filtru na název souboru. Vrací pouze soubory dostupné volajícímu uživateli (s oprávněním zakládat nové přejímky).

ES11 (URL) zobrazMetadataArchivalie(id archivalie)

ES12 (URL) zobrazSouborArchivalie(uuid souboru)

Přístupem na URL: …/esm/file/{uuid}

ES13 (HTTP) ziskejArchivare(idArchivnihoSouboru)

Vrátí seznam všech archivářů, pokud je specifikovaný AS pak pouze archivářů daného AS.

ES14 (WSDL) ulozObjednavku(Objednavka objednavka, String idArchivare, String emailObjednavatele, String emailSprávceBadatelny)

ES15 (WSDL) updateObjednavky(Objednavka objednavka)

ES16 (WSDL) CreateUser(userName, personId, permissionList)

ES17 (WSDL) DeleteUser(userName)

ES18 (WSDL) AddPermissions(userName, permissionList)

ES19 (WSDL) RemovePermissions(userName, permissionList)

ES20 (WSDL) ziskejPrazdneArchivalie(idAs,typEvj)

ES21 (URL) zobrazZmenyPrislusiciRizeni(id rizeni)

Přístupem na URL: …/esm/import-detail/{id}

Vrátí DB záznamy „prázdných“ archiválií, tedy takových které byly založeny především exportem z PEVA a mají k nim být nahrány digitalizáty + metadata.

6.2.5. Synchronizace s PEVA II

ESM HTTP API umožňuje synchronizaci Archivních entit (Archivní soubory [Listy NAD], Archivní pomůcky, Vnitřní změny, Vnější změny) do IS PEVA II skrze externí rozhraní PEVA II a naplňuje v tomto směru požadavky uvedené v dokumentaci: https://www.mvcr.cz/clanek/provoz-informacniho-systemu-evidence-narodniho-archivniho-dedictvi-na-narodnim-portalu.aspx