3.2. Installation de la Persistance pour Dashbuilder

Étant donné que Dashbuilder dépend de la configuration de Business Central, assurez-vous que Business Central est configuré selon Section 3.1, « Installation de la Persistance pour Business Central ». Red Hat JBoss BPM Suite 6 est configuré pour utiliser une source de données avec un nom JNDI (Java Naming and Directory Interface) java:jboss/datasources/ExampleDS. Si vous souhaitez faire fonctionner l'application avec une base de données différente de H2, par exemple Oracle, MySQL, Postgres ou MS SQL Server, suivez ces étapes.

Note

Si vous souhaitez utiliser UTF 8 pour afficher des caractères spéciaux, vérifiez la documentation concernant votre base de données et définissez le codage au niveau de la base de données afin que Dashbuilder puisse fonctionner correctement. Par exemple dans MySQL, ajoutez ce qui suit au fichier de configuration du serveur : 
[mysqld]
character-set-server=utf8
collation-server=utf8_general_ci

Important

Sur les systèmes de type Unix, changez la valeur par défaut de MySQL lower_case_table_names de 0 (sensible à la casse) en 1 (non sensible à la casse). Les requêtes Red Hat JBoss BPM Suite KPI sont écrites en minuscule, mais les noms de tableau sont écrits en casse mixte. En modifiant la propriété lower_case_table_names, vous éviterez que des exceptions se produisent ultérieurement.
  1. Installez le pilote de base de données et créez une nouvelle source de données suivant l'exemple dans la documentation EAP 6, section Exemple de Source de données PostgreSQL. Installez le pilote JDBC de manière modulaire pour faciliter la configuration.
  2. Créer une base de données vide.
  3. Modifiez le fichier dashbuilder.war/WEB-INF/jboss-web.xml dont l'entrée par défaut est : 
      	<jboss-web>
    <context-root>/dashbuilder</context-root>
    <resource-ref>
        <res-ref-name>jdbc/dashbuilder</res-ref-name>
        <res-type>javax.sql.DataSource</res-type>
        <jndi-name>java:jboss/datasources/ExampleDS</jndi-name>
    </resource-ref>
  4. Modifiez également les fichiers WEB-INF/jboss-deployment-structure.xml à des applications business-central.war et dashbuilder.war, et ajoutez une dépendance sous la section des dépendances sur le module de pilote JBDC créé précédemment lors de la création de source de données. Le snippet suivant montre un exemple de configuration où jdbcDriverModuleName représente le nom du module pilote JBoss EAP 6 JDBC. 
      <dependencies>
         ...
            <module name="jdbcDriverModuleName" />
            ...
  </dependencies>