官方文档

填报示例

以报表用户信息录入(编号/姓名/年龄)为例:数据集、控件、填报设置、填报预览提交全流程。

本文以复杂报表用户信息录入为例,演示从数据集 → 控件 → 填报设置 → 填报预览提交的完整制作过程。配套概念见 填报概述

1. 示例目标

维护一张用户清单表,预览时可修改「姓名」「年龄」,提交后写回数据库 user 表。

含义

是否可填

编号

主键 id

一般只读展示(作主键映射)

姓名

name

文本控件,可改

年龄

age

数字控件,可改

CREATE TABLE `user` (
  `id` int(11) NOT NULL,
  `name` varchar(255) DEFAULT NULL,
  `age` int(11) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2. 制作步骤

2.1 准备数据源与数据集

  1. 确认数据源已连通目标库(含 user 表)。

  2. 打开报表设计器(id=380),左侧 数据集 → 新建数据库查询,例如命名 ds1

SELECT id, name, age
FROM `user`
ORDER BY id

注意:若后续要开「数据集分页」做大数据订正,ORDER BY 必须稳定(建议主键)。

2.2 设计表格版式

  1. 第 1 行写表头:编号、姓名、年龄;设置加粗、边框。

  2. 第 2 行分别拖入 ds1.idds1.nameds1.age(纵向扩展)。

  3. 保存模板。

2.3 配置填报控件

  1. 选中姓名单元格(数据行)→ 右侧 控件设置 → 控件类型选 文本控件,控件名称建议填 name

  2. 选中年龄单元格 → 控件类型选 数字控件,名称建议 age

  3. 编号列若只需展示作主键,可不必挂录入控件;在填报设置里把 id 映射为主键字段即可(常绑定数据集字段)。

2.4 配置填报设置

  1. 菜单 设置 → 填报设置

  2. 添加一项设置:选择数据源、数据表 user

  3. 写入策略建议:日常改数用 更新或插入;纯订正用 仅更新

  4. 字段映射:

    • id → 勾选主键;

    • nameage → 对应控件或单元格。

  5. 可用「智能添加」按名称匹配后微调;确定后保存报表。

数据集

SELECT … ORDER BY id

控件

name / age

填报设置

user 表 + 主键

提交

直接写库

3. 填报预览与提交

  1. 点击 预览 → 填报预览

  2. 在表格中修改姓名或年龄;改过的行会参与「仅修改行」提交。

  3. 点击工具栏 提交:成功后数据已写入 user 表,可用 SQL 核对。

  4. 重置可恢复当前页未提交修改;打印 / 导出与普通预览类似。

复杂报表填报没有「入库审批」:提交即生效。若业务需要审批,请改用 数据中心 → 数据填报

4. 可选增强

  • 明细需增删行:在行上配置「添加行 / 删除行」控件,并在填报设置中映射完整列。

  • 数据量大:开启填报分页,见 填报分页

  • 批量改数:配置 Excel 导入区域后使用工具栏导入,见 Excel 智能导入

5. 常见问题

Q:提交提示未配置填报设置?
A:请在设计器 设置 → 填报设置 中配置库表与字段映射并保存报表。

Q:仅更新策略提交失败?
A:检查主键是否勾选、预览数据中主键是否为空、库中是否存在对应记录。

Q:改了数但提交没有变化?
A:确认走的是填报预览(不是仅分页预览);分页预览工具栏无「提交」。若开启了「仅提交修改行」,请确认单元格确有编辑。