Commit e22f1102b338619299c995747a0e9be5c825b53a
1 parent
7fadd172
Exists in
master
and in
1 other branch
Documenta a configuração dos datasources
- Procedimento de configuração dos datasources no JBoss.
Showing
1 changed file
with
28 additions
and
2 deletions
Show diff stats
README.md
| 1 | # SEI-Broker - Camada REST de acesso ao SEI | 1 | # SEI-Broker - Camada REST de acesso ao SEI |
| 2 | -O SEI-Broker é uma camada de integração que foi desenvolvida para integrar os sistemas corporativos da ANS e o SEI, Sistema Eletrônico de Informações do TRF 4. Toda essa camada foi criada utilizando o padrão RESTful de serviços web, sua função é facilitar a integração dos sistemas da ANS com o SEI, utilizando um protocolo mais simples, moderno e performático. A adoção do broker nos permite criar uma camada de abstração para evitar que mudanças no SEI afetem as integrações, isso é possivel pelo fato do broker utilizar REST e possuir contrato fraco. | 2 | +O SEI-Broker é uma camada de integração que foi desenvolvida para integrar os sistemas corporativos da ANS e o SEI, Sistema Eletrônico de Informações do TRF 4. Toda essa camada foi criada utilizando o padrão RESTful de serviços web, sua função é facilitar a integração dos sistemas da ANS com o SEI, utilizando um protocolo mais simples, moderno e performático. A adoção do broker nos permite criar uma camada de abstração para evitar que mudanças no SEI afetem as integrações, isso é possível pelo fato do broker utilizar REST e possuir contrato fraco. |
| 3 | 3 | ||
| 4 | O Broker atualmente está na versão 2.9, essa versão é compatível com o SEI 3.0.13. É importante destacar que é necessário atualizar o SEI-Broker a cada atualização do SEI que altere os serviços web. | 4 | O Broker atualmente está na versão 2.9, essa versão é compatível com o SEI 3.0.13. É importante destacar que é necessário atualizar o SEI-Broker a cada atualização do SEI que altere os serviços web. |
| 5 | 5 | ||
| @@ -11,4 +11,30 @@ Alguns serviços adicionais foram desenvolvidos extrair dados que não são ofer | @@ -11,4 +11,30 @@ Alguns serviços adicionais foram desenvolvidos extrair dados que não são ofer | ||
| 11 | - Apache Maven para baixar as dependências e compilar o pacote. | 11 | - Apache Maven para baixar as dependências e compilar o pacote. |
| 12 | - Servidor JBoss EAP 7.0.4 ou Wildfly 10. | 12 | - Servidor JBoss EAP 7.0.4 ou Wildfly 10. |
| 13 | - Banco relacional, o Broker foi desenvolvido usando Oracle 12g, mas com pouco esforço pode utilizar o MySQL. | 13 | - Banco relacional, o Broker foi desenvolvido usando Oracle 12g, mas com pouco esforço pode utilizar o MySQL. |
| 14 | -- Conexão com a internet para que o Maven acesse os repositórios hospedeiros das dependências. | ||
| 15 | \ No newline at end of file | 14 | \ No newline at end of file |
| 15 | +- Conexão com a internet para que o Maven acesse os repositórios hospedeiros das dependências. | ||
| 16 | + | ||
| 17 | +## Procedimentos para instalação | ||
| 18 | +1. Configure as propriedades dos datasources no JBoss, elas são declaradas como System Properties. | ||
| 19 | + | ||
| 20 | +O broker possui dois datasources e ambos estão declarados no arquivo `sei-broker-ds.xml`, eles são identificados como `jdbc/sei-broker` e `jdbc/sei-mysql`. O `jdbc/sei-broker` foi definido para acessar as tabelas que foram projetadas para o broker, o `jdbc/sei-mysql` se conecta ao banco de dados do SEI. | ||
| 21 | + | ||
| 22 | +| Chave | Valor | | ||
| 23 | +| --------------------------------------------- | --------------------------------------------- | | ||
| 24 | +| br.gov.ans.seiBroker.db.oracle.connectionUrl | String de conexão com o banco Oracle | | ||
| 25 | +| br.gov.ans.seiBroker.db.oracle.password | Senha do usuário utilizado no datasource | | ||
| 26 | +| br.gov.ans.seiBroker.db.mysql.connectionUrl | String de conexão com o banco MySQL do SEI | | ||
| 27 | +| br.gov.ans.seiBroker.db.mysql.user | Nome usuário com acesso ao MySQL do SEI | | ||
| 28 | +| br.gov.ans.seiBroker.db.oracle.password | Senha do usuário com acesso ao MySQL do SEI | | ||
| 29 | + | ||
| 30 | +Abaixo um exemplo de declaração de propriedades feita no arquivo `standalone.xml`. | ||
| 31 | +```xml | ||
| 32 | +<!-- Geralmente no início do arquivo, após as extensions --> | ||
| 33 | +<system-properties> | ||
| 34 | + <!-- Outras propriedades ... --> | ||
| 35 | + <property name="br.gov.ans.seiBroker.db.oracle.connectionUrl" value="jdbc:oracle:thin:@exans01db04.ans.gov.br:1523:anshm2"/> | ||
| 36 | + <property name="br.gov.ans.seiBroker.db.oracle.password" value="******"/> | ||
| 37 | + <property name="br.gov.ans.seiBroker.db.mysql.user" value="usuario_sei_brok"/> | ||
| 38 | + <property name="br.gov.ans.seiBroker.db.mysql.connectionUrl" value="jdbc:mysql://anshmmysql01:3306/sei-ds"/> | ||
| 39 | + <property name="br.gov.ans.seiBroker.db.mysql.password" value="******"/> | ||
| 40 | +</system-properties> | ||
| 41 | +``` |