# 1. Seznámení

PEVA Connector je samostatná integrační komponenta, která stahuje evidenci archivních souborů (NAD listy) ze systému PEvA a synchronizuje je do systému Elza. Komponenta má vlastní databázi, ve které ukládá stažené fondy a stav synchronizace.

Komponenta vznikla vyčleněním importu PEvA z integračního nástroje Imwhooser do samostatné aplikace. Funkčně odpovídá původnímu importu PEvA v Imwhooseru; do Elzy posílá fondy přes službu FundService.

Hlavní toky:

> - stažení seznamu i detailu archivních souborů z PEvA (SOAP),

> - uložení do vlastní databáze (tabulka `pv_fund`) a zařazení do fronty (tabulka `elza_queue`),

> - odeslání fondů do Elzy (SOAP FundService, s vyhledáním fondu přes REST).

## 1.1. Spravované fondy (režim „jen pro čtení“ v Elze)

Fondy, které konektor zakládá v Elze, jsou v Elze označeny jako spravované (řízené externím systémem). Takový fond je v Elze fakticky jen pro čtení: jeho základní evidenční údaje - název, číslo fondu, značku a dataci - může měnit pouze superadministrátor Elzy (uživatel s globálním oprávněním ADMIN). Běžní uživatelé tyto údaje editovat nemohou; jejich zdrojem zůstává PEvA a jejich aktualizaci provádí výhradně konektor.

Příznak „spravovaný“ nastavuje sama Elza při každém založení fondu přes službu FundService. Konektor jej neovlivňuje a nelze jej v konektoru vypnout.

Důležité

Protože aktualizaci spravovaných fondů smí provádět jen superadministrátor, musí mít i servisní účet konektoru (`elza.username`) v Elze oprávnění ADMIN. Bez něj skončí aktualizace dříve založeného fondu chybou INSUFFICIENT_PERMISSIONS. Konektor v takovém případě fond neztratí - záznam zůstává ve frontě a odeslání se opakuje, dokud neuspěje (viz Konfigurace a Odchozí fronta do Elza).