4.5. Konfigurace Elza

Konfigurace aplikace Elza je standardně uložena v souboru elza.yaml (případně elza-ui.yaml) v závislosti na distribuci aplikace. Soubor obsahuje definici databázového připojení, nastavení pracovního adresáře a některá další nastavení.

Konfigurace je soubor ve formátu YAML.

4.5.1. Příklad

Příklad konfigurace

#
# Port and binding address for HTTP
#
# server:
#   Network address to which the server should bind.
#   By default, the value is set to 0.0.0.0 which 
#   allows connection via all IPv4 addresses.
#   address: 
#
#   Server HTTP port. Default port is 8080.
#   port: 8080
#
elza:
  data:
    # Nastaveni DB
    url: <dbURL>
    user: <dbUser>
    pass: <dbPass>

  attachment:
    # Konfigurace mimetypu pro editaci souboru
    mimeDefs:
      - mimeType: text/plain
        editable: true
        # Generatory pro jednotlive typy souboru
        generators:
         - outputMimeType: application/pdf
           command: txt2pdf {2} {4}
           outputFileName: result.pdf

spring:    
  jpa:
    properties:
      hibernate:
        <dbDialect>

4.5.2. Nastavení webového serveru

Pokud je aplikace spuštěna samostatně, je možné nastavit port pro příjem HTTP požadavků. Výchozí port je 8080.

Popis možností nastavení portů, adresy serveru a další možnosti týkající se HTTP komunikace jsou popsány v dokumentaci: Server properties.

Ukázka nastavení pro spuštění serveru na portu 8088:

server:
  port: 8088

4.5.3. Nastavení databáze

Konfigurace databáze se provádí v sekci elza.data. Nastavení se skládá ze tří částí:

url - připojení k databázi, formát je dle dokumentace JDBC ovladače

user - uživatelské jméno

pass - heslo pro připojení k databázi

4.5.4. Přílohy

Konfigurace příloh se provádí v sekci elza.attachment.

Konfigurace slouží k definici typů příloh, určení, které mohou uživatelé přímo v aplikaci editovat a případné nastavení generátorů pro převod do cílových formátů.

Sekce mimeDefs definuje typy souborů. Každý typ se konfiguruje pomocí těchto atributů:

mimeType - mime-type přílohy

editable - příznak, zda je typ editovatelný

generators - seznam generátorů, které umožňují převod daného formátu do jiného

Generátor a jeho konfigurace

Generátorem se rozumí konfigurace externí aplikace, která umožňuje převod souboru do jiného formátu. Konfigurace generátoru se skládá ze tří částí:

outputMimeType - výstupní formát generátoru (například: application/pdf )

command - příkaz, který je spuštěn pro provedení transformace

outputFileName - jméno souboru, který obsahuje výsledek transformace

Příkaz může být parametrizován. Parametry uvedené ve složených závorkách jsou zaměněny za příslušné argumenty. Číslování argumentů je od nuly.

Dostupné argumenty:

{0} - plná cesta do pracovního adresáře
{1} - jméno vstupního souboru
{2} - jméno vstupního souboru včetně úplné cesty
{3} - jméno výstupního souboru
{4} - jméno výstupního souboru včetně úplné cesty

4.5.5. Parametry aplikace

Další parametry aplikace.

Maximální velikosti upload požadavků

Z bezpečnostních důvodů jsou v aplikaci nastaveny maximální velikosti pro velikost upload požadavků. Tyto limity je možné změnit.

elza.upload.max_file_size - maximální velikost jednoho nahrávaného souboru, výchozí hodnota: 25MB

elza.upload.max_request_size - maximální velikost jednoho požadavku, výchozí hodnota: 100MB

Nastavením hodnoty -1 je možné omezení zcela vypnout.

Maximální velikost dávky pro databázové operace

Parametr zajišťuje bezpečnou a efektivní práci se seznamy v databázových dotazech s tím, že rozděluje příliš velké seznamy na dávky. Výchozí velikost dávky je 1000. Pomocí parametru je možné nastavit velikost dávky (maximální počet záznamů v klauzuli IN):

elza.data.batchSize - maximální velikost dávky

Vymazání oblastí archivních entit

Archivní entity jsou členěny do oblastí. Oblast nelze odstranit pokud jsou k ní připojeny archivní entity. Aktivací zvláštní volby je možné vynutit odstranění oblasti.

elza.scope.deleteWithEntities - hodnota true nebo false

Volba je standardně vypnuta (false). Pokud je volba aktivní (po restartu aplikace). Je možné odstranění již nepoužívaných oblastí.

Automatická reindexace

Ve výchozí konfiguraci je nastaveno provádění automatické reindexace dat každou sobotu ve 4:00 ráno. Spouštění reindexace je možné deaktivovat nebo nastavit vlastní frekvenci jejího provádění. Popis nastavení je ve vzorové konfiguraci v části elza.reindex.cron.

Předávání pomůcek a výstupů pomocí WS

Pomocí webové služby je možné výslednou archivní pomůcku automatizovaně předat po vygenerování do návazného informačního systému. Pomůcka je odeslána pomocí WSDL služby - FileTransfer.

Z hlediska konfigurace je pro předávání nutné nastavit:

elza.findingAid.upload.url - cílové URL
elza.findingAid.upload.username, elza.findingAid.upload.password - volitelné jméno a heslo pro BASIC autorizaci.
elza.findingAid.upload.soapLogging - podrobné logování komunikace (true/false)

Pro povolení nahrávání pomůcek z uživatelského rozhraní je nutné nastavit:

elza.output.allowSend: true - povolení odesílání
elza.output.senderName: FtOutputSender - určení způsobu odesílání

Kompletní příklad nastavení:

elza:
  findingAid:
    upload:
      url: http://10.1.25.34:8080/esm/cxf/ft
      soapLogging: false
      username: xxxxx
      password: xxxxx
  output:
    allowSend: true
    senderName: FtOutputSender

Url pro adresu po odhlášení

V nastavení je možné definovat adresu pro přechod při odhlášení uživatele. Při odhlášení uživatele dojde k přesměrování na určenou adresu.

elza.security.logoutUrl - url adresa přechodu