Migración de Datos
La página de Migración importa clientes, productos, precios e historial desde otro sistema de gestión de cibercafés a HandyCafe. Se encuentra bajo Configuración en el grupo de Infraestructura y Sistema.
Se admiten tres fuentes:
| Fuente | Qué lee |
|---|---|
| HandyCafe Legacy | Una instalación existente de HandyCafe 3.x o 4.x en esta máquina. |
| EveryCafe | Un archivo de base de datos SQLite de EveryCafe .ecm. |
| Pancafe | Un archivo de base de datos Firebird de Pancafe USDB.DAT. |
Elige una fuente de las tarjetas en la parte superior de la página. El panel de abajo cambia para coincidir con la selección.
Cómo se Comporta Cada Fuente
Las tres fuentes comparten el mismo modelo de trabajo. Lo que aprendas en una se aplica a las demás.
- La fuente es de solo lectura. HandyCafe abre el archivo original para lectura y nunca escribe en él. Tu instalación antigua permanece exactamente como estaba. Puedes volver a ella en cualquier momento.
- Inspecciona antes de importar. El botón Inspeccionar lee el archivo fuente e informa lo que encontró. El botón Iniciar migración permanece deshabilitado hasta que una inspección tenga éxito.
- El progreso se muestra por fase. Un diálogo de progreso se abre durante la ejecución e informa la fase en progreso, como miembros, productos o transacciones.
- Reejecutar es seguro. Las filas ya importadas se actualizan en su lugar, no se duplican. Una vez completada una migración, el botón cambia a Reejecutar migración.
- Cada ejecución puede deshacerse. Después de una ejecución completada aparece un botón Deshacer migración. Elimina cada fila importada de esa fuente. Se te pedirá confirmación primero.
- Las advertencias no detienen la ejecución. Si algunas filas no pudieron leerse, la ejecución termina como completada con advertencias. Abre Registros para ver qué filas se omitieron.
- Una ejecución interrumpida se recupera sola. Si la aplicación se cierra o la máquina pierde energía a mitad de la importación, la página informa que la importación anterior fue interrumpida. Comenzar de nuevo es seguro.
Expande Últimos conteos de importación en la parte inferior de un panel para ver cuántas filas importó la ejecución más reciente para cada categoría.
HandyCafe Legacy
Importa desde una instalación de HandyCafe 3.x o 4.x. Esta es la fuente para cafés que actualizan desde una generación anterior de HandyCafe.
Detección
En Windows la página escanea el sistema en busca de una instalación legacy e informa:
| Etiqueta | Significado |
|---|---|
| Ruta de Instalación | Dónde se encuentra la instalación legacy en el disco. |
| Ruta de la Base de Datos | Ruta completa al archivo de base de datos legacy. |
| Versión del Servidor | La cadena de versión del servidor antiguo, por ejemplo 3.4.01 o 4.0.10. |
| Conteo de Archivos INI | Cuántos archivos de configuración INI se encontraron en la carpeta de instalación. |
Si no se detecta nada, la página informa que no se encontró ninguna instalación legacy. Verifica que los archivos legacy estén en una ubicación estándar como Program Files\HandyCafe o C:\HandyCafe.
En macOS y Linux el escaneo automático no puede ejecutarse. El panel ofrece un selector de carpetas en su lugar. Apúntalo a la carpeta Db legacy copiada desde la antigua máquina Windows, luego inicia la migración.
Qué se Importa
Miembros, niveles de precios, productos, pedidos, transacciones, registros y la configuración contenida en los archivos INI legacy.
Detén el servidor legacy antes de comenzar. La base de datos fuente no debe escribirse mientras se está leyendo.
Para una guía completa, consulta Cómo Migrar desde una Instalación Legacy.
EveryCafe
Importa desde un archivo de base de datos EveryCafe, normalmente llamado ecmdata.ecm.
- Selecciona Examinar y elige el archivo
.ecm. También se aceptan archivos con extensión.dbo.sqlite. - HandyCafe inspecciona el archivo automáticamente una vez elegido. Usa Inspeccionar para ejecutar la verificación nuevamente después de editar la ruta manualmente.
- Revisa la vista previa, luego selecciona Iniciar migración.
La vista previa informa el Nombre del servidor y la Versión del servidor de EveryCafe junto con el número de cajeros, miembros, productos, listas de precios, pedidos y sesiones contenidas en el archivo.
Qué se Importa
Cajeros, miembros, productos, niveles de precios, pedidos, transacciones y cuentas de Steam. Las contraseñas de las cuentas de Steam se encriptan al ser escritas en el pool de licencias de juegos de HandyCafe.
Las sesiones y listas de precios se cuentan en la vista previa para que puedas ver el tamaño de los datos fuente. No se importan.
Referencia de PriceList
Después de una ejecución completada, el panel ofrece una tabla de Referencia de PriceList que lista las filas de precios originales de EveryCafe: ID de PriceList, tipo legacy, precio inicial, precio por hora y minutos de refresco.
La estructura de precios de EveryCafe no se mapea directamente a los planes de precios de HandyCafe. Estas filas se mantienen como referencia para configurar los precios manualmente. No se importan como productos de cafetería. Úsalas junto con Precios para reconstruir tus tarifas.
Pancafe
Importa desde un archivo de base de datos Pancafe, normalmente llamado USDB.DAT. HandyCafe lee el archivo Firebird directamente. No es necesario instalar un servidor o biblioteca cliente de Firebird.
- Selecciona Examinar y elige el archivo
USDB.DAT. También se aceptan archivos con extensión.fdbo.gdb. - Revisa la vista previa, luego selecciona Iniciar migración.
La vista previa informa el Formato detectado (por ejemplo, la versión ODS de Firebird) además del Rango de historial cubierto por los datos. También lista el número de cajeros, miembros, productos, entradas del libro de caja, sesiones y filas de historial de billetera de miembros encontradas.
Qué se Importa
Cajeros, miembros con su saldo de billetera, productos, entradas de ingresos del libro de caja y entradas de gastos.
Las filas de sesión se leen para la vista previa pero se omiten intencionalmente en la importación. El libro de caja ya registra lo que se recaudó por esas sesiones. Importar ambos contaría los mismos ingresos dos veces.
Zona Horaria
Pancafe almacena fechas sin zona horaria. HandyCafe las convierte usando la zona horaria de la computadora que ejecuta la importación. Ejecuta la migración en la máquina que seguirá usando los datos. Ejecutarla en otro lugar puede desplazar las fechas históricas por unas horas.
Antes de Comenzar
- Haz una copia de seguridad primero. Abre Mantenimiento de Base de Datos y usa Hacer copia de seguridad ahora. Una migración escribe en la base de datos en vivo. Una instantánea fresca te da una segunda forma de volver además de Deshacer migración.
- Cierra la aplicación fuente. Una base de datos que se está escribiendo activamente puede producir lecturas incompletas.
- Permite suficiente tiempo. Los conjuntos de datos grandes pueden tardar varios minutos. Deja HandyCafe abierto hasta que el diálogo de progreso informe que la ejecución ha terminado.
- Verifica los conteos cuando termine la ejecución. Compáralos con lo que esperas del sistema antiguo antes de comenzar a operar en el nuevo.
Páginas Relacionadas
- Configuración de Clientes Legacy para permitir que las PC cliente V3 y V4 sigan conectándose a este servidor.
- Mantenimiento de Base de Datos para copias de seguridad y puntos de restauración.
- Miembros, Productos y Precios de Sesión para revisar los registros importados.