Criar e Atualizar Banco de Dados do Plus e Lite no Sistema VB6 (Maqplan)

Resumo do que será ensinado

Neste documento você aprenderá, passo a passo, como criar do zero o banco de dados do Plus/Lite no Maqplan e como atualizar um banco já existente usando o utilitário em VB6. Ao final, qualquer usuário conseguirá definir corretamente nome e caminho do banco, executar a criação e rodar a atualização de estrutura.

Segue um Vídeo explicativo do processo

Detalhamento do uso correto

Com este guia, você deve ser capaz de criar um novo banco de dados quando o cliente ainda não possui base e também atualizar a estrutura de um banco já existente, garantindo que as tabelas sejam verificadas e ajustadas pelo sistema. Siga cada passo com atenção para evitar erros de nome ou caminho do banco.

Segue o detalhamento de como criar e atualizar o banco de dados do Plus/Lite (VB6/Maqplan)

1. Primeiro passo: Verificar se já existe banco de dados na instalação.

   • No computador do cliente, acesse a pasta de instalação do sistema Maqplan.
     
     • Caminho padrão: C:\Maqplan.
   • Dentro dela, localize e abra a pasta “banco dados”.
   • Observe o conteúdo desta pasta.
     
     • Se a pasta estiver vazia (sem nenhum arquivo de banco), significa que o cliente ainda não tem banco de dados criado.
     • Se existirem arquivos de banco, significa que já existe uma base e você poderá usar a opção de atualizar banco.
   • Pontos de atenção.
     
     • Certifique‑se de estar olhando exatamente a pasta usada pelo sistema (C:\Maqplan\banco dados).
     • Em instalações em outro drive (por exemplo, D:\Maqplan), ajuste o caminho conforme a realidade.

2. Segundo passo: Abrir o utilitário de criação/atualização de banco.

   • Na pasta do Maqplan, localize o executável responsável por criar/atualizar banco de dados do Plus/Lite (utilitário VB6).
   • Dê um duplo clique para abrir o programa.
   • Este utilitário é usado tanto para:
     
     • Criar banco do zero para novos clientes.
     • Atualizar banco já existente, ajustando as tabelas à versão atual.
   • Pontos de atenção.
     
     • Não deixe o ERP ou o PDV Plus/Lite aberto enquanto executa este utilitário, para evitar conflitos de acesso ao banco.

3. Terceiro passo: Baixar recursos adicionais (se o utilitário solicitar).

   • Ao abrir o utilitário, pode aparecer uma mensagem indicando que existem recursos pendentes para baixar.
   • Sempre que esta tela aparecer:
     
     • Clique na opção de baixar recursos.
     • Aguarde o download e instalação dos componentes necessários.
   • Após o download concluir, o utilitário estará apto a executar a criação ou atualização do banco.
   • Pontos de atenção.
     
     • Não feche o utilitário durante o download dos recursos.
     • Certifique‑se de que o computador está conectado à internet, se o download ocorrer a partir de um servidor remoto.

4. Quarto passo: Iniciar o processo de criação de um banco novo.

   • Com o utilitário aberto e sem pendências, escolha a opção de instalar/criar banco de dados.
   • Clique em Avançar para começar a configuração da criação.

5. Quinto passo: Informar o nome do banco de dados.

   • Na tela de configuração, haverá um campo para nome do banco.
   • Preencha este campo com o nome padrão utilizado pelo sistema:
     
     • PoliSystemServerSQDB.
   • Digite exatamente essa expressão (respeitando letras e ordem).
   • Após preencher, clique em Avançar.
   • Pontos de atenção.
     
     • Utilize sempre este nome padrão; é o que o sistema espera para se conectar corretamente.
     • Não crie nomes diferentes por conta própria, para evitar problemas de conexão futura.

6. Sexto passo: Definir o endereço (caminho) do banco de dados.

   • Na próxima etapa, o utilitário solicitará o endereço (caminho) onde o banco será armazenado.
   • O caminho padrão é:
     
     • C:\Maqplan\banco dados.
   • Você pode informar este caminho de duas maneiras:
   1. Digitando o caminho completo no campo.
   2. Usando o botão dos três pontinhos (selecionar pasta):
      
      • Clique nos três pontinhos.
      • Selecione Meu Computador.
      • Entre no drive C:.
      • Abra a pasta Maqplan.
      • Selecione a subpasta “banco dados”.
      • Confirme a seleção.
   • Após confirmar o caminho correto, clique em Avançar para continuar.
   • Pontos de atenção.
     
     • Se o sistema estiver instalado em outro local (por exemplo, D:\Maqplan\banco dados), selecione esse caminho específico.
     • Verifique visualmente se o caminho indicado é realmente o da pasta “banco dados” usada pelo sistema.

7. Sétimo passo: Executar a criação do banco de dados.

   • Com o nome do banco (PoliSystemServerSQDB) e o caminho configurados, confirme a operação (Avançar/Concluir).
   • O utilitário iniciará o processo de criação do novo banco:
     
     • Criará o arquivo de banco dentro da pasta “banco dados”.
     • Montará toda a estrutura inicial de tabelas necessária para o funcionamento.
   • Durante o processo, é possível observar que o arquivo de banco passa a aparecer na pasta e a barra de progresso indica a criação.
   • Quando concluir, o utilitário informará que o banco foi criado com sucesso.
   • Pontos de atenção.
     
     • Aguarde até a finalização completa; não feche o programa antes da confirmação.
     • Depois, abra novamente a pasta “banco dados” e confira se o arquivo de banco está presente, confirmando a criação.

8. Oitavo passo: Entender o processo de atualização do banco.

   • O mesmo utilitário também é responsável por atualizar um banco já existente:
     
     • Serve quando há uma nova versão do sistema ou modificações de estrutura de tabela.
   • A atualização faz o seguinte:
     
     • Verifica todas as tabelas do banco atual.
     • Confere se há diferenças em relação ao modelo atualizado.
     • Cria/ajusta tabelas e campos necessários para compatibilizar o banco com a nova versão.
   • Esse processo não é para apagar dados, e sim para ajustar a estrutura.

9. Nono passo: Iniciar a atualização do banco existente.

   • Para atualizar, execute novamente o utilitário de banco de dados.
   • Selecione o fluxo correspondente à atualização (seguindo as telas do programa).
   • Na primeira etapa, o utilitário solicitará um valor inicial:
     
     • Informe um ponto “.” em um campo específico (conforme instrução na tela).
     • Este ponto é usado para prosseguir com a rotina de atualização.
   • Após inserir o ponto, clique em Avançar.

10. Décimo passo: Informar o nome do banco que será atualizado.

    • Em seguida, o utilitário pedirá novamente o nome do banco que será atualizado.
    • Informe exatamente:
      
      • PoliSystemServerSQDB.
    • Clique em Avançar e prossiga com as próximas telas (Avançar/Concluir) para iniciar a atualização.
    • Pontos de atenção.
      
      • Certifique‑se de que este é o nome do banco realmente utilizado pelo sistema naquela instalação.
      • Não altere o nome; atualizar banco errado pode gerar erros ou não encontrar o arquivo.

11. Décimo primeiro passo: Acompanhar a verificação e ajustes nas tabelas.

    • Ao iniciar, o utilitário começará a:
      
      • Verificar tabelas existentes.
      • Conferir estrutura (campos, índices, relationships).
      • Realizar as alterações necessárias (criação de novas tabelas, atualização de colunas).
    • Na tela, você verá mensagens de progresso como:
      
      • Verificação das tabelas.
      • Conferência das tabelas.
      • Realização de ajustes nas tabelas.
    • Quando a atualização terminar, será exibida uma indicação clara de que o banco foi atualizado.
    • Pontos de atenção.
      
      • Não interrompa o processo, mesmo que demore alguns minutos.
      • Aguarde até a mensagem final de conclusão antes de fechar o utilitário.

12. Décimo segundo passo: Confirmar o funcionamento após criação ou atualização.

    • Depois que o banco foi criado ou atualizado, abra o sistema Plus/Lite/Maqplan normalmente.
    • Verifique:
      
      • Se o sistema abre sem erros de conexão ao banco.
      • Se, no caso de atualização, os dados do cliente continuam presentes e as telas carregam corretamente.
      • Se, no caso de criação, o sistema abre com uma base vazia, pronta para receber cadastros.
    • Pontos de atenção.
      
      • Caso apareça algum erro de conexão, revise:
      • Caminho do banco configurado no sistema.
      • Nome do banco.
      • Permissões de leitura/escrita na pasta “banco dados”.

Informações Importantes

• Resumo das principais orientações.

  • A pasta padrão para armazenar o banco é C:\Maqplan\banco dados.
  • Use o utilitário VB6 específico para criar e atualizar o banco de dados do Plus/Lite.
  • Ao criar, informe o nome PoliSystemServerSQDB e o caminho correto da pasta de banco e avance até concluir.
  • Ao atualizar, execute o utilitário, informe um ponto “.”, depois o nome PoliSystemServerSQDB, avance e aguarde a verificação e ajuste das tabelas.

• Dicas de uso.

  • Antes de qualquer atualização em ambiente com dados, faça um backup da pasta “banco dados”, copiando os arquivos para outro local seguro.
  • Anote e documente o caminho e nome do banco utilizados na instalação para facilitar manutenções futuras.
  • Sempre aceite o download de recursos solicitado pelo utilitário para evitar problemas de componentes desatualizados.

• Recomendações gerais sobre o processo.

  • Em caso de falhas (mensagens de erro, travamento durante criação/atualização):
  • Anote o texto da mensagem de erro.
  • Registre em qual etapa do processo ocorreu (criação, atualização, verificação de tabelas).
  • Encaminhe essas informações ao suporte técnico, informando que se trata de criação/atualização de banco do Plus/Lite no VB6.
  • Não execute o utilitário com o ERP ou PDV abertos; feche os sistemas antes de criar ou atualizar o banco.

• Benefícios de seguir corretamente o procedimento.

  • Garantir que novos clientes tenham o banco criado de forma correta, evitando problemas de conexão.
  • Manter bancos existentes compatíveis com a versão mais recente, permitindo uso de novas funções sem erros de estrutura.
  • Reduzir riscos de falhas e perda de tempo, ao padronizar o processo de criação e atualização do banco de dados.