Antes de começar
- Verifique se o Java está instalado na sua máquina antes de começar a instalar e configurar;
- Solicite o link de download do instalador Exploder Oobj ao seu consultor Oobj.
O que é o Exploder Oobj
O Exploder Oobj é uma solução da Oobj responsável por popular o banco de dados do cliente com dados específicos do DF-e.
Ele explode tanto NFe quanto CTe, realiza a leitura, validação e insere todas as informações detalhadas do arquivo XML em tabelas de um banco de dados à escolha do cliente (Oracle, SQL Server e Postgres).
Não importa a origem do documento: pode ser um XML emitido ou recebido de algum fornecedor. Certifique que os arquivos estejam no layout procNFE e procCTe.
Instale o Exploder Oobj
Agora que você já verificou os itens destacados em Antes de começar, siga estes passos:
1. Após o download do arquivo .zip, faça a extração dos arquivos no mesmo diretório onde estão instalados os outros serviços da Oobj. Geralmente, os serviços são instalados no diretório Windows: C:\Oobj\Aplicativos\Oobj, conforme a imagem abaixo:
2. Depois que terminar a extração, abra o Prompt do Windows e caminhe até o diretório onde foi instalado o serviço. O diretório padrão é o C:\Oobj\Aplicativos\Oobj\oobj-xml-exploder\bin.
3. Em seguida, execute o comando: oobj-xml-exploder install. Como retorno do comando, a seguinte mensagem será exibida “C:\Oobj\Aplicativos\Oobj\oobj-xml-exploder\bin>oobj-xml-exploder install wrapper | Oobj Df-e – XML Exploder service installed. Pressione qualquer tecla para continuar. . .”
Configure o Exploder Oobj
A integração da aplicação se dá por meio de pastas. Essa configuração é feita nos arquivos xml-exploder.properties, hibernate.properties e bd-config.xml que se encontram na pasta …\template. Copie esses arquivos para a pasta …\Config.
Feito isso, é necessário realizar as seguintes configurações:
Configure o xml-exploder.properties
O arquivo xml-exploder.properties responsável por definir os diretórios de trabalho do XML-Exploder, através da qual a aplicação irá processar os arquivos XMLs.
Edite as seguintes configurações:
DIRETORIO_ENTRADA: C:/Oobj/Integracao/exploder/entrada – Diretório de entrada, onde serão colocados os arquivos a serem importados
Configure o bd-config.xml
A aplicação tem conectividade com os bancos Postgres e Oracle. Conforme o ambiente, faça uma das configurações abaixo.
Postgres
O arquivo bd-config.xml responsável pela comunicação com o banco de dados. Para configurar um banco de dados diferente do padrão, é necessário alterar as informações: url/porta, usuário e senha:
<?xml version="1.0" encoding="UTF-8"?>
<!-- Tags obrigatórias: alias, driver, url, usuario, senha, implementacao
Tags opcionais: testar_antes, testar_depois, tamanho_inicial, tamaho_maximo, incremento,
query_validacao (sobrescrever configurações padrão da implementação escolhida) -->
<bancos>
<banco>
<alias>MC</alias>
<driver>org.postgresql.Driver</driver>
<url>jdbc:postgresql://18.212.142.102:5432/oobj_nfe_central</url>
<usuario>postgres</usuario>
<senha>postgres</senha>
<!-- Configuracoes de pool -->
<implementacao>gov.sefaz.persistencia.C3P0PoolConexoes</implementacao>
<tamanho_inicial>1</tamanho_inicial>
<tamanho_maximo>15</tamanho_maximo>
<testar_antes>false</testar_antes>
<testar_depois>false</testar_depois>
<query_validacao>SELECT 1</query_validacao>
</banco>
</bancos>Oracle
O arquivo bd-config.xml responsável pela comunicação com o banco de dados. Para configurar um banco de dados diferente do padrão, é necessário alterar as informações: url/porta, usuário e senha:
<?xml version="1.0" encoding="UTF-8"?>
<!-- Tags obrigatórias: alias, driver, url, usuario, senha, implementacao
Tags opcionais: testar_antes, testar_depois, tamanho_inicial, tamaho_maximo, incremento,
query_validacao (sobrescrever configurações padrão da implementação escolhida) -->
<bancos>
<banco>
<alias>MC</alias>
<driver>oracle.jdbc.driver.OracleDriver</driver>
<url>jdbc:oracle:thin:@//192.168.0.121:1521/orcl</url>
<usuario>teste</usuario>
<senha>teste</senha>
<!-- Configuracoes de pool -->
<implementacao>gov.sefaz.persistencia.C3P0PoolConexoes</implementacao>
<tamanho_inicial>1</tamanho_inicial>
<tamanho_maximo>15</tamanho_maximo>
<testar_antes>false</testar_antes>
<testar_depois>false</testar_depois>
<query_validacao>SELECT 1</query_validacao>
</banco>
</bancos>Configure o hibernate.properties
Em seguida, configure o arquivo hibernate.properties. Neste arquivo, o principal ajuste é no dialeto e por padrão o utilizado é PostgreSQL e caso o ambiente utilize outro banco, comente a linha do Postgres e descomente a linha do banco utilizado:
Teste as suas configurações
Após as configurações, você já pode testar o aplicativo:
1. Abra o Serviço do Windows. Para isso, você pode digitar o comando “services.msc” na aba de pesquisas ou no Executar.
2. Localize o serviço Oobj DF-e – XML Exploder, clique em Iniciar e espere carregar.
Pronto, o serviço do XML-Exploder já pode ser utilizado.
