Migração de Dados

A página de Migração importa clientes, produtos, preços e histórico de outro sistema de gestão de lan house para o HandyCafe. Ela está localizada em Configurações no grupo de Infraestrutura e Sistema.

Três fontes são suportadas:

Escolha uma fonte nos cartões no topo da página. O painel abaixo muda para corresponder à seleção.

Como Cada Fonte Se Comporta

As três fontes compartilham o mesmo modelo de funcionamento. O que você aprende em uma se aplica às outras.

• A fonte é somente leitura. O HandyCafe abre o arquivo original para leitura e nunca escreve nele. Sua instalação antiga permanece exatamente como estava. Você pode voltar a ela a qualquer momento.
• Inspecione antes de importar. O botão Inspecionar lê o arquivo de origem e relata o que encontrou. O botão Iniciar migração permanece desativado até que uma inspeção seja bem-sucedida.
• O progresso é mostrado por fase. Um diálogo de progresso é aberto durante a execução e relata a fase em andamento, como membros, produtos ou transações.
• Reexecutar é seguro. Linhas já importadas são atualizadas no lugar, não duplicadas. Uma vez que a migração é concluída, o botão muda para Reexecutar migração.
• Toda execução pode ser desfeita. Após uma execução concluída, um botão Desfazer migração aparece. Ele remove todas as linhas importadas daquela fonte. Você é solicitado a confirmar primeiro.
• Avisos não interrompem a execução. Se algumas linhas não puderam ser lidas, a execução termina como concluída com avisos. Abra Logs para ver quais linhas foram ignoradas.
• Uma execução interrompida se recupera sozinha. Se o aplicativo fechar ou a máquina perder energia durante a importação, a página relata que a importação anterior foi interrompida. Iniciar novamente é seguro.

Expanda Contagens da última importação na parte inferior de um painel para ver quantas linhas a execução mais recente importou para cada categoria.

HandyCafe Legacy

Importa de uma instalação do HandyCafe 3.x ou 4.x. Esta é a fonte para lan houses que estão atualizando de uma geração anterior do HandyCafe.

Detecção

No Windows, a página escaneia o sistema em busca de uma instalação legada e relata:

Se nada for detectado, a página relata que nenhuma instalação legada foi encontrada. Verifique se os arquivos legados estão em um local padrão, como Program Files\HandyCafe ou C:\HandyCafe.

No macOS e Linux, a varredura automática não pode ser executada. O painel oferece um seletor de pastas. Aponte para a pasta Db legada copiada da antiga máquina Windows e inicie a migração.

O Que É Importado

Membros, níveis de preços, produtos, pedidos, transações, logs e as configurações mantidas nos arquivos INI legados.

Pare o servidor legado antes de começar. O banco de dados de origem não deve ser escrito enquanto está sendo lido.

Para um guia completo, veja Como Migrar de uma Instalação Legada.

EveryCafe

Importa de um arquivo de banco de dados EveryCafe, normalmente chamado ecmdata.ecm.

1. Selecione Procurar e escolha o arquivo .ecm. Arquivos com extensão .db ou .sqlite também são aceitos.
2. O HandyCafe inspeciona o arquivo automaticamente uma vez escolhido. Use Inspecionar para executar a verificação novamente após editar o caminho manualmente.
3. Revise a pré-visualização, depois selecione Iniciar migração.

A pré-visualização relata o Nome do Servidor e a Versão do Servidor do EveryCafe, juntamente com o número de caixas, membros, produtos, listas de preços, pedidos e sessões contidos no arquivo.

O Que É Importado

Caixas, membros, produtos, níveis de preços, pedidos, transações e contas Steam. As senhas das contas Steam são criptografadas ao serem escritas no pool de licenças de jogos do HandyCafe.

Sessões e listas de preços são contadas na pré-visualização para que você possa ver o tamanho dos dados de origem. Elas não são importadas.

Referência de PriceList

Após uma execução concluída, o painel oferece uma tabela de Referência de PriceList listando as linhas de preços originais do EveryCafe: ID do PriceList, tipo legado, preço inicial, preço por hora e minutos de atualização.

Os preços do EveryCafe não mapeiam diretamente para os planos de preços do HandyCafe. Essas linhas são mantidas como referência para configurar preços manualmente. Elas não são importadas como produtos de cafeteria. Use-as juntamente com Preços para reconstruir suas tarifas.

Pancafe

Importa de um arquivo de banco de dados Pancafe, normalmente chamado USDB.DAT. O HandyCafe lê o arquivo Firebird diretamente. Nenhum servidor ou biblioteca cliente Firebird precisa ser instalado.

1. Selecione Procurar e escolha o arquivo USDB.DAT. Arquivos com extensão .fdb ou .gdb também são aceitos.
2. Revise a pré-visualização, depois selecione Iniciar migração.

A pré-visualização relata o Formato detectado (por exemplo, a versão ODS do Firebird) além do Intervalo de Histórico coberto pelos dados. Também lista o número de caixas, membros, produtos, entradas do livro-caixa, sessões e linhas de histórico de carteira de membros encontradas.

O Que É Importado

Caixas, membros com saldo de carteira, produtos, entradas de receita do livro-caixa e entradas de despesas.

As linhas de sessão são lidas para a pré-visualização, mas deixadas de fora da importação de propósito. O livro-caixa já registra o que foi coletado para essas sessões. Importar ambos contaria a mesma receita duas vezes.

Fuso Horário

O Pancafe armazena datas sem um fuso horário. O HandyCafe as converte usando o fuso horário do computador que está executando a importação. Execute a migração na máquina que continuará usando os dados. Executá-la em outro lugar pode deslocar datas históricas por algumas horas.

Antes de Começar

• Faça um backup primeiro. Abra Manutenção de Banco de Dados e use Fazer backup agora. Uma migração escreve no banco de dados ativo. Um snapshot recente oferece uma segunda forma de voltar além de Desfazer migração.
• Feche o aplicativo de origem. Um banco de dados que está sendo escrito ativamente pode produzir leituras incompletas.
• Reserve tempo suficiente. Conjuntos de dados grandes podem levar vários minutos. Deixe o HandyCafe aberto até que o diálogo de progresso informe que a execução foi concluída.
• Verifique as contagens quando a execução terminar. Compare-as com o que você espera do sistema antigo antes de começar a operar no novo.

Páginas Relacionadas

• Configurações de Clientes Legados para permitir que PCs clientes V3 e V4 continuem se conectando a este servidor.
• Manutenção de Banco de Dados para backups e pontos de restauração.
• Membros, Produtos e Preços de Sessão para revisar registros importados.