1. Configuration

Perfect-Vision a été développé de façon à s’installer sur toutes les plateformes pouvant exécuter du code écrit en Java. Il peut être utilisé avec tout type de système de gestion de base de données.

Pour permettre à Perfect-Vision de s’exécuter, il est important de configurer le serveur ou la machine sur laquelle il sera installé d’une certaine façon.

1.1. Configuration des variables d’environnement

1.2. Sous Linux

Il faut la définir avec la commande suivante : export PERFECTPATH=chemin_du_répertoire où chemin_du_répertoire est le répertoire dans lequel se trouve le fichier de configuration de l’accès à la base de données.

1.3. Sous Windows

Il faut créer une variable d’environnement nommée PERFECTPATH. Elle doit avoir pour valeur le répertoire dans lequel seront enregistrés les paramètres d’accès à la base de données.

NB:

  • Le répertoire précisé lors de la création de la variable d’environnement PERFECTPATH doit bel et bien existé.
  • On doit créer dans ce répertoire le fichier config-tout.properties
  • L’accès à ce fichier et les informations qui s’y trouvent doivent être protégés et connus que des ayants droit.

1.4. Configuration du fichier config-tout.properties

Ce fichier comporte la déclaration de sept (7) valeurs obligatoires.

1.5. dataSource.driverClassName

Il s’agit du pilote d’accès à la base de données. Il diffère selon le SGBD qui héberge la base de données. Ainsi, on a:

  • pour SQL Server : net.sourceforge.jtds.jdbc.Driver
  • pour PostgreSQL : org.postgresql.Driver
  • pour Oracle : oracle.jdbc.driver.OracleDriver
  • pour MySQL : com.mysql.jdbc.Driver

Exemple pour SQL Server : dataSource.driverClassName = net.sourceforge.jtds.jdbc.Driver

1.6. dataSource.url

Il s’agit de l’adresse à laquelle trouver la base de données.

Pour cette variable, host désigne l’adresse du serveur hébergeant le serveur de données, port le port sur lequel fonctionne le serveur, database le nom de la base de données.

Pour Oracle, on spécifie juste le nom du service utilisé pour la base de données.

Exemple pour SQL Server : dataSource.url = jdbc:jtds:sqlserver://localhost:1433/ma_base

1.7. dataSource.username

C’est le nom de l’utilisateur autorisé à se connecter à la base de données.

1.8. dataSource.password

Il s’agit du mot de passe de l’utilisateur.

1.9. entityManagerFactory.jpaVendorAdapter.showSql

Cette valeur est utile pour les détections d’erreurs. Elle permet à Perfect-Vision d’afficher les requêtes lancées vers la base de données. Elle prend la valeur true ou la valeur false.

1.10. entityManagerFactory.jpaVendorAdapter.generateDdl

Cette valeur est utile pour les détections d’erreurs. Elle permet à Perfect-Vision d’afficher les requêtes de création des tables des données. Elle prend la valeur true ou la valeur false.

1.11. entityManagerFactory.jpaVendorAdapter.databasePlatform

  • pour SQL Server 2005 : org.hibernate.dialect.SQLServer2005Dialect
  • pour SQL Server 2008 : org.hibernate.dialect.SQLServer2008Dialect
  • pour SQL Server 2012 : org.hibernate.dialect.SQLServer2012Dialect
  • pour PostgreSQL 8.1 : org.hibernate.dialect.PostgreSQL81Dialect
  • pour PostgreSQL 8.2 : org.hibernate.dialect.PostgreSQL82Dialect
  • pour Oracle 8i : org.hibernate.dialect.Oracle8iDialect
  • pour Oracle 9 : org.hibernate.dialect.Oracle9Dialect
  • pour Oracle 9i : org.hibernate.dialect.Oracle9iDialect
  • pour Mysql 5 : org.hibernate.dialect.MySQL5Dialect

Ainsi, pour l’accès à une base de données de Perfect-Vision utilisant SQL Server, le fichier config-tout.properties comportera ce contenu :

Exemple pour SQL Server : entityManagerFactory.jpaVendorAdapter.databasePlatform = org.hibernate.dialect.SQLServer2012Dialect