Instalace skenovny a konfigurace čárového kódu

Skenovna je samostatný program spolupracující se spisovou službou AthenA. Jejím účelem je automatizované zpracování obrazů dokumentů - analýza elektronického obrazu obsahu písemností, rozdělení na jednotlivé písemnosti a vložení obrazů do spisové služby k relevantním písemnostem.

Před instalací

Pokud byla už nainstalovaná skenovna, odinstalujte ji a poté smažte, pro všechny uživatele na daném PC:

1. c:\Program Files (x86)\PilsCom\AAClient-Skenovna\
2. c:\Users\<uživatel>\AppData\Local\PilsCom_s.r.o\
3. c:\Users\<uživatel>\AppData\Roaming\PilsCom_s.r.o\

Instalace

1. Stáhněte si z této stránky archiv zip. Archiv si rozbalte do libovolného umístění.
2. Nainstalujte font čárového kódu (pokud již není nainstalován).
3. Vytvořte dle preferencí uživatele pracovní adresáře pro program. Doporučeno je v dokumentech vytvořit adresář "Skenovna" a v něm podaresáře "Pracovní" a "Sledovaná". Do složky "Sledovaná" bude uživatel vkládat soubory pro import do spisové služby, je tedy příhodné vytvořit na ploše zástupce pro tento soubor (nebo obdobnou "zkratku" dle preferencí uživatele).
4. Nainstalujte skenovnu spuštěním Setup.exe jako administrátor. Je důležité, aby soubor "AAClient-SkenovnaSetup.ini" byl ve stejném adresáři jako spouštěný exe.
5. Spusťte Skenovnu jako administrátor (může dojít k dodatečné instalaci systémových knihoven) a proveďte nastavení.

Pozn.: nastavení/profil vytvořený jako administrátor se uloží jako xml do adresáře programu. Jakmile Skenovnu pustí běžný uživatel, tak se aplikace podívá, jestli má nastavení v uživatelově AppData adresáři, pokud ne, jsou zkopírována nastavení z adresáře programu. Změny v profilu, provedené jako administrátor, se tedy nepropíší k uživatelům, kteří již na daném PC Skenovnu spustili. Také je potřeba, pokud je na daném PC více uživatelů Skenovny, upravit adresáře (pracovní a sledovaná složka viz níže v Nastavení) dle konkrétního uživatele.

Nastavení

1. Založit nový profil, pokud se objeví dialog Select Source dát Cancel
2. V dialogu Nový profil postupovat dle snímků přiložených v instalačním zipu. Zadávání či změny by měly být potřeba pouze dle 01, 02a 05, ostatní by mělo být nastaveno správně. Pozor, v některých záložkách, např. Nastavení scanneru nebo Výstup, je nutné použít tlačítko "Použít" ;)
3. 01 Profil - typicky: Název profilu "UHK sledovaná"(bude zobrazeno na tlačítku), Klíč profilu "UHKsledovana" (raději pouze písmena bez mezer a diakritiky); Lokální úložiště nastavit na "Pracovní" složku ad Instalace, Scanner = Watch Folder. Zaškrtnout "Původ jako originál"!
4. 02 Scanner|Obraz/Nastavení scanneru - typicky: Kvalita PDF Střední; nastavit Sledovanou složku na "Sledovaná" ad Instalace výše; zaškrtnout smazat soubor po zpracování; kliknout na "Použít" !
5. 03 Scanner|Obraz/Nastavení obrazu, 04 Oddělovač - typicky beze změny
6. 05 Výstup - typicky: zaškrtnout "Automaticky odstranit sken", ověřit, že komprese je JPEG. Pozor, screenshot je z testovací konfigurace! Zkontrolovat "Napojení na aplikace:https://athena.uhk.cz/athena/soapnt/AAClientSkenovna.asmx" (testovací Athena má ...cz/athenatest/soapnt...). kliknout na "Použít" !
7. 06 Administrace/Administrace - typicky: úroveň logování "Info", zaškrtnout "Zobrazovat dialogy o odeslání do aplikace". Pokud je zaškrtnuto Ověřování a vyplněno SOAP, tak ponechat.
8. 07 Administrace/Klávesové zkratky - typicky beze změny (zkontrolovat se screenshoty)
9. odstraňte ostatní profily, ponechte jen tento nový

Čárový kód

Konfigurace čárového kódu v šablonách pro Skenovnu používá font Archon Code 39 Barcode (dříve používaný Free 3 of 9 Extended byl problematický), který je přiložen v zipu s instalací. Pro správné fungování je pravděpodobně potřeba, aby velikost fontu byla alespoň 16pt.

V šabloně je potřeba vložit pole hromadné korespondence, obsahující údaj pro čárový kód. Název pole v xsl zdrojích STAGu je CP_BARCODE39. Pozor, je tam i pole téměř stejného názvu, jen bez 39. Vložením tohoto pole na místo dle testovacího souboru viz níže by měla být zajištěna funkčnost generovaných souborů z hromadné korespondence pro Skenovnu.

Pro vytvoření a otestování šablony lze využít xls, které získáte kliknutím na tlačítko"vzor" na formuláři hromadné korespondence (pro epřihlášky, pro přijímací řízení a HK0010 hromadná korespondece v menu studenti). Do souborů doplňte údaje do sloupce CP_BARCODE39, ve formátu *B123456789* , tn. B a devět číslic. Včetně hvězdičky na začátku a na konci! Pozor, každá položka v seznamu Výstupy na formulářích hromadné korespondence má vlastní strukturu - počet a názvy sloupců - a tedy je nutné použít vzor pro šablonu, kterou vytváříte.

Testovací soubory

V archivu skenovna_test.zip jsou dva soubory. Jeden je PDF, které by skenovna při vložení do složky Sledovaná a spuštění importu měla rozeznat a rozdělit an tři dílčí dokumenty.

Druhý soubor je docx, který byl použit jako zdroj pro PDF. Jeho otevřením, uložením jako PDF a vložením do Sledované (a spuštením viz výše) se otestuje, zda je na daném PC bezproblémové použití fontů pro ukládání PDF. Hodí se jako refernční pro umisťování kódu do šablon.

V případě setrvávajících problémů

Postup Jakuba Zilvara, který problémy vyřešil - pravděpodobně by šel v leckterých situacích zeštíhlit, ale...

Cit. JZ:

Nejprve jsem odinstaloval celou Skenovnu a smazal všechny konfigurace, viz cesty, které poslali z technické podpory.

C:\Program Files (x86)\PilsCom\AAClient-Skenovna\plugins\Skenovny\config.xml
C:\Users\..uživatel..\AppData\Local\PilsCom_s.r.o\AAClient\AAClient_Skenovna.xml

Tyto dva soubory je třeba, po opětovné instalaci Skenovny, přepsat těmi od tebe. Viz příloha tohoto mailu. Pouze bylo nutné odmazat koncovku – virt, aby došlo k přemazání původních souborů (nestačí je pouze umístit do složky)

Odinstaloval jsem také Barcode font, a pak restartoval počítač.

Opětovná instalace

Následně jsem začal s čistou instalací Skenovny. Nejdříve jsem nainstaloval aktuální Barcode font, pak nainstaloval Skenovnu v nejnovější verzi. Následně jsem prošel ty obě cesty k nakonfigurovaným profilům, viz výše, kde jsem ty soubory, co vznikly instalací, nahradil těmi, co jsi mi poslal ty. Jen jsem odmazal koncovku, kterou jsi tam měl. Tím se přepsaly původní soubory. Zapnul jsem Skenovnu, a zvolil kolonku „upravit profil“. V nastavení profilu je třeba dvakrát přemazat cestu ke složce: „Sledovaná“, a to dle toho konkrétního uživatele. (Mám dojem, že je to první a druhý krok nastavení profilu). Zkontroloval jsem, že se zde již objevuje kód: B######. Pokud se v nastavení profilu objevuje prázdné okénko a ne tento kód, systém fungovat nebude, následně jsem celou konfiguraci uložil. Restartoval Skenovnu a vše funguje.

Vše otestováno na třech různých počítačích, kde se vyskytoval problém. Nyní již vše funguje