Installation drivers MySQL xCP Designer
Dans le cadre d'un projet, il était demandé de pouvoir se connecter à une base de données MySql depuis les processus modélisés. Par défaut, il existe un ensemble de drivers mis en place sous xCP Designer
, mais pas celui pour MySql.
Cet article présente les actions nécessaires, afin de pouvoir bénéficier du driver.
Sommaire
Votre avis
Nobody voted on this yet
|
|
Téléchargement
Afin de pouvoir l'installer, il faut l'avoir à disposition. Le driver est disponible sur le site de MySQL. Dans le cadre de cet article, la version 5.1.38
est téléchargée.
Installation
L'installation consiste à référencer une nouvelle extension Java, tout simplement.
Fichier jar
Une fois téléchargé, le fichier jar du driver est placé dans le sous répertoire content/modules
de l'application, soit à l'emplacement content/modules/mysql-connector-java-5.1.38-bin.jar
dans le cadre de cette mise en place.
Définition extension
L'extension est définie à l'aide d'un fichier XML
dans le répertoire Artifacts/Java Modules
de l'application. Si besoin, le sous répertoire Java Modules
doit être créé.
Pour cette installation, le driver sera installé avec les valeurs suivantes.
- Nom artefact : mysql_driver;
- Label artefact : MySQL Driver.
Le nom du fichier XML doit correspondre au pattern <NOM ARTEFACT>.javamodule
, soit mysql_driver.javamodule
pour cet exemple.
Lors de l'ajout d'une extension, le contenu du fichier XML est le suivant.
<?xml version="1.0" encoding="UTF-8"?>
<nsJavaModule:JavaModule xmlns:nsJavaModule="http://xcp.emc.com/javamodule" urn="urn:xcp:com.emc.xcp.artifact.javamodule.category:Artifacts/Java Modules/<NOM ARTEFACT>.javamodule" categoryId="com.emc.xcp.artifact.javamodule.category" name="<NOM ARTEFACT>" label="<LABEL ARTEFACT>" implementationClass="<CLASS IMPLEMENTATION>">
<interfaceClassNames><NOM DES INTERFACES></interfaceClassNames> <!-- Optional 0 or more-->
<implementationJars contentPath="content/modules/<FICHIER JAR>"/> <!-- 1 or more -->
</nsJavaModule:JavaModule>
Pour cette installation, le fichier est donc complété de la façon suivante.
- <NOM ARTEFACT> remplacé par
mysql_driver
; - <LABEL ARTEFACT> remplacé par
MySQL Driver
; - <CLASS IMPLEMENTATION> remplacé par
com.mysql.jdbc.Driver
; - <NOM DES INTERFACES> remplacé par
java.sql.Driver
. Une seule interface est définie pour cette classe; - <FICHIER JAR> remplacé par
mysql-connector-java-5.1.38-bin.jar
. Un seul jar est mis à disposition.
<?xml version="1.0" encoding="UTF-8"?>
<nsJavaModule:JavaModule xmlns:nsJavaModule="http://xcp.emc.com/javamodule" urn="urn:xcp:com.emc.xcp.artifact.javamodule.category:Artifacts/Java Modules/mysql_driver.javamodule" categoryId="com.emc.xcp.artifact.javamodule.category" name="mysql_driver" label="MySQL Driver" implementationClass="com.mysql.jdbc.Driver">
<interfaceClassNames>java.sql.Driver</interfaceClassNames> <!-- Optional 0 or more-->
<implementationJars contentPath="content/modules/mysql-connector-java-5.1.38-bin.jar"/> <!-- 1 or more -->
</nsJavaModule:JavaModule>
Utilisation
Une fois référencé, il suffit de redémarrer xCP Designer
et le driver sera disponible lors de la déclaration d'un EndPoint
de type Database
. Pour cela, il faut ouvrir le panneau Application
et activer le menu contextuel de l'élément Endpoints
par un clic droit.
Sur la fenêtre affiché, il faut sélectionner le type Database
et spécifier un nom, MySQL Access
dans le cadre de cet article.
Sur la page de spécialisation du enpoint, le driver est alors disponible dans la liste de choix.