¶ Manual de Conversão para Migração de Dados
Este manual descreve as etapas para conversão e migração dos dados do sistema anterior para o Questor Negócio. Siga os passo abaixo para realizar o processo:
¶ 1 - Instalar o PostgreSQL e o PGAdmin
Ambos podem ser baixados e instalados em conjunto:
https://www.enterprisedb.com/postgresql-tutorial-resources-training?cid=48
¶ 1.1 Abrir o programa, digitar a senha definida, clicar em “PostgreSQL 12” e depois em “Configure PGAdmin”:
Em seguida, acesse Path > Binary paths e, no campo PostgreSQL Binary Path, informe o caminho da pasta bin da instalação do PostgreSQL.
Clique em Salvar.
¶ 2 - Baixar a aplicação de migração
Baixe a aplicação utilizada para realizar a migração no link: Conversor.
Após baixar o arquivo descompacte a pasta baixada.
¶ 3 - Restaurar o banco de dados inicial
Abra o pgAdmin, crie uma nova base de dados, utilizando o nome QuestorNegocio_NOME-EMPRESA (evite acentos e espaços; use apenas o primeiro nome da empresa, se preferir).
Restaure a base com os dados iniciais:
- Clique com o botão direito sobre a base criada e selecione Restore.
- Localize a pasta descompactada (passo 3) e acesse a subpasta BaseInicial.
- Selecione o arquivo BaseZerada.sql.
- Na aba Restore Options, marque as opções conforme o exemplo da imagem.
- Clique em Restore para iniciar o processo.
¶ 4 - Editar o arquivo appsettings.json
Na pasta descompactada (passo 3), localize o arquivo appsettings.json e abra com o Bloco de Notas.
¶ 4.1 Adicionar as informações do banco de origem (Firebird):
A base deve ser um arquivo .FDB que não esteja em uso (um backup é suficiente).
"BancoOrigemFirebird": "Server=localhost;Database=C:\\caminho\\para\\base.fdb;Dialect=3;Charset=ISO8859_1;user id=SYSDBA;password=masterkey;"
⚠️ Importante!
utilize
\\(duas barras) para separar os diretórios do caminho.
¶ 4.2 Adicionar as informações do banco de destino (PostgreSQL):
"Default": "User ID=usuario;Password=senha;Host=localhost;Port=5432;Pooling=true;Database=NomeBaseDestino;"
O nome da base deve ser o mesmo criado no passo 4.2.
5.3 Salvar as alterações feitas no arquivo, mantendo-o na pasta raiz.
¶ 6 - Executar o Conversor
Localize e execute o arquivo Conversor.exe na raiz da pasta descompactada (passo 3).
¶ 7 - Aguardar a abertura do prompt de comando
A tela exibirá uma URL, por exemplo: http://localhost:5000.
Abra o Google Chrome e digite o endereço informado.
Importante: não feche o prompt de comando até o término completo do processo de conversão.
¶ 8 - Execução da conversão via aplicação Web.
A aplicação exibirá 11 passos de conversão.
Aguarde até que cada passo mostre a mensagem Sucesso = True, indicando que foi concluído corretamente.
Após a mensagem, clique em Voltar no navegador e prossiga para o próximo passo, até finalizar o passo 11.
¶ 9 - Gerar backup da base convertida
Após a conclusão de todos os passos:
No pgAdmin, localize a base criada (passo 4.2), clique com o botão direito e selecione Backup.
Informe o nome desejado e clique em Create.
Envie o backup para o diretório do Zen.
⚠️ Importante!
A revenda deve comunicar o setor de serviços da Questor Matriz para liberação do link de download da base convertida.
¶ Em caso de erro durante o processo:
- Se a conversão falhar, por exemplo, no passo 8, siga os procedimentos abaixo:
- Feche o prompt de comando.
- No pgAdmin, localize a base criada, clique com o botão direito e selecione Delete/Drop.
- Refazer o passo 4 (restauração da base).
- Se o nome da base for o mesmo da tentativa anterior, não é necessário repetir o passo 5.
- Continue a partir do passo 6 até obter Sucesso = True em todos os 11 passos da conversão Web.
