自定义导入

1概述

版本

1.1功能说明

单元格表单的工具栏默认会提供”新增/保存/导入/导出”等基础操作按钮。”自定义导入”是工具栏里可以新增的扩展按钮，它的特点是：

• 不是简单的”复制粘贴”，而是调用另一个表单的整套导入规则
• 导入用的 Excel 模板 = 被引用表单的标准模板（不是你自己的模板）
• 导入的目标数据模型 = 引用表单绑定的数据模型
• 可以挂导入后事件，比如导入完自动刷新当前报表

⚠️ 前提：必须有一个表单已经配好导入规则且通过测试。自定义导入是”复用”，不是”新建规则”。

1.2 适用场景

💡 本教程的实例：数据模型 哈哈（字段 ID/q/w/e）→ 表单 zzz（录入表单，先配好导入规则）→ 表单 测试用例（业务表单，工具栏新增”自定义导入”按钮，调用 zzz 的规则）

2 示例

整体流程：

① 建模板表单 zzz · 配规则 → ② 建业务表单 测试用例 → ③ 加按钮 工具栏配置 → ④ 配事件 导入后刷新 → ⑤ 预览 导入并刷新

数据流：zzz 表单（配好导入规则） → 测试用例 表单（工具栏"自定义导入"） → Excel 文件（用 zzz 的标准模板） → 数据模型 哈哈（目标入库）

2.1 准备模板表单 zzz（先配好导入规则）

这一步必须先做。 自定义导入是调用别的表单的规则，所以得有一个表单的规则已经配好且通过测试。

1. 新建单元格表单 zzz，数据源用 哈哈，在表样里按数据模型字段摆好单元格（ID/q/w/e 摆第一行）：

   

2. 右侧 其他 tab → 导入区，配置：导入方式 = 标准，导入模式 = 直接导入数据库，导入出错时 = 跳过继续：

   

3. 点击工具栏上的 填报规则 按钮，配字段映射（数据源 哈哈，执行模式 智能，每个字段用表达式 = 单元格地址 A3/B3/C3）：

   

4. 保存，然后做一个导入测试——准备一份和字段对应的 Excel：

   

5. 点 导入，选这份 Excel，能正常入库：

   

✅ 到这一步 zzz 就算准备完了。 如果你这步导入都有问题，先去排查 zzz 本身的导入配置（参考 「卡片类型表单数据导入」），别往下做。

2.2 新建业务表单「测试用例」

1. 新建单元格表单 测试用例，数据源选同一个数据模型 哈哈：

   

⚠️ 这一步最常踩的坑：数据源必须跟 zzz 一样，否则”自定义导入”按钮调用的规则找不到对应的表。打开数据源面板确认一下：哈哈 → ID/q/w/e 四个字段都在。

2. 保存，进入 其他 tab，找到 工具栏 区域，功能配置 → 设置 打开工具栏设置弹窗。

2.3 工具栏新增「自定义导入」按钮

1. 在工具栏设置里：左边区域选 自定义导入，点中间的 ＋ 把它加到右边区域。然后右侧配置按下面填：

   

🚨 「导入模板」这一步最容易选错：必须是单元报表单类型，名字跟你配好规则的那个表单（这里是 zzz）完全一致。如果下拉里没看到 zzz，先回去 §2.1 确认 zzz 已经保存 + 导入测试通过，不然它不会出现在备选里。

2. 点 确定，工具栏上现在应该出现”自定义导入”按钮了。

2.4 配置「Excel 导入后」事件

光加了按钮还不够。导入完之后，当前报表里看不到新数据（因为没刷新），所以要配一个”Excel 导入后”的事件 = 报表刷新：

事件是哪个入口加的？回到 其他 tab → 工具栏，找到刚才那个”自定义导入”按钮的配置，事件配置那一行 ＋ → 选 Excel 导入后 → 事件类型选 报表刷新。

💡 不配这个事件会怎样？ 导入会成功（数据进了数据库），但当前页面的列表不会自动刷新，你得手动刷新页面才能看到新行。配了”报表刷新”就自动看到。

2.5 预览 → 导入 → 验通

1. 保存整个表单，点右上角 预览。

2. 工具栏上现在能看到 「自定义导入」 按钮。点它，弹”导入 Excel”对话框（用 zzz 的标准模板格式）：

   

3. 选好 Excel 文件（这里测的是 985 / 清华1 / 110 / 110），点 导入，先看到 “解析成功” 提示：

   

4. 因为配了”报表刷新”事件，列表自动刷了一遍，新行 985 / 清华1 / 110 / 110 出现在第 6 行：

   

✅ 整个流程跑通了。 你在”测试用例”表单里点”自定义导入”，数据进了”哈哈”模型，而导入规则完全复用 zzz 的，你自己一份都没重配。

3 常见问题