Pinakes Integrator Client Installatie procedure Pinakes NV Paviljoenstraat 7 1030 Schaarbeek TEL : +32 (0) 2 211 55 95 FAX : +32 (0) 2 211 56.56 INFO@PINAKES.BE WWW.PINAKES.BE
1. Inhoudstafel 1. Inhoudstafel... 1 2. Inleiding... 2 2.1. Doel van Pinakes Integrator Client... 2 2.2. Aanschaf Pinakes Integrator Client... 2 2.3. Download van de Pinakes Integrator Client... 2 2.4. Werking Pinakes Integrator Client... 2 3. Installatie Procedure Pinakes Integrator client... 4 4. Mogelijke Foutmeldingen... 6 PINAKES INTEGRATOR CLIENT 1
2. Inleiding 2.1. Doel van Pinakes Integrator Client Een kopie ophalen van datagegevens uit de Pinakes databank en deze extraheren in een eigen databank. 2.2. Aanschaf Pinakes Integrator Client Om gebruik te kunnen maken van de Pinakes Integrator Client is een unieke sleutel nodig. Deze kan u aanschaffen door contact op te nemen met Pinakes. 2.3. Download van de Pinakes Integrator Client Men kan het programma Pinakes Integrator Client downloaden via http://services.pinakes.be/integrator. 2.4. Werking Pinakes Integrator Client De Pinakes Integrator Client, die op een machine met internet verbinding in uw omgeving werd geïnstalleerd en geactiveerd, maakt contact met de Pinakes Integrator WebAPI om de data te downloaden. De data wordt uitgepakt en wordt ingeladen in uw databank. De server kan MS SQL, Oracle of MySQL zijn. De Pinakes Integrator Client kan zodanig worden ingesteld zodat deze periodiek een nieuwe versie van de datagegevens kan opvragen bij de Pinakes Integrator. PINAKES INTEGRATOR CLIENT 2
PINAKES INTEGRATOR CLIENT 3
3. Installatie Procedure Pinakes Integrator client 1. Randvoorwaarde Oracle of MySQL Databank Om te kunnen exporteren naar Oracle of MySQL Databanken dienen de specifieke ADO.NET Data Providers geïnstalleerd zijn. Deze kunnen gedownload worden via de MSDN pagina van Microsoft. http://msdn.microsoft.com/en-us/data/dd363565.aspx 2. Creëer een nieuwe databank in SQL server of Oracle DB of MySQL met een zelfgekozen naam. Vb. PinakesCopy. Maak ook een account aan op uw databank die toegang geeft tot deze databank. De Pinakes Integrator Client heeft dit account later nodig om de data weg te schrijven. 3. Download via de webbrowser het Pinakes Integrator Client bestand op http://services.pinakes.be/integrator 4. Pak het bestand uit in een folder naar keuze en voer het programma SetupPinakesIntegrator.msi uit. 5. Zoek daarna het bestand PinakesIntegratorClient.exe.config op in de folder waar de Pinakes integrator is geïnstalleerd (vb. C:\Program Files (x86)\pinakes\pinakesintegrator) en open het bestand. Volgende instellingsinformatie moet worden toegevoegd: - de toegezonden sleutel - de naam van de SQL server of Oracle server of MySql server - de naam van de databank waarin de Pinakes data moet worden opgeslagen - gebruikersnaam en wachtwoord van het account met toegang tot de databank - database type (standaard: Sql2012) Er kunnen ook nog andere instellingen gewijzigd worden zoals de directory waar tijdelijke bestanden worden aangemaakt, doch is het aangeraden om deze standaard instellingen niet te wijzigen. Volgende tabel geeft de mogelijke instellingen en standaard waarden weer: Instellings naam Standaard waarde Omschrijving UserName De gebruikersnaam van een database account met rechten tot de databank. Password Het paswoord van een database account met rechten tot de databank. DatabaseType Sql2012 Het type van database dat gebruikt gaat worden. Andere mogelijke waardes zijn: PINAKES INTEGRATOR CLIENT 4
Sql2008, Sql2005, Sql2000, Sql7, Mysql, Oracle AccountKey De account sleutel om toegang te krijgen tot de Pinakes service. WebApiUrl http://services.pinakes.be/inte grator/ Het web adres waar de web api van Pinakes te bereiken is. DbServer De naam van de databank server. DataBase De naam van de databank. InputPath c:\temp\input\ De folder waar het tijdelijke input bestand wordt opgeslagen. XmlInputPath c:\temp\input\xml\ De folder waar het tijdelijke xml bestand wordt opgeslagen. Port 1433 De poort van de database. Standaard is dit 1433 voor MS SQL, 3306 voor MySQL en 1521 voor Oracle 6. Optioneel kan in het bestand Nlog.config de locatie van de logbestanden aangepast worden. Standaard is dat in de logs folder binnen de folder waar PinakesIntegratorClient.exe staat. 7. Start het Pinakes Integrator Client programma d.m.v. het aanklikken van PinakesIntegratorClient.exe. Doe dit met administrator rechten, zoniet kan de logging niet worden weggeschreven. De PinakesIntegratorClient.exe kan u terugvinden in de folder naar keuze (vb. c:\pinakesintegrator). 8. Gegevens kunnen manueel of automatisch opgevraagd worden: a. Manueel: Om de laatste nieuwe versie van de Pinakes gegevens te verkrijgen is het aan te raden om het PinakesIntegratorClient.exe programma elke 24u, en na 24u00, te herhalen zoals beschreven in puntje 7. i. Gebruik dit manueel proces ook om te testen of alles naar wens loopt. Doe dit ook met administrator rechten en check het logging bestand! b. Automatisch/gepland: Selecteer het programma PinakesIntegratorClient.exe met administrator rechten via vb. windows scheduler of SQL scheduler. Doe dit met administrator rechten, zoniet kan de logging niet worden weggeschreven. Stel de scheduler in na 24u00 om de gegevens van diezelfde dag te ontvangen. Pinakes Integrator Client is nu geïnstalleerd en actief! PINAKES INTEGRATOR CLIENT 5
4. Mogelijke Foutmeldingen Indien er zich fouten voordoen, kan er in het log bestand gekeken worden. Hieronder een overzicht van mogelijke meldingen die gerelateerd zijn aan uw account: Meldingen Unknown CallimachusOrganisation! Unknown Account! Unknown identifier! Account is not attached to a delivery! Account is Locked! Client is Locked! No autorization found for Pinakes Integrator! No autorization found for Full Database! subscription outdated! Internal Server Error! Beschrijving De organisatie is onbestaande Account is niet gekend Systeemfout, contacteer hierbij de service desk Het account is niet gekoppeld aan een levering Het account is geblokkeerd De klant is geblokkeerd Geen toegang gevonden voor gebruik van de service Pinakes Integrator Geen toegang tot de gehele databank Subscriptie tot Pinakes Integrator is verlopen Systeemfout. Contacteer Pinakes. PINAKES INTEGRATOR CLIENT 6