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: 100MBNastavení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í.
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é URLelza.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