Skip to content

数据填报

数据填报解决「报表平台缺一段人工录入的数据」问题:管理员设计填报模板(复用工作流表单设计器)→ 填报人通过填报入口提交 → 人工审核或 Workflow 流程审批 → 批准后自动生成数据集,直接供仪表盘/打印报表消费。

涉及三个入口:

入口路径用途
填报模板/report/fill-templates管理员设计、发布、下线模板
填报入口/report/fill/{code}填报人按模板编码填写提交(从模板列表「去填报」进入)
填报记录/report/fill-records「我的填报」与「审核管理」两个标签页

填报模板

模板直接复用工作流的 表单 Schema(WorkflowFormSchema),新建/编辑为两步向导:

  1. 基本信息:模板编码(唯一,发布后作为填报入口地址)、名称、负责人、资源目录、是否需要审核、审核流程(可选绑定 Workflow 流程定义)、模板说明。
  2. 字段设计:可视化设计表单字段,右侧标签页可随时预览填写效果。

模板生命周期

状态为 draft(草稿)→ published(已发布)→ disabled(已下线)

  • 发布」时固化 schema 与修订号;已有记录继续使用自己的 schema 快照,不受后续模板编辑影响;
  • 下线」后不再接受新填报;「克隆」可复制模板快速建新版;
  • 列表提供「去填报」直达填报入口。

填报与审批

记录状态机

  • 填报人在「我的填报」点「发起填报」选择已发布模板进入填报入口;草稿与被驳回的记录点「编辑 / 修改重提」会带着记录 ID 回到填报入口继续填写;
  • 「取消草稿 / 撤回」把记录置为已取消;提交携带 expectedRevision,防止重复提交与并发覆盖,状态冲突时会提示刷新;
  • 记录「详情」可查看冻结表单快照(当时的表单结构 + 填写值)与审核轨迹。

两种审核方式

模板配置审核方式
needReview = false提交即批准
needReview = true,未绑定流程由拥有 report:fill:record:review 的审核人在「审核管理」人工通过 / 驳回
绑定 workflowDefinitionId提交自动发起 Workflow 流程实例,按流程节点审批;不能再用人工审核接口旁路

批准后生成数据集

记录批准后自动提交任务中心异步任务 report-fill-sync,把批准数据原子写入生成数据集,并在记录上回填 generatedDatasetIdsyncTaskIdsyncStatus。生成数据集与普通数据集一样可用于仪表盘、打印报表与预警。

金额类字段按表单定义处理,业务金额建议使用整数分

导出

填报记录支持导出(接入导出中心),需要 report:fill:record:export

权限

操作权限码
模板查看report:fill:template:list
模板新增 / 编辑 / 删除report:fill:template:create / :update / :delete
模板发布 / 下线report:fill:template:publish
模板克隆report:fill:template:clone
我的填报查看report:fill:record:list
新建 / 编辑草稿report:fill:record:create / :update
提交report:fill:record:submit
撤回 / 取消report:fill:record:cancel
审核(审核管理标签页)report:fill:record:review
导出report:fill:record:export

Built with VitePress for local documentation preview.