填报概述
复杂报表填报入门：制作流程、与菜单数据填报的区别、控件与写入策略、提交即入库（无审批）。
复杂报表填报在复杂报表（.vrp）版式内完成数据录入与回写：单元格挂填报控件，通过「填报设置」映射到库表字段，填报预览中修改后提交即入库。适合中国式表格、清单订正、预算编制、巡检行表等「版式强、要在格子里改数」的场景。
产品入口：菜单 数据分析 → 复杂报表 → 打开设计器 → 设置 → 填报设置 / 预览 → 填报预览。动手示例见 填报示例。
1. 适用版本
报表设计器版本 |
|---|
since 3.0 |
2. 与「数据中心 → 数据填报」的区别
VeryReport 提供两套填报能力，请按场景选型，勿混用概念：
对比项 | 复杂报表填报（本文） | 菜单数据填报（FORM） |
|---|---|---|
入口 | 数据分析 → 复杂报表 → 设计器 / 填报预览 | 数据中心 → 数据填报 |
载体 |
| 独立表单（控件流式布局） |
典型场景 | 清单订正、预算表、巡检行表、套打旁录入 | 问卷采集、任务下发、移动轻表单 |
入库方式 | 提交后由 FillEngine 直接写目标库表 | 写入表单绑定物理表，可走任务与审批 |
审批 / 任务 | 无入库审批、无任务下发（本期能力） | 支持多人任务、入库审批、多次提交策略 |
与查询关系 | 同一张表：数据集展示 + 可填格混合 | 先采集，再由报表 / BI 消费 |
选用原则：版式强、要在报表格子里改数、用于数据更新/订正 → 选复杂报表填报；流程强、要任务/审批/轻表单 → 选数据中心 → 数据填报。
3. 填报制作流程
从零完成一张可提交的填报表，建议按下列步骤操作：
① 准备数据
数据源 + 数据集 SQL
→
② 设计版式
表头 + 数据行绑定
→
③ 挂填报控件
右侧「控件设置」
→
④ 填报设置
库表 · 字段 · 策略
→
⑤ 填报预览
修改 → 提交入库
步骤 | 做什么 | 设计器入口 |
|---|---|---|
① 准备数据 | 接入数据源；建模板数据集（订正场景 SQL 须带稳定 | 左侧数据集 |
② 设计版式 | 表头文案 + 数据行拖入字段，设置边框与扩展 | 画布 / 单元格属性 |
③ 挂控件 | 选中可编辑单元格，右侧「控件设置」选文本/数字/下拉等；明细行可加「添加行 / 删除行」 | 右侧面板 → 控件设置 |
④ 填报设置 | 指定数据源、目标表、写入策略、字段映射与主键 | 设置 → 填报设置 |
⑤ 预览提交 | 填报预览中改数，点工具栏「提交」写回库表 | 预览 → 填报预览 |
4. 填报控件与提交区
4.1 常用控件
录入类：文本、文本域、数字、密码、日期
选项类：单选、复选、下拉、下拉复选、下拉树（可配数据字典）
行操作：添加行、删除行（表格行填报）
控件名称会参与「填报设置」中的字段映射；建议与库表字段含义一致，便于「智能添加」。
4.2 填报设置（写入策略）
路径：设置 → 填报设置（按 Sheet 配置）。每一项设置对应一张目标表：
写入策略 | 行为 | 适用 |
|---|---|---|
更新或插入（UPSERT） | 按主键命中则 UPDATE，否则 INSERT | 日常订正 / 新增混合（推荐） |
仅插入 | 每次只 INSERT | 纯新增明细 |
仅更新 | 只按主键 UPDATE；未命中则失败，不误插 | 大数据订正、禁止新增 |
非「仅插入」时须至少勾选一列主键，否则无法正确更新。可用「智能添加」按控件名称匹配表字段。
5. 提交方式说明
打开 填报预览，在单元格中修改；工具栏提供 提交 / 重置 / 打印 / 导出 / Excel 导入（开启分页时还有翻页）。
点击 提交 后立即写库，不经过审批流。
模版预览设置中可配置提交范围：仅提交修改过的行（推荐） 或 提交当前页全部行。详见 填报分页。
大批量同结构改数，可配合 Excel 智能导入。