Skip to content

Validace

Martin Řehánek edited this page May 22, 2023 · 11 revisions

Validace přes terminál/příkazový řádek (CLI)

Pro spuštění CLI verze aplikace je potřeba Java a to minimálně ve verzi 8.

Validace PSP balíku (adresář)

java -jar KomplexniValidatorCLI-verze.jar 
             --config-dir /cesta/k/adresari/validatorConfig 
             --action VALIDATE_PSP
             --psp /cesta/k/adresari/psp/baliku

Validace PSP balíku (ZIP soubor)

java -jar KomplexniValidatorCLI-verze.jar 
             --config-dir /cesta/k/adresari/validatorConfig 
             --action VALIDATE_PSP
             --psp /cesta/k/zip/souborupsp/baliku
             --tmp-dir /cesta/k/adresari/s/docasnymi/soubory

Validace skupiny PSP balíků (adresář)

java -jar KomplexniValidatorCLI-verze.jar 
             --config-dir /cesta/k/adresari/validatorConfig 
             --action VALIDATE_PSP_GROUP
             --psp-group /cesta/k/adresari/obsahujicim/psp/baliky

Validace skupiny PSP balíků (ZIP soubor)

java -jar KomplexniValidatorCLI-verze.jar 
             --config-dir /cesta/k/adresari/validatorConfig 
             --action VALIDATE_PSP_GROUP
             --psp-group /cesta/k/zip/souboruobsahujicim/psp/baliky
             --tmp-dir /cesta/k/adresari/s/docasnymi/soubory

Další parametry

Specifikace uložení protokolu o dokončené validaci v XML

 --xml-protocol-dir ADRESAR
 --xml-protocol-file SOUBOR

Preference/vynucení použití konkrétní verze DMF

 --preferred-dmf-mon-version VERZE 
 --preferred-dmf-per-version VERZE
 --preferred-dmf-sr-version VERZE

 --forced-dmf-mon-version VERZE 
 --forced-dmf-per-version VERZE
 --forced-dmf-sr-version VERZE

Vypnutí / nastavení nástrojů pro kontrolu binárních souborů (obrazová, zvuková data)

 --imagemagick-path ADRESAR
 --jhove-path ADRESAR
 --jpylyzer-path ADRESAR
 --kakadu-path ADRESAR
 --shntool-path ADRESAR
 --checkmate-path ADRESAR

 --disable-imagemagick
 --disable-jhove
 --disable-jpylyzer
 --disable-kakadu
 --disable-mp3val
 --disable-shntool
 --disable-checkmate

Ostatní

 -v,--verbosity <0-3> 
 --help    
 --version 

Podrobnější popis a aktuální seznam parametrů lze zjistit následovně:

java -jar KomplexniValidatorCLI-verze.jar --help

Mezery a diakritika v cestách k adresářům/souborům

Validátor umí pracovat s cestami, které obsahují jiné, než ASCI znaky, typicky diakritiku. Pokud ale cesta obsahuje mezery, je nutné uvádět cesty v uvozovkách při spouštění přes CLI. Např.:

java -jar KomplexniValidatorCLI-verze.jar 
             --config-dir "C:\\Program Files\Komplexní Validátor\validatorConfig" 
             --action VALIDATE_PSP
             --psp "D:\\Moje data\PSP\b50eb6b0-f0a4-11e3-b72e-005056827e52" 

Přesto se ale nedoporučuje používat v cestách mezery a dikritiku. Důvodem je to, že s jejich zpracováním můžou mít problémy nástroje třetích stran, které Validátor využívá. Tedy nástroje pro kontrolu obrazových data (Kakadu, ImageMagick, JHOVE a Jpylyzer) a nástroje pro kontrolu zvukových dat ().

Související problémy

Webová validace

Výroba minifikovaného balíku

Minifikovaný PSP balík je původní PSP balík výrazně zmenšený odebráním obrazových, zvukových a OCR dat. Oproti původnímu balíku, který může zabírat až stovky MB je zmenšený balík vhodný pro upload a webovou validaci. Na přípravu použijeme CLI:

java -jar KomplexniValidatorCLI-verze.jar 
             --config-dir "C:\\Program Files\Komplexní Validátor\validatorConfig" 
             --action BUILD_MINIFIED_PACKAGE
             --psp "D:\\Moje data\PSP\b50eb6b0-f0a4-11e3-b72e-005056827e52" 
             --minified-psp-dir "D:\\Moje data\PSP\minifikované" 

Pro minifikaci lze použít PSP balík v podobě adresáře, nebo souboru zip.