Pinakes Integrator Client

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

[email protected] 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 http://services.pinakes.be/Integrator.

Pinakes

Integrator

Client

downloaden

via

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.


2


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 http://services.pinakes.be/Integrator

het

Pinakes

Integrator

Client

bestand

op

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 UserName

Standaard waarde

Password DatabaseType


Sql2012

Omschrijving De gebruikersnaam van een database account met rechten tot de databank. Het paswoord van een database account met rechten tot de databank. Het type van database dat gebruikt gaat worden. Andere mogelijke waardes zijn: 4

AccountKey WebApiUrl

http://services.pinakes.be/Inte grator/

DbServer DataBase InputPath

c:\temp\input\

XmlInputPath

c:\temp\input\xml\

Port

1433

Sql2008, Sql2005, Sql2000, Sql7, Mysql, Oracle De account sleutel om toegang te krijgen tot de Pinakes service. Het web adres waar de web api van Pinakes te bereiken is. De naam van de databank server. De naam van de databank. De folder waar het tijdelijke input bestand wordt opgeslagen. De folder waar het tijdelijke xml bestand wordt opgeslagen. 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!


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.

6

Pinakes Integrator Client

Recommend Documents