数据填报快速入门

本文以客户信息登记为例，讲解 VeryReport 数据填报模块：从新建表单、拖拽控件到提交入库与数据管理。能力规划见《数据填报设计》文档。

范围说明：本文介绍菜单「数据填报」（路由 /data/form）下的在线表单：零代码拖拽设计、Web/移动端填报、数据管理与任务下发。这与「复杂报表设计器」内嵌的填报控件 + 填报设置（见复杂报表填报快速入门）是两套独立能力：本模块面向字段级采集与审批，复杂报表填报面向 Excel 版式清单入库。

1. 概述

数据填报实现「数据采集 → 数据建模 → 数据分析」闭环：业务人员在 Web 表单中录入结构化数据，写入本地表 bi_form_data 或绑定的外部数据库物理表，供后续数据集与仪表板使用。

1.1 预期效果

• 设计器画布含「姓名、手机号、地区、备注」等字段；
• 填报页校验必填项后提交成功；
• 「数据管理」中可查看、搜索、导出已提交记录；
• （可选）下发填报任务给指定同事，或开启入库审批。

2. 制作步骤

2.1 新建表单

1. 进入 数据填报（左侧资源树，resourceType=FORM）。
2. 点击 ＋ 新建 → 数据填报，选择保存目录并命名，如「客户信息登记」。
3. 进入表单设计器（/data/form/design/:formId）：顶部工具栏 + 左侧控件库 + 中间画布 + 右侧属性面板。

2.2 设计表单

从左侧控件库拖拽或点击添加到画布：

1. 添加单行文本：标题「姓名」，字段名 name，勾选必填。
2. 添加手机号：开启格式校验；
3. 添加下拉单选：标题「地区」，配置静态选项或数据集选项；
4. 添加多行文本：标题「备注」，可选填。
5. 在右侧调整列数（1～4 列）、题间距、标题位置等表单级样式。

支持联动：当某字段等于某值时显示/隐藏其他控件。撤销/重做：Ctrl+Z / Ctrl+Shift+Z。

2.3 高级设置（可选）

1. 右侧 高级 Tab：自定义「提交」按钮文字、提交成功提示、提交后跳转 URL。
2. 可开启严格校验、记住上次填写（再次访问自动带入）。
3. 入库审批：在「数据填报管理 → 表单更多菜单 → 审批配置」中开启，指定审批人；提交后先入审批队列，批准后再写入正式表。

2.4 绑定数据库（可选）

默认提交写入平台本地表；若需直接落业务库：

1. 在设计器或表单设置中打开数据库绑定。
2. 选择数据源与物理表（新建表或绑定已有表）。
3. 将各控件字段映射到数据库列；保存后系统在目标库执行 DDL（建表/增列）。
4. 需对数据源具备 USE 权限；解绑仅清除元数据，不删除已有物理数据。

2.5 保存与预览

1. 点击 保存，定义写入 bi_form.definition_json。
2. 点击 预览，在新窗口打开填报页（/data/form/fill/:formId）体验提交。
3. 子工具栏可切换 PC / 移动 布局，移动模式支持扫码填报（单行文本可开二维码）。

3. 填报与数据管理

3.1 填报提交

1. 有 data:form:view 权限的用户打开填报链接，填写并点击「提交」。
2. 若未绑物理表，数据进入 bi_form_data；已绑定则写入外部表（含 _submitter、_submit_time 等系统列）。
3. 若开启审批且选择了审批人，返回「待审批」；审批通过后正式入库。

3.2 数据管理

1. 在设计器「更多 → 表单数据」，或列表进入 数据管理（/data/form/data/:formId）。
2. 查看提交列表、搜索、导出；具备权限时可删除记录（软删）。
3. 开启审批时，在「审批」Tab 处理待办（通过/驳回/撤回）。

3.3 任务下发（可选）

1. 进入 任务下发（/data/form/task/:formId），创建填报任务。
2. 选择接收人、截止时间；支持立即下发、单次定时或周期下发（按 interval + unit）。
3. 接收人在 我的任务（/data/form/my-tasks）中「去填报」；提交后自动回写任务进度。

4. 与 BI 闭环

• 在数据中心 → 数据集中引用填报表（物理表或导出数据）建立模型；
• 在数据分析仪表板中做统计可视化；
• 大屏投屏展示见数据大屏快速入门；
• 复杂 Excel 版式、行式增删改入库请使用复杂报表填报，而非本模块。

4.1 权限说明

表单资源另支持 USE / EDIT / MANAGE 级授权，与文件夹继承规则一致。