.. _intro:

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

.. _intro_readonly:

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.

.. important::

   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 :ref:`config`
   a :ref:`oper_db_elza_queue`).