HandyCafe Docs
owner it-admin

数据迁移

迁移页面将客户、产品、定价和历史记录从其他网吧管理系统导入到HandyCafe中。它位于设置下的基础设施和系统组中。

支持三个来源:

来源 读取内容
HandyCafe旧版 本机上现有的HandyCafe 3.x或4.x安装。
EveryCafe 一个EveryCafe .ecm SQLite数据库文件。
Pancafe 一个Pancafe USDB.DAT Firebird数据库文件。

从页面顶部的卡片中选择一个来源。下面的面板会根据选择进行更改。

每个来源的行为

这三个来源共享相同的工作模型。你在一个上学到的东西适用于其他的。

  • 来源是只读的。 HandyCafe打开原始文件进行读取,从不写入。你的旧安装保持原样。你可以随时返回。
  • 导入前检查。 检查按钮读取来源文件并报告发现的内容。开始迁移按钮在检查成功前保持禁用。
  • 进度按阶段显示。 运行期间会打开一个进度对话框,并报告正在进行的阶段,如会员、产品或交易。
  • 重新运行是安全的。 已导入的行会在原地更新,不会重复。一旦迁移完成,按钮会变为重新运行迁移
  • 每次运行都可以撤销。 在完成运行后,会出现一个撤销迁移按钮。它会删除从该来源导入的所有行。你需要先确认。
  • 警告不会停止运行。 如果某些行无法读取,运行会以完成并带有警告结束。打开日志查看跳过了哪些行。
  • 中断的运行会自行恢复。 如果应用程序关闭或机器在导入中途断电,页面会报告上次导入被中断。重新开始是安全的。

展开面板底部的上次导入计数,查看最近一次运行为每个类别导入了多少行。

HandyCafe旧版

从HandyCafe 3.x或4.x安装导入。这是从早期版本HandyCafe升级的网吧的来源。

检测

在Windows上,页面扫描系统以查找旧版安装并报告:

标签 含义
安装路径 旧版安装在磁盘上的位置。
数据库路径 旧版数据库文件的完整路径。
服务器版本 旧服务器的版本字符串,例如3.4.01或4.0.10。
INI文件数量 在安装文件夹中找到的配置INI文件数量。

如果未检测到任何内容,页面会报告未找到旧版安装。检查旧版文件是否位于标准位置,如Program Files\HandyCafeC:\HandyCafe

在macOS和Linux上,自动扫描无法运行。面板提供了一个文件夹选择器。将其指向从旧Windows机器复制过来的旧版Db文件夹,然后开始迁移。

导入内容

会员、定价层、产品、订单、交易、日志以及旧版INI文件中保存的设置。

在开始前停止旧版服务器。读取时不应写入来源数据库。

完整的操作指南请参见如何从旧版安装迁移

EveryCafe

从一个通常命名为ecmdata.ecm的EveryCafe数据库文件导入。

  1. 选择浏览并选择.ecm文件。扩展名为.db.sqlite的文件也被接受。
  2. HandyCafe在选择文件后会自动检查文件。使用检查按钮在手动编辑路径后再次运行检查。
  3. 查看预览,然后选择开始迁移

预览报告EveryCafe的服务器名称服务器版本,以及文件中包含的收银员、会员、产品、价格表、订单和会话的数量。

导入内容

收银员、会员、产品、定价层、订单、交易和Steam账户。Steam账户密码在写入HandyCafe游戏许可证池时会被加密。

会话和价格表在预览中被计数,以便你查看来源数据的大小。它们不会被导入。

价格表参考

在完成运行后,面板提供一个价格表参考表,列出原始EveryCafe价格行:价格表ID、旧版类型、起始价格、每小时价格和刷新分钟数。

EveryCafe的定价无法直接映射到HandyCafe的定价计划。这些行作为手动设置定价的参考。它们不会被导入为咖啡厅产品。使用它们与定价一起重建你的收费标准。

Pancafe

从一个通常命名为USDB.DAT的Pancafe数据库文件导入。HandyCafe直接读取Firebird文件。无需安装Firebird服务器或客户端库。

  1. 选择浏览并选择USDB.DAT文件。扩展名为.fdb.gdb的文件也被接受。
  2. 查看预览,然后选择开始迁移

预览报告检测到的格式(例如Firebird ODS版本)以及数据涵盖的历史范围。它还列出了找到的收银员、会员、产品、现金账本条目、会话和会员钱包历史行的数量。

导入内容

收银员、带有钱包余额的会员、产品、现金账本中的收入条目和支出条目。

会话行用于预览,但故意不导入。现金账本已经记录了那些会话收集的内容。导入两者会导致同一收入被重复计算。

时区

Pancafe存储日期时不带时区。HandyCafe使用运行导入的计算机的时区进行转换。在将继续使用数据的机器上运行迁移。在其他地方运行可能会使历史日期偏移几个小时。

开始前

  • 先备份。打开数据库维护并使用立即备份。迁移会写入实时数据库。一个新的快照为你提供了除撤销迁移之外的另一种返回方式。
  • 关闭来源应用程序。正在被写入的数据库可能会导致读取不完整。
  • 预留足够时间。大型数据集可能需要几分钟。保持HandyCafe打开,直到进度对话框报告运行完成。
  • 运行结束时检查计数。将它们与旧系统的预期进行比较,然后再在新系统上开始交易。

相关页面