/
Importação Automática

Importação Automática

A importação automática foi desenvolvida para facilitar o processo de importação, visando a otimização do tempo de acompanhamento e execução dos métodos a serem importados. Os dados extraídos são tratados e inseridos automaticamente no banco de dados do sistema ERP Construshow, eliminando a necessidade de processos manuais demorados. Este processo poderá ser acompanhado por meio de log que será exibido em tela, sendo possível visualizar o início e fim de cada uma das tabelas a serem executadas, bem como o tempo utilizado para execução.

 Instruções

1. Visão Geral

A ferramenta de importação de dados passou por melhorias de layout a fim de prepará-la para receber novas funcionalidades futuramente, por isso passa a se chamar Hub de Ferramentas – VX Contrushow.
Além de melhorias de layout, foi desenvolvido o processo de importação automática que permitirá ao consultor iniciar a execução do processo e dedicar-se a outras tarefas, pois a importação automática realizará a extração e importação de todos os métodos, sem a necessidade de intervenção manual ao finalizar a execução de uma tabela para iniciar outra.

2. Melhorias

2.1. Melhorias no Layout
O Layout da tela inicial da ferramenta de importação foi alterado visando prepará-la para recebimento de novas funcionalidades que serão desenvolvidas na sequência, como a tributação automática e layouts para configuração/homologação de boletos.
Foi desenvolvido um menu lateral que receberá botões de acesso a cada uma das funcionalidades que irão compor este hub de ferramentas para Implantação. A ferramenta sempre iniciará com a tela inicial selecionada.

image-20250206-163122.png

3. Guia de Uso

3.1. Acesso

A última versão da ferramenta sempre estará disponível no Dump Padrão e também no link a seguir. hub de Ferramentas - VX Construshow

3.2. Requisitos

Para utilizar a funcionalidade de importação automática, devem ser seguidos estes requisitos:

  • SQL:

  1. Conexão com banco de dados de origem estar devidamente configurada;

  2. SQLs estarem desenvolvidos, validados e salvos em suas respectivas tabelas;

  3. Processo já ter sido executado pelo menos uma vez de forma manual(1ª Importação. Este não é obrigatório mas garante que a execução será bem-sucedida quando executada automaticamente);

  • Planilha:
    O Processo via planilha está contemplado no processo de Importação Automática exceto a parte de extração. Por motivos de validação de planilhas, a extração dos dados deverá sempre ser realizada de forma manual, ate que identificamos uma forma de validar a planilha por completa. Mas é possível utilizar o processo de importação de forma automática após realizar a extração de forma manual.

  1. Para a Importação de dados a partir de planilhas, o único requisito é que os dados tenham sido previamente extraídos de forma manual.

3.3. Como utilizar
Para acessar a tela de importação de dados nesse novo layout, basta acessar o menu lateral na opção Importação de Dados, onde será aberta a tela com uma nova disposição dos botões e novos campos.

image-20250206-161943.png

Os botões no topo da tela, realizam os mesmos processos que eram desempenhados anteriormente, abrir as telas de Extração e Importação de dados Sql ou Planilhas. Essas vão continuar a serem acessadas para configuração dos campos e SQLs, execução da importação e extração de forma manual.

image-20250206-162002.png

A parte de Importação automática que se localiza abaixo dos botões, poderá ser utilizada após seguir os requisitos do item 3.2.

image-20250206-162012.png

No topo dessa área de Importação Automática será exibida uma mensagem com um breve resumo do funcionamento da tela, conforme descrito nos tópicos anteriores deste documento.

image-20250206-162050.png

Após essa mensagem temos o campo para seleção do Sistema concorrente, que inicialmente vai carregar a configuração da conexão com o banco de dados do sistema concorrente do qual serão extraídas as
informações. Este campo carregará o nome do concorrente que deverá ser configurado na tela de Extração de Dados – SQL > Configuração. Para o processo realizado via planilha de Excel, este campo ficará em branco, visto que não possuirá conexão com banco de origem.

image-20250206-162124.png

Após o campo de Concorrente, temos o campo Tipo Importação, que deverá ser selecionado o tipo da importação a ser realizada. Quando for via planilha, será desabilitado o método de Extração do próximo campo de seleção.

image-20250206-162144.png

Na sequência será possível selecionar os métodos a serem executados, onde pode ser selecionado apenas Extração ou Importação e Limpeza de Movimentos.

image-20250206-162157.png

Selecionadas essas opções, é só utilizar o botão Executar para iniciar o processo.

image-20250206-162606.png

Durante a execução, todo o processo será detalhado por meio do log exibido no lado direito da tela, através dele será possível identificar a tabela ou procedure que está sendo executada, e também o tempo que levou para execução de cada processo, dessa forma é possível, ao final de uma execução, determinar o tempo total para importação dos dados.

image-20250206-162227.png

Como podemos ver no exemplo de extração acima, o processo é todo detalhado, incluindo também as mensagens de aviso que a ferramenta exibe atualmente quando encontrados cadastros de pessoas(neste caso), com CPF/CNPJ diferentes e mesmo ID(Neste caso não está sendo utilizado o ID da pessoa, por isso todos estão com 0). Como o processo é de forma automatizada, ele apenas informará que será continuado, visto que no momento da importação esses cadastros serão agrupados de acordo com o CPF/CNPJ e inseridos no banco com um novo ID.

Quando utilizada a opção Importação, é possível selecionar Limpar Movimentos, a qual irá executa o processo de limpeza de movimentos do sistema, notas, contas, etc, mantendo cadastros de pessoas e produtos, como já funciona atualmente.

image-20250206-162239.png

Após iniciar a execução da Extração, caso ocorra algum erro, o sistema retornará o erro na tela do Log, já para a Importação, o erro será exibido em tela e o processo será imediatamente interrompido. Para este caso foi optado por exibir o erro em tela, não no log, para que seja de fácil visualização quando ocorrer, e assim, agir de forma mais rápida.

Caso ocorra tudo bem com o processo de extração, a importação é iniciada imediatamente conforme exemplo abaixo, sendo exibido um log de sucesso ao finalizar com o tempo de execução do processo.

image-20250206-162327.png

Related content