目录
位置与使用者开始之前第 1 步 — FirebirdSQL 检查第 2 步 — 源文件将备份准备为 UTF-8 并连接 / 测试连接第 3 步 — 表清单和选项第 4 步 — 迁移和进度第 5 步 — 结果和对账维护面板常见错误在 Linux 上从旧程序迁移数据(Firebird):设置 › 数据迁移
旧程序(FirebirdSQL)中的数据——往来单位和库存卡片、发票、送货单、支票、配方、图片和文件——在您登录后,通过 设置 › 数据迁移(从旧程序) 迁移到 HNR。首次设置向导不再迁移数据。只有系统管理员能看到此部分;在手机上(花园 + 步骤界面),同一流程会分步打开。
请先用向导创建公司:数据会迁移到已经建立的公司中;此部分不会新建公司。迁移前请备份目标公司。旧程序的数据库只读取:迁移过程中不会更改任何一行。
位置与使用者
设置 › 数据迁移(从旧程序)。只有系统管理员能看到并使用此部分;没有管理员权限的用户会看到“数据导入仅对系统管理员开放。”如果服务器处于只读模式(写入闸门关闭),迁移不会开始。
首次设置向导中的“导入数据库(从旧公司迁移数据)”按钮不再迁移数据,只显示一条提示:请先创建公司,登录后打开 设置 › 数据迁移 部分。
在手机上(花园 + 步骤界面),同一部分会分步打开:每一步是单独的屏幕,按钮大小便于手指点按,表格以卡片形式显示。
开始之前
- 目标公司必须已经建立。请用首次设置向导创建公司,并以管理员身份登录。
- 请备份目标公司。迁移会向公司写入大量记录;请准备一份出现问题时可以恢复的备份。
- 本机必须已安装并运行 FirebirdSQL 3.0、4.0 或 5.0。第 1 步会检查这一点。
- 旧程序的备份文件(.FBK)或数据库文件(.FDB)必须能从本机访问。如果有图片和文件数据库(EK1),应放在同一文件夹中。
- 请准备好 SYSDBA 密码(如果安装 Firebird 时未更改,默认为
masterkey)。如果要选择备份(.FBK),请预留约为备份大小 4 倍的可用磁盘空间。
第 1 步 — FirebirdSQL 检查
页面打开时,会检查本机是否安装了 FirebirdSQL、是否正在运行以及版本。旧程序的数据通过本机的 FirebirdSQL 读取:服务器就是本机(localhost),端口为 3050(如果安装时更改过,则为 firebird.conf 中的 RemoteServicePort 值),用户为 SYSDBA。这些都不会询问,只需输入密码。
| 情况 | 怎么做 |
|---|---|
| 未安装。屏幕显示“请先安装 FirebirdSQL。”,无法继续。 | 通过“FirebirdSQL 下载页面”(firebirdsql.org)链接,以默认设置(端口 3050、SYSDBA)安装 FirebirdSQL 3.0、4.0 或 5.0,然后点击“重新检查”。 |
| 已安装但服务未运行。警告中还会显示版本和端口。 | 打开 Windows 服务,启动“Firebird Server - DefaultInstance”服务,然后点击“重新检查”。 |
| 版本不受支持。会出现“不支持此 FirebirdSQL 版本”的警告。 | 请安装 FirebirdSQL 3.0、4.0 或 5.0。 |
| 就绪。绿色框中显示“FirebirdSQL 已安装并正在运行”,以及版本、localhost:端口和 SYSDBA。 | 点击“继续”进入第 2 步。 |
此步骤还会显示“导入前请备份目标公司。”警告。如果之前进行过迁移,“显示上次导入的结果”按钮会打开该结果。
第 2 步 — 源文件
选择文件按钮会打开 Windows 的文件打开窗口。请选择旧程序的备份(.FBK)或数据库(.FDB);也接受 .BAK 和 .GDB 扩展名。选择其他类型的文件会被拒绝(KAYNAK_DOSYA_TURU)。
EK1(图片和文件数据库,例如 HESAP_EK1.FBK 或 HESAP.FDB_EK1.FBK)无需另行选择:系统会在同一文件夹中自动找到它,并在所选文件下方显示“已找到 EK1”。如果找不到,会出现“未找到 EK1,仅迁移主文件”的警告,图片和文件不会迁移;请把 EK1 放到与主文件相同的文件夹中,然后重新选择文件。
当 HNR 作为 Windows 服务运行时,文件通过浏览器自身的文件选择窗口选择。此时请在同一窗口中(按住 Ctrl 键)同时选择主文件和 EK1 文件。所选文件会以百分比进度复制到本机的迁移文件夹(aktarim\kaynak)中;原始文件不会被改动。
大文件的快捷方式:对于数 GB 的备份,请先将主文件和 EK1 文件复制到本机的迁移文件夹(aktarim\kaynak;选择文件前,完整路径显示在按钮下方),然后通过选择文件只选择主文件。文件夹中已有的同名同大小文件不会再次复制;屏幕上会显示“该文件已在导入文件夹中,未再次复制。”,并会在同一文件夹中自动找到 EK1。从浏览器上传的大文件会分段发送。
选择文件后只需输入 SYSDBA 密码。SYSDBA / masterkey 是 Firebird 的初始值;如果安装 Firebird 时更改过密码,请输入您自己的密码。
将备份准备为 UTF-8 并连接 / 测试连接
如果您选择了备份(.FBK),按钮会变为将备份准备为 UTF-8 并连接。备份在服务器上恢复(“正在恢复备份…”),转换为 UTF-8 并验证内容(“UTF-8 转换和内容验证…”);进度以表数和行数显示。通过验证的副本将用作数据源,原始备份保持不变。此操作需要约为备份大小 4 倍的可用磁盘空间。
如果您选择了数据库(.FDB),按钮会变为测试连接:它连接到数据源,并显示版本、表数以及是否找到 EK1。成功后显示“已连接 · 版本 … · … 个表”,读取清单按钮变为可用。
第 3 步 — 表清单和选项
读取清单会列出数据源中的所有表;不会有任何表被悄悄遗漏。每个表都带有以下四种决定之一:
| 决定 | 含义 |
|---|---|
| 对象 | 从表中生成卡片/单据,并通过公司自身的写入路径保存(例如 MUSTERI → 往来单位卡片)。 |
| 复制 | 如果目标中存在同名表,则逐行复制共有的列。 |
| 派生 | 不复制:往来单位余额、库存现有量等值由写入路径重新生成。 |
| 跳过 | 系统表或日志表。 |
在同一步骤中设置迁移选项:
- 试运行(不写入任何内容):在不写入目标的情况下试行迁移;您可以提前看到数量和可能的错误。建议在正式迁移前先试运行一次。
- 同时导入已删除单据存档和同时导入历史交易记录:一并迁移旧程序的已删除单据备份和历史交易表。
- 导入图片和文件(EK1):如果找到了 EK1,也会一并迁移图片和文件。
- 即使目标已有数据也继续:如果目标公司已有记录,迁移默认会停止(
HEDEF_DOLU);只有在您清楚自己在做什么并且已经备份的情况下才勾选。 - 批量大小:迁移每次处理的记录数(1–5000,默认 200)。
单据编号会被保留:数据源中的发票、支票和凭证编号在目标中保持不变。如果再次迁移同一数据源,不会写入重复记录;已有的记录会被跳过。
第 4 步 — 迁移和进度
开始导入会在服务器上启动迁移。屏幕上显示阶段、百分比和已用时间,以及逐表的卡片/单据/已写入/已跳过/出错数量、文件数和迁移日志的最后几行;如果引擎使用多个线程,还会显示线程数及明细。
迁移在服务器上进行:即使关闭此窗口或浏览器,任务也不会停止。重新打开页面时,系统会找到正在进行的迁移并显示其进度。停止会停止任务并显示“导入已停止。”
第 5 步 — 结果和对账
迁移结束后显示“导入已完成。”,对账表会比较来源与目标:往来单位余额、库存现有量、支票、发票、配方和文件。每一行显示项目、来源、目标、差异和状态(一致 / 偏差 / 已知偏差);此外还显示逐表结果、耗时、示例行错误和自动更正的数量。
如果对账存在偏差,屏幕会显示“导入已完成——但对账存在偏差。”并列出出现偏差的指标。使用迁移后的公司之前,请检查对账表;您可以通过旧系统对账报告 · PDF按钮获取 PDF 报告,或用打印将其打印出来。
出错行的示例列在“示例行错误”下;如果迁移无法完成,请查看迁移日志了解详情。
维护面板
第 2 步下方的维护面板提供两项操作:
- 修复未结余额:如果从旧程序迁入的发票中剩余金额(未结余额)为空,则根据往来单位交易重新计算。先显示“预览”,不写入任何内容(将更改的发票数、更改前后的合计、跳过的往来单位);如果确认无误,请点击“应用修复”。
- 重新填充词典:补充界面翻译中缺失的条目;手动编辑过的翻译不会改变。可能需要几分钟;请不要关闭此窗口。
常见错误
错误消息会显示服务器的详细信息,并在括号中给出错误代码;例如“服务器上未配置备份准备工具。— gbak/gfix not found (KAYNAK_HAZIRLIK_AYAR)”。联系支持时请提供该代码。
| 代码 | 含义和解决方法 |
|---|---|
FIREBIRD_KURULU_DEGIL | “本机未安装 FirebirdSQL。”请安装 FirebirdSQL 3.0、4.0 或 5.0,然后点击“重新检查”。 |
FIREBIRD_CALISMIYOR | FirebirdSQL 已安装,但其服务器未运行。请在 Windows 服务中启动“Firebird Server - DefaultInstance”服务,然后重新检查。 |
KAYNAK_KIMLIK | “源数据库用户名或密码被拒绝。”请重新输入 SYSDBA 密码;如果安装 Firebird 时更改过密码,请输入该密码(默认为 masterkey)。 |
KAYNAK_HAZIRLIK_AYAR | “服务器上未配置备份准备工具。”如果详细信息中显示 gbak/gfix not found,说明未安装 FirebirdSQL;如果显示 Firebird server not running,请启动 Firebird 服务。检查安装和服务后重试;如果问题仍然存在,请将代码转告支持团队。 |
KAYNAK_HAZIRLIK_DISK | “磁盘空间不足,无法恢复备份并创建 UTF-8 副本。”请在迁移文件夹所在的磁盘上腾出约为备份大小 4 倍的空间,然后重试。 |
KAYNAK_YEDEK_GECERSIZ | “该文件不是有效的 Firebird FBK/BAK 备份。”文件可能已损坏或属于其他类型;请从旧程序重新备份并选择,或选择 FDB 文件。 |
KAYNAK_DOSYA_TURU | “只能选择 Firebird 数据库或备份文件(.fbk、.fdb、.bak、.gdb)。”请选择扩展名合适的文件;不要把 EK1 文件选作主文件。 |
HEDEF_DOLU | “目标公司已有记录。”如果该公司以前使用过,新建一个公司更安全;如果您有意继续,请先备份,并在第 3 步勾选“即使目标已有数据也继续”。 |
同一公司同一时间只能运行一个迁移(“该公司已有一个数据导入正在进行。”)。如果服务器处于只读模式(“写入闸门已关闭”),迁移不会开始。
在 Linux 上
FirebirdSQL 可通过您所用发行版的软件包管理器或 firebirdsql.org 安装。gbak 和 gfix 工具必须位于 PATH 中或 /opt/firebird 下;其余步骤与 Windows 相同。
相关指南
- 设置和登录 - 创建您的程序设置窗口包含两种设置侧面:那些是 你的独自 (主题、窗口布局、短篇)以及那些 影响公司运营 (HNR 优先事项、用户、连接、公司详细信息和打印表格)。
- Data Cleanup — A Guide from ScratchOver the years the same customer gets opened two or three times ("ABC Ltd.
- 我一个人使用:10 分钟上手适用于独自使用本程序的小店、小作坊或自由职业者:从安装到第一张发票和月末所需的步骤。
- 实用用户手册此页面是为员工使用该程序的第一次,需要安全完成日常工作。 首先阅读这里的常规规则,然后打开你的工作模块的指南.
- 你的第一天 - 为第一次坐在节目中的人这是每个人都应该阅读的第一页,需要 分钟. 我们不在这里学习会计,只是 如何驱动屏幕: 如何打开窗户,如何找到你正在寻找的东西,每个钥匙做什么。
- 文档链 - 该计划的背景这个指南不是关于一个窗口,而是关于 窗口之间的链接. 一个新来的头脑中的真正差距不是“这个按钮做什么”而是“我发送了一个引用,现在什么?”