Conteúdo
Onde 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 LinuxMigraçã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
- A empresa de destino precisa estar criada. Crie a empresa com o assistente de configuração inicial e entre como administrador.
- Faça um backup da empresa de destino. A importação grava um grande número de registros na empresa; tenha um backup para o qual possa voltar se algo der errado.
- O FirebirdSQL 3.0, 4.0 ou 5.0 precisa estar instalado e em execução neste computador. A etapa 1 verifica isso.
- O arquivo de backup (.FBK) ou de banco de dados (.FDB) do programa anterior precisa estar acessível a partir deste computador. Se houver um banco de imagens e documentos (EK1), ele deve estar na mesma pasta.
- Tenha a senha do SYSDBA à mão (o padrão é
masterkey, se não foi alterada na instalação do Firebird). Se for escolher um backup (.FBK), deixe livre em disco cerca de 4 vezes o tamanho dele.
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ção | O 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ão | Significado |
|---|---|
| objeto | Cadastros/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ópia | Se houver no destino uma tabela com o mesmo nome, as colunas em comum são copiadas linha a linha. |
| derivado | Não é copiada: valores como o saldo da conta corrente e o estoque disponível são gerados de novo pelo caminho de gravação. |
| ignorar | Tabela de sistema ou de log. |
Na mesma etapa são definidas as opções de importação:
- Execução em seco (nada é gravado): testa a importação sem gravar no destino; você vê antes as quantidades e os possíveis erros. Recomenda-se fazer uma execução em seco antes da importação real.
- Importar também o arquivo de documentos excluídos e Importar também as movimentações históricas: levam também o backup de documentos excluídos e as tabelas de movimentações históricas do programa anterior.
- Importar imagens e documentos (EK1): se o EK1 foi encontrado, leva também os arquivos de imagens e documentos.
- Continuar mesmo que o destino já tenha dados: se a empresa de destino já tiver registros, a importação para por padrão (
HEDEF_DOLU); marque somente se souber o que está fazendo e já tiver feito o backup. - Tamanho do lote: número de registros que a importação processa de cada vez (1–5000, padrão 200).
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:
- Reparar saldos em aberto: se o valor restante (saldo em aberto) estiver vazio nas faturas vindas do programa anterior, ele é recalculado a partir das movimentações das contas correntes. Primeiro é mostrada uma “Pré-visualização” e nada é gravado (número de faturas que vão mudar, totais anterior e posterior, contas ignoradas); se estiver adequado, clique em “Aplicar reparo”.
- Recarregar o dicionário: adiciona as linhas que faltam nas traduções da interface; traduções editadas manualmente não mudam. Pode levar alguns minutos; não feche esta janela.
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ódigo | Significado 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_CALISMIYOR | O 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
- Configurações e Log — Deixar o programa do seu jeitoA janela Configurações mantém dois tipos de ajuste lado a lado: os que são só seus (tema, disposição das janelas, atalhos) e os que afetam o funcionamento da.
- Data Cleanup — A Guide from ScratchOver the years the same customer gets opened two or three times ("ABC Ltd. Şti." and "ABC LİMİTED ŞİRKETİ"), the same screw is entered under two different.
- Uso sozinho: comece em 10 minutosPara uma pequena loja, oficina ou autônomo que usa o programa sozinho: os passos da instalação à primeira fatura e ao fim do mês.
- Manual Prático do UsuárioEsta página foi feita para o funcionário que usa o programa pela primeira vez e precisa dar conta do trabalho diário com segurança.
- Primeiro Dia — Para quem senta na frente do programa pela primeira vezEsta é a primeira página que todo mundo deve ler e ela leva dez minutos. Aqui não ensinamos contabilidade, apenas como conduzir a tela: como as janelas abrem.
- A Cadeia de Documentos — A Espinha Dorsal do ProgramaEste guia não fala de uma janela, e sim do vínculo entre as janelas. A verdadeira lacuna na cabeça de quem chega não é "o que este botão faz.