INSTALLATIEHANDLEIDING CONVISO ID-SCAN Notarieel Informatie Systeem Sportlaan 2h, 8181 BE Heerde T (0578) 693646, F (0578) 693376 www.vanbrug.nl, info@vanbrug.nl
2018 Van Brug Software Hoewel deze handleiding met zeer veel zorg is samengesteld, aanvaarden noch de auteur, noch Van Brug Software enige aansprakelijkheid voor enige schade ontstaan door eventuele fouten en/of onvolkomenheden in dit document. Voor vragen of opmerkingen betreffende deze of andere documentatie gaarne contact opnemen met: Van Brug Software Kantooradres: Sportlaan 2h, 8181 BE Heerde Postadres: Postbus 123, 8180 AC Heerde Tel.: (0578) 69 36 46 Fax: (0578) 69 33 76 E-mail: info@vanbrug.nl Web: www.vanbrug.nl 2 januari 18
Inhoudsopgave 1 Inleiding 5 1.1 Aanpak 5 1.2 Checklist 5 2 Systeemeisen 6 2.1 NIS of Codex 6 2.2 Netwerk 6 3 Voorbereiding 7 3.1 Software 7 3.2 Inhoud setup 7 3.3 Overige benodigdheden 7 3.4 Rechten en instellingen cliënt (pc) 7 3.5 Verwijderen oude versie 7 4 8 4.1 Algemeen 8 4.2 Conviso ID-scan 8 MS Visual C++ 2012 Redistributable 9 MS SQL Server Compact 4.0 9 Keesing AuthentiScan Premium 11 Keesing Reference Database 12 I-Dentify Document Reader 13 AssureID Sentinel 15 AssureID Document Library 17 Van Brug en Keesing ID-scan Software 19 4.3 Deployment Codex en Keesing ID-scan integratie 19 4.4 Library Customization workaround uitvoeren. 21 4.5 Configuratie Conviso ID-scan 22 Snelkoppeling config 22 Inrichten config 23 Afronden 23 4.6 Configuratie 24 Configuratie Keesing Software 24 Configuratie AsureID Software 24 ARH Driver Update prdhw.ldr 28 4.7 Configuratie NIS en Codex 29 Inrichten 29 Afronden 29 5 Controle 30 januari 18
6 Bijlage A: korte installatie checklist 31 4 januari 18
Inleiding 1 INLEIDING Deze handleiding is bedoeld om u stapsgewijs te helpen bij het implementeren van de Conviso IDscan. Op deze installatie zijn onze Algemene Voorwaarden van toepassing. U kunt deze nalezen op: https://www.vanbrug.nl/algemenevoorwaarden. Let op. De installatie kunt u alleen uitvoeren indien uw systeem minimaal beschikt over de eisen zoals in hoofdstuk 2 staan beschreven. De Conviso ID-scanner maakt gebruik van de Keesing ID DocumentScan applicatie om de gescande documenten te tonen en te verwerken naar het Notarieel Informatie Systeem (NIS). De gescande gegevens worden in een ZIP-bestand geplaatst en middels een ingesteld pad naar een centrale locatie verzonden, welke het NIS monitort. Het versturen van het XML-bestand naar de centrale locatie wordt uitgevoerd, nadat de eindgebruiker het gescande document in Keesing ID DocumentScan heeft geaccepteerd. 1.1 Aanpak Voor een succesvolle uitrol adviseren wij u om via de 4 onderstaande stappen de implementatie van de Conviso ID-scan uit te voeren: Systeemeisen (hoofdstuk 2) Voorbereiding (hoofdstuk 3) (hoofdstuk 4) Controle (hoofdstuk 5) 1.2 Checklist Om de complete installatie voor u overzichtelijk te houden, vindt u hieronder een eenvoudige checklist, die u kunt gebruiken tijdens het uitvoeren van de installatie. Uitvoeren Voltooid Doornemen systeemeisen (hoofdstuk 2) Uitvoeren voorbereiding (hoofdstuk 3) Uitvoeren installatie (hoofdstuk 4) Uitvoeren controle (hoofdstuk 5) Relevante gebruikers op de hoogte brengen van wijzigingen januari 18 5
Systeemeisen 2 SYSTEEMEISEN De omgeving waar de Conviso ID-scanner op wordt aangesloten en waarop de Keesing-ID Documentscan applicatie wordt geïnstalleerd, dient te voldoen aan de hierna te noemen systeemeisen. Deze systeemeisen zijn te vinden op deze locatie: https://www.vanbrug.nl/software/systeemeisen. Zijn er vragen over deze systeemeisen, neem dan contact op met onze afdeling Support (support@vanbrug.nl), voordat wordt gestart met deze implementatie. 2.1 NIS of Codex Om gebruik te kunnen maken van de integratie met het Notarieel Informatie Systeem (NIS), dient u te beschikken over de meest recente versie van NIS of Codex. U kunt deze versie inclusief releasenotes en installatiehandleiding downloaden via https://www.vanbrug.info/nisupdate. 2.2 Netwerk Het ZIP-bestand dient via een drive-mapping of UNC-pad geplaatst te worden in de centrale locatie op bijvoorbeeld een file-server. Indien er gebruik wordt gemaakt van een hostingomgeving en er is voor communicatie tussen de kantoorlocatie en de hostingomgeving geen VPN ingericht, dan is het noodzakelijk een VPN in te richten, zodat het ZIP-bestand verwerkt kan worden. 6 januari 18
Voorbereiding 3 VOORBEREIDING Voer de volgende voorbereidingen uit, voordat u start met de installatie van Conviso ID-scan: 3.1 Software Zorgt u ervoor, dat u beschikt over: o Een recente NIS of Codex update en dat u deze update heeft geïmplementeerd en geïnstalleerd. Updates zijn te downloaden via het NIS update center https://www.vanbrug.info/nisupdate. o De Conviso ID-scan installatie bestanden ( 2.8 GB), zowel een 32-bits als een 64-bits. Deze zijn tevens te downloaden via https://www.vanbrug.info/nisupdate. 3.2 Inhoud setup In de setup van de Conviso ID-scan installatie software is aanwezig: De Keesing software om gebruik te maken van de scanner. De Van Brug Conviso ID-scan software om de scans te verwerken, zodat deze later in NIS of Codex kunnen worden uitgelezen. De ConvisoNIS integratie óf de ConvisoCodex interface (apart te downloaden, zie hoofdstuk 4.3). 3.3 Overige benodigdheden Scanner Licentiecode 3.4 Rechten en instellingen cliënt (pc) U dient te beschikken over beheerder/administrator rechten. Het advies is om de update en de configuratie uit te voeren als [Administrator]. Controleer in het configuratie scherm van deze werkplek of de datum- en tijdinstellingen goed staan: o Tijd: UU:mm:ss o Datum dd:mm:jjjj 3.5 Verwijderen oude versie Wanneer er al een versie aanwezig is, dienen eerst de volgende onderdelen volledig te worden verwijderd: - AssureID Document Library (alléén vanaf AssureID Sentinel versie 5.0.x.x) - AssureID Sentinel - i-dentify Document Reader Drivers (x64) - Keesing AuthentiScan Premium - Keesing Reference Database januari 18 7
4 INSTALLATIE 4.1 Algemeen Sluit de scanner voor het uitvoeren van de installatie niet op de pc aan! 4.2 Conviso ID-scan Start het gedownloade bestand [convisosetupxxbits.exe] op als administrator (rechtermuisknop en uitvoeren als administrator). Het volgende venster verschijnt : Klik op [Volgende] en vervolgens weer op [Volgende], de bestanden worden nu uitgepakt naar een tijdelijke locatie. Tijdens de installatie verschijnt een venster met de voortgang van het betreffende onderdeel. 8 januari 18
MS Visual C++ 2012 Redistributable Indien een onderdeel al aanwezig is, kan een melding, zoals links hieronder vermeld verschijnen: Kies hier voor de optie [Repair]. Als het onderdeel geplaatst is, kunt u op [Close] klikken. Indien het onderdeel nog niet aanwezig is, plaatst u een vinkje bij het akkoord gaan met de algemene voorwaarden en kiest u daarna voor [Install] (rechter afbeelding). Ook kan het zijn, dat u een vergelijkbaar onderdeel al op uw systeem heeft dat nieuwer is, dan de aangeboden versie; u klikt dan op [Ok]. MS SQL Server Compact 4.0 Indien het onderdeel aanwezig is, ziet u het onderstaande venster: Kies hier voor [Repair] en daarna [Next]. Klik hier op [Repair]. Klik vervolgens in het volgende venster op [Finish]. januari 18 9
Indien het onderdeel nog niet geïnstalleerd is, zullen onderstaande vensters verschijnen: Volg de stappen door op [Next] en [Install] te klikken en als laatste actie klikt u op [Finish]. 10 januari 18
De installatie gaat verder met het volgende onderdeel. Keesing AuthentiScan Premium De volgende vensters verschijnen: Klik op [Install] Klik twee keer op [Next]. januari 18 11
Klik op [Install] om de installatie te starten. De statusbalk in het scherm geeft de voortgang weer. Klik nadat het programma klaar is met installeren op [Finish]. Keesing Reference Database Klik op [Next] om verder te gaan. Indien gewenst kunt u het pad aanpassen. Tip: Pas dit niet aan om toekomstige installaties van onderdelen te vergemakkelijken. Klik op [Next]. Klik op [Next]. 12 januari 18
Klik vervolgens na de op [Close]. Hiermee wordt de installatie van de Keesing Reference Database afgerond. I-Dentify Document Reader Nu worden de drivers voor de Document Reader geïnstalleerd. Voor de installatie van de i-dentify Document Reader Drivers kiest u voor [Next]. Indien u akkoord bent, accepteert u de voorwaarden en kiest u vervolgens voor [Next]. januari 18 13
Pas indien nodig het pad aan of laat het standaard aangegeven pad staan en kies [Next]. U selecteert [Custom] en vervolgens [Next]. Bij de installatie van de i-dentify Document Reader dient u alleen de [AR Hungary Document Readers] te selecteren. De overige onderdelen dienen te worden uitgeschakeld. Het uitschakelen van de drivers kan door het klikken op het onderdeel en [X This Feature will not be available] te kiezen, totdat u alle niet te installeren onderdelen heeft gehad. Daarna klikt u op [Next]. 14 januari 18
De installatie van de Drivers worden gestart door op [Install] te klikken. Het voortgangsvenster wordt getoond; zodra deze voltooid is verschijnt onderstaand venster. AssureID Sentinel Kies eerst voor [Next]. Vervolgens klikt u op [Finish]. Accepteer de voorwaarden door op [I Accept] te klikken en klik vervolgens op [Next]. januari 18 15
Vul de aan u verstrekte licentiecode in en klik op [Next]. Indien u op de standaard wijze wilt installeren, klikt u op [Next]. Anders past u eerst het pad aan bij [Change]. Hetzelfde geldt voor de Data Folder vraag in het vervolgvenster. Tip: Pas dit niet aan om toekomstige installaties van onderdelen te vergemakkelijken. Kies bij Setup type voor [Complete]. Klik vervolgens op [Next] Bij de vraag of u mee wilt doen met het Customer Experience Program klikt u op [No, I do not want to participate] en vervolgens op [Next]. 16 januari 18
Klik vervolgens op [Install]. De installatie wordt uitgevoerd. Zodra dit voltooid is verschijnt onderstaand venster. Klik op [Finish] om dit onderdeel af te ronden. AssureID Document Library januari 18 17
Kies voor [Next] en accepteer vervolgens de voorwaarden. Klik hierna nogmaals op [Next]. Pas indien gewenst het pad aan of laat deze op standaard ingesteld staan. Klik op [Next] en in het volgende venster op [Install] De installatie wordt uitgevoerd. Wanneer de installatie voltooid is kunt u op [Finish] klikken. 18 januari 18
Van Brug en Keesing ID-scan Software Na het installeren van de vereiste onderdelen verschijnt het volgende venster. Kies voor [standaard] en laat het pad staan. Vervolgens klikt u op [Volgende] en op [Installeren]. Tijdens de voortgang worden de bestanden die voor de interface tussen onze software en Keesing zorgen geplaatst. Als dit proces voltooid is klikt u op [Voltooien]. De tijdelijke Setup bestanden worden als laatste actie verwijderd. De installatie is afgerond en voltooid. 4.3 Deployment Codex en Keesing ID-scan integratie januari 18 19
De laatste stap is de installatie van de benodigde integratie bestanden om te zorgen dat NIS of Codex met de Keesing appratuur kan communiceren en u de gescande documenten kunt verwerken. Voor beide software paketten is er een andere interface. Het NIS pakket genereerd bestanden met de ZIP extensie. Het Codex pakket genereerd bestanden met een CONVISO extensie. Kijk of u de juiste executable heeft gedownload. Er is een aparte download voor NIS en voor Codex. Hier haalt u de Codex versie op https://www.vanbrug.info/downloads/conviso/convisocodex.exe Hier haalt u de NIS versie op https://www.vanbrug.info/downloads/conviso/convisonis.exe U kunt deze extractor direct uitvoeren vanuit uw browser wanneer u bent ingelogd als Administrator. Anders moet het bestand opgeslagen worden op een tijdelijke locatie op uw werkstation. Voer dit bestand dan uit met rechter muisknop, Als Administrator uitvoeren. De bestanden worden standaard uitgepakt naar de juiste locatie op uw werkstation. Kies voor [Uitpakken], de vraag overschrijven beantwoord u met [Ja op alles]. Na een korte voortgang verdwijnd het venster automatisch en is de deployment voltooid. 20 januari 18
4.4 Library Customization workaround uitvoeren. Na het installeren van het vereiste onderdelen en met name AsureID_Document_Library_Vx.x.xxxx wordt de geïntegreerde applicatie Library Customization elke keer naar standaard ingesteld wanneer de AsureID service is ge-herstart. Als workaround moet de volgende actie uitgevoerd worden. Dit moet elke keer wanneer er een nieuwe versie geïnstalleerd wordt. Eventueel kan onderstaand script in een Batch bestand toegevoegd worden: :COPYATS set ATSCOPIED="0" if EXIST "C:\Program Files (x86)\acuant\assureid Document Library\library\DocumentLibrary.ats" ( rename copy "C:\Program Files (x86)\acuant\assureid\library\documentlibrary.ats" DocumentLibraryOLD.ats "C:\Program Files (x86)\acuant\assureid Document Library\library\DocumentLibrary.ats" "C:\Program Files (x86)\acuant\assureid\library\documentlibrary.ats" set ATSCOPIED="1" ) if EXIST "C:\Program Files\Acuant\AssureID Document Library\library\DocumentLibrary.ats" ( rename "C:\Program Files\Acuant\AssureID\library\DocumentLibrary.ats" DocumentLibraryOLD.ats copy "C:\Program Files\Acuant\AssureID Document Library\library\DocumentLibrary.ats" "C:\Program Files\Acuant\AssureID\library\DocumentLibrary.ats" set ATSCOPIED="1" ) if %ATSCOPIED% EQU "1" ( echo ATS Copied ) else ( echo ATS NOT Copied ) Er wordt in bovenstaand script het volgende uitgevoerd. Het script komt twee keer voor; voor 32- en 64bits computers: 1. Het bestand in de map: "C:\Program Files (x86)\acuant\assureid\library\documentlibrary.ats" wordt hernoemd naar DocumentLibraryOLD.ats zodat er een back-up bestaat. 2. Hierna wordt het bestand in de map: "C:\Program Files (x86)\acuant\assureid Document Library\library\DocumentLibrary.ats" Gekopieerd naar: "C:\Program Files (x86)\acuant\assureid\library\documentlibrary.ats" Zonder deze actie worden de instellingen van hoofdstuk 4.6.2 naar standaard ingesteld op het moment als u de AsureID service (her-)start. januari 18 21
4.5 Configuratie Conviso ID-scan Snelkoppeling config Voordat er gewerkt kan worden met de Conviso ID-scan software dient de configuratie nog afgerond te worden. Dit kan niet wanneer de Conviso ID-scan in de standaardmodus wordt opgestart. Door de volgende stappen uit te voeren, kan dit met een aparte snelkoppeling wel worden gerealiseerd: Indien deze snelkoppeling [Van Brug Conviso - config] reeds aanwezig is, kunt u onderstaande stappen overslaan en gaan naar 4.4.2.. Ga naar de locatie waar de software is geïnstalleerd (doorgaans C:\Program Files (x86)\keesing Reference Systems\Keesing AuthentiScan Premium\). Maak hier een snelkoppeling van het bestand [Van Brug Conviso.exe]. Plaats deze snelkoppeling op dezelfde locatie als de installatiebestanden (doorgaans C:\Program Files (x86)\keesing Reference Systems\Keesing AuthentiScan Premium\). Wij adviseren om deze snelkoppeling de volgende naam te geven [Van Brug Conviso - config]. Vraag de eigenschappen op van deze snelkoppeling door met rechter muisknop op Van Brug Conviso - config te klikken. Ga naar het tabblad [Snelkoppeling], het volgende scherm wordt zichtbaar: Typ in het veld [Doel] aan het einde van de bestaande tekst (na de aanhalingstekens) het volgende: --config. Let op! Laat dus de bestaande tekst staan, zie ook bovenstaande printscreen. Klik hierna op [Ok]. 22 januari 18
Inrichten config Om de configuratie verder af te ronden, dienen er nog enkele stappen te worden uitgevoerd. Maak eerst een map aan waarin de scans straks moeten worden opgeslagen; bijvoorbeeld \\servernaam\idscans. Zorg ervoor dat deze map de juiste rechten heeft en gedeeld is. 4.5.2.1 STANDAARD Start de hierboven omschreven snelkoppeling [Van Brug Conviso.exe --config] op vanuit de installatielocatie met administrator rechten (bijv. C:\Program Files (x86)\keesing Reference Systems\Keesing AuthentiScan Premium\). Afhankelijk van de serverinrichting dient er gekozen te worden voor: o Standaard; of o FTP (cloud oplossing). Vul de locatie in waar de scans opgeslagen kunnen worden onder [Id-Scan xml locatie]; dit kan bijv. [\\servernaam\teksten\idscans\] worden. Vanuit de NIS software dient deze locatie ook benaderd te kunnen worden; hierover later meer. Indien u niet met een cloudoplossing werkt, gaat u verder naar 4.4.3. 4.5.2.2 FTP (CLOUD OPLOSSING) Vul de locatie in waar de scans (tijdelijk) kunnen worden opgeslagen onder [Id-Scan xml locatie], bijv. [C:\temp\]. Mocht deze map niet bestaan, maak deze dan aan. Vraag bij uw systeembeheerder de FTP gegevens op van uw cloud oplossing en vul deze in: o FTP locatie onder [FTP url]; o FTP Gebruikersnaam onder [Gebruikersnaam]; o FTP wachtwoord onder [Password]. Afronden Kies vervolgens voor [Opslaan]. Er wordt een config file aangemaakt op de locatie van de installatiebestanden (bijv. C:\Program Files (x86)\keesing Reference Systems\Keesing AuthentiScan Premium\). Sluit nu de scanner aan en wacht totdat deze geïnstalleerd is. januari 18 23
4.6 Configuratie Configuratie Keesing Software Start de Keesing Configuratie Software op door op de snelkoppeling [Configure Keesing AuthentiScan Premium] te klikken op het bureaublad. Op het tabblad [General] of [Algemeen]; stel de taal in op Nederlands. Op het tabblad [Wizard] bij extended checks of uitgebreide controle deze op [optioneel] configureren. Klik dan op [Save] of [Opslaan]. Sluit dit venster via de knop [Close] of [Sluiten]. Configuratie AsureID Software Klik met rechter muisknop op het icoon van AsureID en klik in het menu op [Activate License]. 24 januari 18
Het rode kruis staat door het icoon heen omdat de licentie nog niet geactiveerd is. Onderstaand venster verschijnt. Vul de licentiecode in het vak [License Key]. Klik op [Activate License] en vervolgens sluit u dit venster af met kruisje. Nu dienen er nog 4 kleine aanpassingen te maken in de AssureID Library Customization ; deze applicatie is te vinden in het Startmenu onder [AssureID]. Nadat u dit onderdeel gestart heeft, krijgt u het onderstaand venster: Kies [Yes] of [Ja] om de service te stoppen. De Library Customization zal nu opstarten; dit kan enige tijd in beslag nemen. Er verschijnt een venster zoals afgebeeld op de volgende pagina. Neem de 4 instellingen over door deze uit te schakelen. Daarnaast moeten er drie UV waardes in het kolom Importance aangepast worden volgens de afbeelding op de volgende pagina. januari 18 25
Nadat de aanpassingen zijn uitgevoerd, sluit u het venster door op het kruisje te klikken. 26 januari 18
Klik op [Yes] om de configuratie wijzigingen op te slaan Klik vervolgens weer met rechter muisknop op het AsureID icoon in het systeem vak en klik op [Start Service] om AsureID weer op te starten. Het rode kruis verdwijnt uit het icoon van AsureID. HEEFT U DE WORKAROUND UITGEVOERD BESCHREVEN IN HOOFDSTUK 4.4? Zonder deze workaround worden de instellingen naar standaard ingesteld bij het (her-)starten van de AsureID service. januari 18 27
ARH Driver Update prdhw.ldr ARH heeft een driver-update uitgebracht die van toepassing is op het I-dentity ARH-stuurprogramma. Dit betreft een handmatige actie die volgens onderstaande stappen uitgevoerd moet worden. 1. Stop de AssureID service door op de optie Shutdown Service te klikken die verschijnt als er met rechter muisknop op het icoon wordt geklikt in het systeemvak. 2. Download en Pak de ARH Driver Update prdhw.ldr uit. Dit bestand kunt u via deze link downloaden: https://www.vanbrug.info/downloads/conviso/ldr_update.zip 3. Voer de acties uit beschreven in Installation manual.txt (hieronder ook beschreven): o Vervang het bestand (als deze bestaat): C:\windows\system32\gx\pr\prdhw.ldr of C:\windows\syswow64\gx\pr\prdhw.ldr met het bestand prdhw.ldr die in het zip bestand te vinden is (30-5-2016). o Verwijder of hernoem C:\Programdata\gx\pr\*.bin (als deze bestaat). 4. Start de AssureID service door op de optie Start Service te klikken die verschijnt als er met rechter muisknop op het icoon wordt geklikt in het systeemvak. 28 januari 18
4.7 Configuratie NIS en Codex Inrichten De NIS of Codex software dient bekend te zijn met de vastgelegde centrale locatie waar de Zip of Conviso bestanden worden geplaatst. Voor de inrichting van NIS en Codex dient u de volgende stappen te volgen: Start de [Applicatie Manager] op. o De standaard locatie bij een NIS installatie is C:\program files (x86)\kaartenbak\appmgr\applicatiemanager.exe o De standaard locatie bij een Codex installatie is C:\program files (x86)\van Brug\AppMgr\Applicatiemanager.exe U gaat naar tabblad [Integraties] en klikt op [IdScan]. U vult in het veld [Id-Scan xml locatie] het pad in naar de centrale locatie waar de gegenereerde bestanden door de scansoftware geplaatst zullen worden. Plaats een snelkoppeling naar deze locatie op het bureaublad van de gebruiker die gebruik maakt van de Conviso ID-Scanner. Een Idscan verwijderen is alleen mogelijk vanuit deze map. 4.7.1.1 STANDAARD Vul de locatie in, welke ook is ingevoerd in [Van Brug Conviso - config], onder, [Id-Scan xml locatie]. Ga naar 4.5.2.. 4.7.1.2 FTP (CLOUD OPLOSSING) Vul de locatie in welke ook via de FTP is te benaderen en is ingevoerd in [Van Brug Conviso - config]. Afronden U klikt op [Configuratie opslaan]. U kunt de [Applicatie Manager] afsluiten. januari 18 29
Controle 5 CONTROLE Nu de installatie is afgerond, raden wij u aan om de applicatie te testen. U gaat hiervoor als volgt te werk: U start de software op door dubbel te klikken op de snelkoppeling op het bureaublad [Van Brug Conviso]. Voor verdere informatie verwijzen wij u naar de [Handleiding Conviso ID-scan gebruik]. Deze is te vinden bij een NIS installatie op..\kaartenbak\doc\ of bij een Codex installatie klikt u op het Codex icoon links bovenin het scherm van Codex of deze is op te vragen bij onze afdeling Support. Indien u de stappen in de handleiding succesvol hebt doorlopen, is de installatie correct uitgevoerd. 30 januari 18
Bijlage A: korte installatie checklist 6 BIJLAGE A: KORTE INSTALLATIE CHECKLIST Omschrijving Controle systeemeisen Benodigde software gedownload Controle rechten (administrator) Controle datum/tijdinstellingen Software installeren door setup Configuratie Conviso ID-scan invullen Configuratie Keesing controleren/wijzigen Configuratie NIS invullen Software testen Afgerond januari 18 31