Visão Geral

O Gerenciador de Exportações tem como objetivo exportar dados de um Banco de Dados para outro.

Gerenciador de exportação de dados 

ACESSO Módulo Integradores → Menu Gerenciador de Exportações de dados

No gerenciador temos os seguinte painéis:

Cada painel será explicado a seguir.

Fontes de dados 

No primeiro painel teremos as configurações de conexão ao banco de dados.

Para configurar o acesso a um banco de dados clique no botão 'Inserir Registro'.

O operador deverá informar:

• Código - Código auto-numerável atribuído pelo banco de dados (Bloqueado para edição)
• Data/Hora - Data e hora de cadastro (Bloqueado para edição)
• Operador de cadastro - Operador de cadastro (Bloqueado para edição)
• Descrição - Descrição identificativa da fonte de dados.
• Nome do banco de dados - Nome do Banco de dados  
• Tipo de banco - Escolha uma das seguintes opções
  
  • Oracle
  • Postgres
• Tipo de fonte -
  • Origem - Significa que esta é a conexão da onde se originará os dados a serem exportados 
• Host - IP ou URL de acesso ao banco
  
• Porta - Porta em que o banco de dados está configurado
• Nome do usuário - Nome de usuário para conexão com o banco de dados
• Senha usuário - Senha para conexão com o banco de dados
• Comentários - Comentários e observações gerais sobre a fonte de dados.

Marque a opção 'Tem certeza que deseja gravar esta fonte de dados?' para confirmar o procedimento e clique no botão 'Finalizar'.

Pronto! A configuração para acesso ao banco de dados foi configurado. 

Caso queira editar alguma informação de acesso, selecione o banco de dados na grade e clique no botão 'Editar' 

Altere as informações como desejar, da mesma forma como explicado no cadastro , marque a opção 'Tem certeza que deseja gravar esta fonte de dados?' para confirmar o procedimento e clique no botão 'Finalizar'.

Schemas de exportações

No segundo painel será onde iremos cadastrar as consultas dos dados que iremos exportar.

Para cadastrar a consulta do banco clique no botão 'Inserir Registro'

O operador deverá informar: 

• Descrição - Descrição identificativa do registro
• Instrução SQL da consulta - Informe a instrução para a consulta SQL. 

Algumas observações sobre a sintaxe do SQL:

• As colunas no select devem possuir o mesmo nome da coluna da tabela destino. Caso não seja igual veja o exemplo abaixo como poderá ser contornado 
  Exemplo:

  tipo_doc as Nome_Coluna_destino,
  from mk_doc_fiscal_competencia 

  onde,

          tipo_doc é o nome da coluna no banco origem e
          Nome_Coluna_destino é o nome da coluna no banco destino 

• Para os comandos do Where disponibilizamos a seguinte regra para auxiliar na filtragem no dados no Perfil de Exportações (Será explicado a seguir)
  
  Variáveis poderão ser criadas definindo seu nome entre os comandos  <! e !>
  Exemplo: 
  Ao definirmos <!tipo!> estamos criando a variável tipo
  
  Então no script abaixo teremos as seguintes variáveis: 

  • di

  • df

  • tipo 

  • cliente  

data>=<!di!> and 
data<=<!df!> and 
tipo=<!tipo!> and 
credor_devedor=<!cliente!>  

Marque o check "Ao avançar esta etapa, o registro será salvo. Confirma seu interesse?" para dar ciência ao procedimento e clique no botão 'Avançar'

Caso na sintaxe do Where tenha a definição de algumas variáveis como explicado anteriormente, nesta etapa o operador irá definir alguns detalhes sobre eles

No exemplo abaixo, temos a seguinte sintaxe no Where da consulta 

data>=<!di!> and 
data<=<!df!> and 
tipo=<!tipo!> and 
credor_devedor=<!cliente!>  

Selecione a variável e clique no botão 'Editar'

O operador deverá informar:

• O tipo da coluna - Informe o tipo de dado compatível para a coluna.
  • Character
  • Data
  • Inteiro
• SQL para montagem de combobox - Defina select para a montagem de uma combo box de pesquisa. 
  • Este select deve conter no mínimo 2 campos, onde o primeiro será usado com índice de comparação, enquanto que o segundo é a descrição identificativa.
    
  • Ou seja, o select definirá as opção que irão aparecer na combo.

Marque a opção "Tem certeza que deseja gravar este registro?" e clique no botão 'Finalizar'.

Repita este processo para todas as linhas da grade e clique no botão 'Avançar'.

Neste momento o sistema irá verificar os campos definidos no select informado e na próxima etapa eles serão listados para a definição de seus detalhes.

No exemplo abaixo, temos a seguinte campos na consulta:

Select
  mk_movimentacao_caixa.codmovcaixa As codigo,
  mk_movimentacao_caixa.valor,
  mk_movimentacao_caixa.tipo,
  mk_movimentacao_caixa.descricao,
  mk_movimentacao_caixa.data,
  mk_pessoas.nome_razaosocial As cliente,
  mk_movimentacao_caixa.credor_devedor,
  mk_movimentacao_caixa.dt_hr As dh
... 

O operador deverá editar cada campo, selecionando-o no painel e clicando no botão 'Editar'.

 O operador deverá informar: 

• Tipo da coluna - Informe o tipo de dado compatível para a coluna.
  • Inteiro
  • Caracter
  • Texto longo
  • Numérico
  • Fracionado
  • Data
  • Data/Hora
    
• Ignorar - Definir se o sistema deverá ignorar exportação desta coluna
  • Sim
  • Não

Marque o check "Tem certeza que deseja gravar este registro?" para dar ciência ao procedimento e clique no botão 'Finalizar'.

Repita este processo para todas as linhas da grade.

Ainda nesta etapa, o operador deverá definir o campo índice de chave para controle, selecionando o campo na grade e clicando na ferramenta indicada abaixo:

Marque o check 'Tem certeza que deseja gravar o registro.' para dar ciência ao procedimento e clique no botão 'Finalizar'.

Pronto! o Schema de dados está definido. 

Para editar o Schema, basta selecioná-lo no painel e clicar no botão 'Editar'.

Altere as informações como desejar, da mesma forma como explicado no cadastro , marque a opção 'Tem certeza que deseja gravar o registro?' para confirmar o procedimento e clique no botão 'Finalizar'.

Perfis de Exportações

No terceiro painel será onde iremos realizar a relação entre o Banco de Dados e o Schema que será utilizado para a realização da exportação dos dados.

Para criar um novo perfil clique no botão 'inserir Registro'.

O operador deverá informar: 

• Código - Código auto-numerável atribuído pelo banco de dados (Bloqueado para edição)
• Data/Hora - Data e hora de cadastro (Bloqueado para edição)
• Operador de cadastro - Operador de cadastro (Bloqueado para edição)
• Descrição - Descrição identificativa do registro
• Schema de dados - Schema de dados associado ao perfil.
• Tipo de destino - Tipo de destino dos registros.
• Fonte de Dados destino - Fonte de dados de destino do perfil
  • Oracle
  • Postgres
• Tabela de destino - Nome da tabela de destino dos registros.

Marque o check "Tem certeza que deseja gravar este registro?" para dar ciência ao procedimento e clique no botão 'Finalizar'.

Pronto! O Perfil de Exportação foi criado.  

Executar Exportação

Após o perfil ser criado, podemos então executar a Exportação dos dados, selecionando o perfil no painel e clicando no botão 'Executar Exportação', conforme imagem abaixo.

No primeiro passo teremos alguns dados informativos. Clique no botão 'Avançar'.

Caso na sintaxe do Where tenha a definição de algumas variáveis como explicado anteriormente, nesta etapa o operador irá definir os dados que cada variável deverá considerar para a realização do filtro na execução da consulta.

No exemplo abaixo, temos a seguinte sintaxe no Where da consulta:

data>=<!di!> and 
data<=<!df!> and 
tipo=<!tipo!> and 
credor_devedor=<!cliente!>  

Selecione a variável na grade e clique no botão Editar:

Repita este processo para todas as linhas da grade. 

 Marque o check 'Tem certeza que deseja exportar este perfil?' para dar ciência ao procedimento e clique no botão 'Finalizar'.

Pronto! Exportação realizada!

Exportações Realizadas

No quarto e último painel será onde o operador fará a verificação dos resultados da execução da exportação.

Clique duas vezes sobre uma exportação no painel para verificar seus detalhes.

Na primeira aba teremos informações gerais da execução e o SQL utilizado.

Na segunda aba teremos os dados que foram exportados.

Ao selecionar o dado e clicar na lupa teremos detalhes do SQL de insert e caso tenha ocorrido algum erro na execução teremos também a mensagem de erro.

E na terceira aba, as informações dos filtros que foram utilizados.