Como fazer a instalação e configuração do Exploder Oobj?

O XML Exploder é 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. Basta que os arquivos estejam no layout procNFE e procCTe.

Procedimento

O primeiro passo para realizamos a instalação é baixar o pacote de instalação do Exploder, solicite o link de download que é fornecido pelo seu consultor Oobj.

Instalação

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
Em seguida, irá aparecer a mensagem conforme a imagem abaixo:

Configuração

A integração da aplicação se dá através de pastas. Essa configuração é feita nos arquivos xml-exploder.properties, hibernate.properties e bd-config.xml que se encontram na pasta ..\template. Copie os arquivos para a pasta ..\Config.

Feito isso, vamos realizar as configurações necessárias.

Banco de dados

Postgres

Primeiramente, vamos configurar o arquivo bd-config.xml que é 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

Primeiramente, vamos configurar o arquivo bd-config.xml que é 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>

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, basta comentar a linha do Postgres e descomentar a linha do banco utilizado:

XML-Exploder

Após isso, vamos configurar o arquivo xml-exploder.properties que é 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

Após as configurações, você já pode iniciar 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 e clique em Iniciar e espere carregar. 

Pronto, o serviço do XML-Exploder já pode ser utilizado.