Ir para o conteúdo
HNROS Central de ajuda
Português
Comece grátis
ConteúdoOnde fica e quem usaAntes de começarEtapa 1 — Verificação do FirebirdSQLEtapa 2 — Arquivo de origemPreparar o backup como UTF-8 e conectar / Testar a conexãoEtapa 3 — Inventário de tabelas e opçõesEtapa 4 — Importação e progressoEtapa 5 — Resultado e conciliaçãoPainel de manutençãoErros comunsNo Linux

Migração de dados do programa anterior (Firebird): Configurações › Migração de dados

Os dados do seu programa anterior (FirebirdSQL) — cadastros de contas correntes e de estoque, faturas, notas de remessa, cheques, receitas, imagens e documentos — são transferidos para o HNR depois que você entra, na seção Configurações › Migração de dados (do programa anterior). O assistente de configuração inicial não transfere mais dados. Somente o administrador do sistema vê a seção; no celular (interface Jardim + Etapas), o mesmo fluxo abre etapa por etapa.

Primeiro crie a empresa com o assistente: os dados são importados para uma empresa já criada; esta seção não cria empresas novas. Faça um backup da empresa de destino antes da importação. O banco de dados do programa anterior é somente leitura: nem uma única linha é alterada durante a importação.

Onde fica e quem usa

Configurações › Migração de dados (do programa anterior). Somente o administrador do sistema vê e usa a seção; para um usuário sem a permissão Administrador aparece “A importação de dados está disponível somente para administradores do sistema.” Se o servidor estiver em modo somente leitura (gravação bloqueada), a importação não começa.

O botão “Importar banco de dados (transferir dados de uma empresa antiga)” do assistente de configuração inicial não transfere mais dados; ele só mostra uma nota informativa: crie a empresa primeiro e, depois de entrar, abra a seção Configurações › Migração de dados.

No celular (interface Jardim + Etapas), a mesma seção abre etapa por etapa: cada etapa é uma tela separada, os botões têm tamanho confortável para tocar com o dedo e as tabelas aparecem como cartões.

Antes de começar

Etapa 1 — Verificação do FirebirdSQL

Ao abrir a página, verifica-se se o FirebirdSQL está instalado neste computador, se está em execução e qual é a versão. Os dados do programa anterior são lidos com o FirebirdSQL deste computador: o servidor é este computador (localhost), a porta é 3050 (ou, se foi alterada na instalação, o valor definido em firebird.conf como RemoteServicePort) e o usuário é SYSDBA. Nada disso é perguntado; só a senha é solicitada.

SituaçãoO que fazer
Não instalado. A tela mostra “Instale o FirebirdSQL primeiro.” e não é possível continuar.Instale o FirebirdSQL 3.0, 4.0 ou 5.0 pelo link “Página de download do FirebirdSQL” (firebirdsql.org), com as configurações padrão (porta 3050, SYSDBA); depois clique em “Verificar novamente”.
Instalado, mas o serviço não está em execução. O aviso também mostra a versão e a porta.Abra os Serviços do Windows e inicie o serviço “Firebird Server - DefaultInstance”; depois clique em “Verificar novamente”.
Versão não suportada. Aparece o aviso “Esta versão do FirebirdSQL não é suportada”.Instale o FirebirdSQL 3.0, 4.0 ou 5.0.
Pronto. Um quadro verde mostra “O FirebirdSQL está instalado e em execução”, a versão, localhost:porta e SYSDBA.Passe para a etapa 2 com “Continuar”.

Nesta etapa também aparece o aviso “Faça um backup da empresa de destino antes da importação.” Se já houve uma importação antes, o botão “Mostrar o resultado da última importação” abre esse resultado.

Etapa 2 — Arquivo de origem

O botão Escolher arquivos abre a janela de abertura de arquivos do Windows. Selecione o backup (.FBK) ou o banco de dados (.FDB) do programa anterior; as extensões .BAK e .GDB também são aceitas. Um arquivo de qualquer outro tipo é recusado (KAYNAK_DOSYA_TURU).

Para o EK1 (o banco de imagens e documentos; por exemplo HESAP_EK1.FBK ou HESAP.FDB_EK1.FBK) não há uma segunda seleção: ele é encontrado automaticamente na mesma pasta, e abaixo da seleção aparece “EK1 encontrado”. Se não for encontrado, aparece o aviso “EK1 não encontrado, somente o arquivo principal será importado” e as imagens e documentos não são importados; coloque o EK1 na mesma pasta do arquivo principal e selecione o arquivo novamente.

Quando o HNR funciona como serviço do Windows, o arquivo é escolhido pela própria janela de seleção de arquivos do navegador. Nesse caso, selecione o arquivo EK1 junto com o arquivo principal (com a tecla Ctrl) na mesma janela. Os arquivos selecionados são copiados, com um indicador de porcentagem, para a pasta de importação deste computador (aktarim\kaynak); o arquivo original não é alterado.

Atalho para arquivos grandes: em backups de vários GB, copie primeiro o arquivo principal e o arquivo EK1 para a pasta de importação deste computador (aktarim\kaynak; o caminho completo aparece sob o botão antes de escolher um arquivo) e depois selecione apenas o arquivo principal em Escolher arquivos. Um arquivo com o mesmo nome e tamanho que já está na pasta não é copiado novamente; a tela mostra “O arquivo já estava na pasta de importação; não foi copiado novamente.” e o EK1 é encontrado automaticamente na mesma pasta. Arquivos grandes enviados pelo navegador são transmitidos em partes.

Depois de escolher o arquivo, só a senha do SYSDBA é informada. SYSDBA / masterkey são os valores iniciais do Firebird; se a senha foi alterada na instalação do Firebird, digite a sua própria senha.

Preparar o backup como UTF-8 e conectar / Testar a conexão

Se você escolheu um backup (.FBK), o botão passa a ser Preparar o backup como UTF-8 e conectar. O backup é restaurado no servidor (“Restaurando o backup…”), convertido para UTF-8 e tem o conteúdo verificado (“Conversão para UTF-8 e verificação do conteúdo…”); o progresso aparece com o número de tabelas e linhas. A cópia aprovada na verificação é usada como origem, e o backup original é preservado. Esse trabalho precisa de espaço livre em disco de cerca de 4 vezes o tamanho do backup.

Se você escolheu um banco de dados (.FDB), o botão passa a ser Testar a conexão: ele se conecta à origem e mostra a versão, o número de tabelas e se o EK1 foi encontrado. Em caso de sucesso, aparece “Conectado · versão … · … tabelas” e o botão Ler o inventário fica ativo.

Etapa 3 — Inventário de tabelas e opções

Ler o inventário lista todas as tabelas da origem; nenhuma é descartada em silêncio. Cada tabela recebe uma de quatro decisões:

DecisãoSignificado
objetoCadastros/documentos são gerados a partir da tabela e gravados pelo próprio caminho de gravação da empresa (ex.: MUSTERI → cadastro de conta corrente).
cópiaSe houver no destino uma tabela com o mesmo nome, as colunas em comum são copiadas linha a linha.
derivadoNão é copiada: valores como o saldo da conta corrente e o estoque disponível são gerados de novo pelo caminho de gravação.
ignorarTabela de sistema ou de log.

Na mesma etapa são definidas as opções de importação:

Os números dos documentos são preservados: os números de faturas, cheques e lançamentos da origem ficam iguais no destino. Se a mesma origem for importada uma segunda vez, não são gravados registros duplicados; os existentes são ignorados.

Etapa 4 — Importação e progresso

Iniciar a importação inicia a importação no servidor. A tela mostra a etapa, a porcentagem e o tempo decorrido, tabela a tabela as contagens de cadastros/documentos/gravados/ignorados/com erro, o número de arquivos e as últimas linhas do log da importação; se o motor usar várias threads, também mostra quantas são e o detalhamento.

A importação é executada no servidor: mesmo que você feche esta janela ou o navegador, o trabalho não para. Ao abrir a página de novo, a importação em andamento é encontrada e o progresso é exibido. Parar interrompe o trabalho e mostra “A importação foi interrompida.”

Etapa 5 — Resultado e conciliação

Ao final da importação aparece “A importação foi concluída.” e a tabela de conciliação compara a origem com o destino: saldos de contas correntes, estoques disponíveis, cheques, faturas, receitas e arquivos. Cada linha mostra o item, a origem, o destino, a diferença e a situação (Confere / Desvio / Desvio conhecido); também aparecem o resultado tabela a tabela, a duração, exemplos de erros de linha e o número de correções automáticas.

Se houver desvio na conciliação, a tela informa “A importação terminou — MAS há desvio na conciliação.” e lista os indicadores com desvio. Revise a tabela de conciliação antes de usar a empresa importada; com o botão Relatório de conciliação com o sistema anterior · PDF você obtém o relatório em PDF, ou pode imprimi-lo com Imprimir.

Exemplos de linhas com erro são listados em “Exemplos de erros de linha”; se a importação não puder ser concluída, consulte o log da importação para ver os detalhes.

Painel de manutenção

O painel Manutenção, abaixo da etapa 2, oferece duas operações:

Erros comuns

A mensagem de erro mostra o detalhe do servidor e, entre parênteses, um código de erro; por exemplo “As ferramentas de preparação de backup não estão configuradas no servidor. — gbak/gfix not found (KAYNAK_HAZIRLIK_AYAR)”. Informe o código ao entrar em contato com o suporte.

CódigoSignificado e solução
FIREBIRD_KURULU_DEGIL“O FirebirdSQL não está instalado neste computador.” Instale o FirebirdSQL 3.0, 4.0 ou 5.0 e clique em “Verificar novamente”.
FIREBIRD_CALISMIYORO FirebirdSQL está instalado, mas o servidor dele não está em execução. Inicie o serviço “Firebird Server - DefaultInstance” nos Serviços do Windows e verifique novamente.
KAYNAK_KIMLIK“O nome de usuário ou a senha do banco de dados de origem foi recusado.” Digite a senha do SYSDBA novamente; se ela foi alterada na instalação do Firebird, informe essa senha (o padrão é masterkey).
KAYNAK_HAZIRLIK_AYAR“As ferramentas de preparação de backup não estão configuradas no servidor.” Se o detalhe disser gbak/gfix not found, o FirebirdSQL não está instalado; se disser Firebird server not running, inicie o serviço do Firebird. Verifique a instalação e o serviço e tente novamente; se continuar, envie o código à equipe de suporte.
KAYNAK_HAZIRLIK_DISK“Não há espaço em disco suficiente para restaurar o backup e criar uma cópia UTF-8.” Libere, no disco onde fica a pasta de importação, cerca de 4 vezes o tamanho do backup e tente novamente.
KAYNAK_YEDEK_GECERSIZ“O arquivo não é um backup FBK/BAK válido do Firebird.” O arquivo pode estar danificado ou ser de outro tipo; faça o backup novamente no programa anterior e selecione-o, ou selecione o arquivo FDB.
KAYNAK_DOSYA_TURU“Só é possível selecionar um arquivo de banco de dados ou de backup do Firebird (.fbk, .fdb, .bak, .gdb).” Selecione um arquivo com uma extensão adequada; não selecione o arquivo EK1 como arquivo principal.
HEDEF_DOLU“A empresa de destino já tem registros.” Se a empresa já foi usada, é mais seguro criar uma empresa nova; se for continuar de propósito, faça um backup antes e marque na etapa 3 a caixa “Continuar mesmo que o destino já tenha dados”.

Na mesma empresa, só uma importação pode ser executada por vez (“Já há uma importação de dados em andamento nesta empresa.”). Se o servidor estiver em modo somente leitura (“A gravação está bloqueada”), a importação não começa.

No Linux

O FirebirdSQL é instalado pelo gerenciador de pacotes da sua distribuição ou a partir de firebirdsql.org. As ferramentas gbak e gfix precisam estar no PATH ou em /opt/firebird; as demais etapas são iguais às do Windows.

Guias relacionados: Instalação, Configurações, Limpeza de dados.

Guias relacionados