3.2. Configurando Persistências para o Dashbuilder

Como o Dashbuilder é dependente da configuração do Business Central, certifique-se de que o Business Central esteja configurado de acordo com a Seção 3.1, “Configurando Persistências para o Business Central”. O Red Hat BPM Suite 6 é configurado para usar uma fonte de dados com o nome JNDI (Java Naming and Directory Interface) java:jboss/datasources/ExampleDS. Caso deseje que o aplicativo funcione com um banco de dados diferente do H2 como, por exemplo, Oracle, MySQL, Postgres ou MS SQL Server, siga as instruções a seguir.

Nota

Caso queira usar UTF 8 para exibir os caracteres que não sejam do inglês, você deve verificar a documentação do seu banco de dados e configurar a codificação ao nível do banco de dados para que o Dashbuilder funcione corretamente. Por exemplo, no MySQL, adicione ao arquivo de configuração do servidor o seguinte: 
[mysqld]
character-set-server=utf8
collation-server=utf8_general_ci

Importante

Nos sistemas Unix, substitua o valor padrão do MySQL lower_case_table_names de 0 (diferenciando maiúsculas de minúsculas) para 1 (não diferenciando maiúsculas de minúsculas). As consultas do Red Hat JBoss BPM Suite KPI são gravadas em minúsculas, mas os nomes das tabelas são gravados em camelCase. Ao mudar a propriedade lower_case_table_names, você evitará que as exceções ocorram depois.
  1. Instale o driver do banco de dados e crie uma nova fonte de dados de acordo com o exemplo na documentação do EAP 6, na seção Exemplo da Fonte de Dados PostgreSQL. Use uma abordagem modular para a instalação do driver JDBC para facilitar a configuração subsequente.
  2. Crie um banco de dados vazio.
  3. Modifique o arquivo dashbuilder.war/WEB-INF/jboss-web.xml cuja entrada padrão é: 
      	<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. Modifique também os arquivos WEB-INF/jboss-deployment-structure.xml, de ambos os aplicativos business-central.war e dashbuilder.war, e adicione uma dependência sob a seção de dependências no módulo do driver JBDC, criado anteriormente durante a criação da fonte de dados. O snippet a seguir mostra uma configuração de amostra onde jdbcDriverModuleName é o nome do módulo do driver JDBC do JBoss EAP 6. 
      <dependencies>
         ...
            <module name="jdbcDriverModuleName" />
            ...
  </dependencies>