Pinakes Integrator Client Procédure d installation Pinakes S.A. Rue du Pavillon 7 1030 Schaerbeek TEL : +32 (0) 2 211 55 95 FAX : +32 (0) 2 211 56 56 INFO@PINAKES.BE WWW.PINAKES.BE
Table des matières I. Introduction... 2 L'objet du Pinakes Integrator Client Acquisition Pinakes Integrator Client Télécharger le Pinakes Integrator client Opération technique Pinakes Integrator Client II. Installation Pinakes Integrator Client... 4 Procédure d Installation III. Message d erreur possible... 6
Introduction L'objet du Pinakes Integrator Client Procurez-une copie de la base de données Pinakes et extraire la base de données Pinakes dans sa propre base de données. Acquisition Pinakes Integrator Client Une clé unique est nécessaire afin d'être en mesure d'utiliser le Pinakes Integrator client. Une demande de clé se fait en contactant info@pinakes.be. Télécharger le Pinakes Integrator client Le programme client Pinakes Integrator peut être téléchargé à l'aide d'un navigateur Web à l'adresse suivante http//services.pinakes.be/integrator. Opération technique Pinakes Integrator Client Le programme Pinakes Integrator Client, une fois installé sur un ordinateur connecté à Internet et activé, prend contact avec le Pinakes Integrator WebAPI pour télécharger les données Pinakes. Les données sont extraites et chargées dans votre base de données. Le serveur peut être MS SQL, Oracle ou MySQL. Le Pinakes Integrator Client peut être configuré afin qu une nouvelle version des données Pinakes soit obtenue périodiquement et automatiquement. PINAKES INTEGRATOR CLIENT 2
[A1] PINAKES INTEGRATOR CLIENT 3
Installation Pinakes Integrator Client Procédure d Installation 1. Condition base de données Oracle ou MySQL Pour exporter vers les bases de données Oracle ou MySQL, un opérateur de données ADO.NET est nécessaire. Celui-ci peut être téléchargé à partir de la page MSDN de Microsoft. http://msdn.microsoft.com/enus/data/dd363565.aspx 2. Créez une nouvelle base de données dans SQL Server ou Oracle ou MySQL DB avec le nom de votre choix. Ex. PinakesCopy. Créer également un compte sur votre base de données qui permet d'accéder à cette base de données. Le Pinakes Integrator Client aura besoin de ces coordonnées afin d y écrire les données. 3. Avec un navigateur Web, téléchargez l'application Pinakes Integrator Client via http://services.pinakes.be/integrator 4. Décompressez le fichier PinakesIntegratorClient.zip dans le répertoire de votre choix, puis dans ce répertoire, lancez le programme setup.exe. 5. Localisez le fichier "PinakesIntegratorClient.exe.config" dans le répertoire ex. c:\program Files (x86)\pinakes\pinakesintegrator et ouvrez le fichier. Configurez les paramètres suivants: - La clé unique; - Le nom du serveur SQL/serveur Oracle/MySQL; - Le nom de la base de données dans laquelle les données doivent être écrites; - Nom d'utilisateur et mot de passe du compte DB qui a accès à la base de données; - Le type de base de données (par défaut: SQL2012). D autres paramètres peuvent être modifiés également, comme le répertoire où les fichiers temporaires sont créés, par contre, il est préférable de laisser les paramètres par défaut. Description des paramètres et leurs valeurs par défaut: Nom Paramètre Valeur de défaut Description UserName Le nom d un utilisateur qui a des droits sur la base de données. Password Le mot de passe de l utilisateur de la base de données avec des droits d écriture sur la base de données. DatabaseType Sql2012 Le type de base de données qui sera utilisé. Les autres valeurs possibles sont: Sql2008, Sql2005, Sql2000, Sql7, Mysql, Oracle AccountKey La clé unique Pinakes WebApiUrl http://services.pinakes.be/integrator/ L'adresse web pour atteindre l'api Web Pinakes. DbServer Le nom du serveur de base de données. DataBase Le nom de la base de données. InputPath c:\temp\input\ Le répertoire ou entrée temporaire et où est enregistré le fichier. XmlInputPath c:\temp\input\xml\ Le répertoire où le fichier XML temporaire est enregistré. Port 1433 La porte de la base de données. Par défaut 1433 pour MS SQL ; 3306 pour MySQL ; et 1521 pour Oracle PINAKES INTEGRATOR CLIENT 4
6. Optionnellement vous pouvez stocker le fichier Nlog.config ailleurs. Par défaut, il est sauvegardé dans le dossier "logs" c est-à-dire, le dossier où se trouve le "PinakesIntegratorClient.exe". 7. Démarrez le programme client Pinakes Integrator en cliquant sur "PinakesIntegratorClient.exe". Faites-ceci avec des droits d'administrateur, sinon l écriture du procès ne sera pas sauvegardé dans le fichier log. Par défaut, le PinakesIntegratorClient.exe se trouve dans le dossier que vous avez choisi/créé (par exemple, c:\ PinakesIntegrator). 8. Les données peuvent être récupérées manuellement ou automatiquement: a) Manuel : Pour obtenir la dernière version des données Pinakes, il est recommandé de lancer le programme "PinakesIntegratorClient.exe" toutes les 24 heures, et après 24h00, comme décrit précédemment dans le point 7. Utilisez ce processus manuel également pour votre test. Faites ceci avec des droits administrateur et vérifiez le fichier log! b) Automatique / Périodique: Sélectionnez le programme "PinakesIntegratorClient.exe" avec par exemple Windows scheduler ou SQL scheduler. Faites-le avec des droits d'administrateur, sinon l écriture du procès ne sera pas sauvegardé dans le fichier log. Planifiez l exécution automatique après 24h00 pour recevoir les données les plus récente. Merci d avoir installé Pinakes Integrator Client! PINAKES INTEGRATOR CLIENT 5
Message d erreur possible Si des erreurs surviennent peuvent consulter le fichier «log» pour déterminer ce qui s'est passé. Ce fichier se trouve dans le répertoire où le client Pinakes Integrator a été installé. Ci-dessous un aperçu des messages d'erreur qui peuvent se produire: Message d erreur Déscription Quoi faire Unknown CallimachusOrganisation! L'organisation est inexistante contactez Pinakes service clientèle Unknown Account! Le Compte n'est pas connu contactez Pinakes service clientèle Unknown identifier! Erreur Système envoyez un e-mail au service technique Pinakes avec une copie du fichier «log» info@pinakes.be Account is not attached to a delivery! Le compte n'est pas lié à une livraison contactez Pinakes service clientèle Account is Locked! Le compte est bloqué contactez Pinakes service clientèle Client is Locked! Le client est bloqué contactez Pinakes service clientèle No autorization found for Pinakes Integrator! No autorization found for Full Database! Aucune autorisation trouvée pour utiliser le service Pinakes Integrator Pas d'accès à la base de données entière. contactez Pinakes service clientèle envoyez un e-mail au service technique Pinakes avec une copie du fichier «log» info@pinakes.be subscription outdated! Votre Abonnement à Pinakes contactez Pinakes service clientèle Integrator est expiré Internal Server Error! Erreur Système envoyez un e-mail au service technique Pinakes avec une copie du fichier «log» info@pinakes.be PINAKES INTEGRATOR CLIENT 6