业务数据读取规则
表单定义描述有哪些字段,数据读取规则则指定业务记录和字段值实际存储在哪里。将扫描到的表单用于数据集之前,需要先配置读取规则。
配置记录来源
- 打开表单模型的 数据读取规则。
- 先选择业务记录来源。
- 多张表单共用一张表时,配置保存表单标识的列。可以选择主来源或合并来源中的列。
- 选择字段值的读取方式,配置所需的其他来源。
- 检查字段匹配结果,按需调整各个字段。
- 选择每行代表的内容,预览数据并保存。
共享表中保存的表单标识需要与扫描到的表单 ID 或编码一致。例如,form_records.form_id 匹配的是表单 ID,不是某条业务记录的 ID。
字段值的存储位置
| 读取方式 | 示例 |
|---|---|
| 数据库列 | 从 name 列读取客户名称 |
| JSON 路径 | 从 data 列中的 customer_name 属性读取客户名称 |
| XML 路径 | 从 XML 文档的节点读取客户名称 |
| EAV 属性 | 每条属性记录分别保存业务记录标识、字段标识和字段值 |
根据来源样例选择取值位置。普通字段保存在 JSON/XML 中时,系统字段仍可能存放在独立的数据库列中。
合并业务数据来源
同一张表单的业务数据分散在多张表中时,使用 表单数据合并。
- 选择合并表,以及与其对应的已有来源。
- 添加对应列,所有条件需要同时满足。
- 根据需要添加固定值条件,例如实体类型或绑定类型。
- 选择未匹配到记录时,保留已有数据并将对应字段留空,还是跳过该记录。
- 配置字段匹配,使系统可按字段编码或来源字段 ID 从合并表生成读取映射。
至少需要一条来源之间的字段对应条件。固定值用于限制合并范围,不能代替记录关联。
例如,实体资料通过绑定表连接到表单记录时,常见链路是:
entities.id → bindings.entity_id
bindings.form_record_id → form_records.id
按来源实际要求补充租户、表单等匹配条件,并限制适用的绑定类型。字段可以从任一已配置来源取值。已有映射优先;多处都可能提供同一字段时,需要明确选择。
选择每行代表的内容
该设置作用于当前编辑器中的整套读取配置。
| 选项 | 适用情况 | 多条匹配时的行为 |
|---|---|---|
| 每行一条记录 | 每条业务记录在各合并来源中最多匹配一行 | 合并来源匹配多行时,读取报错 |
| 每行一条关系 | 一条业务记录允许有多条绑定或关联记录 | 每条匹配关系分别返回一行 |
| 每行一条明细 | 结果代表行项目或展开的明细 | 每条明细分别返回一行 |
例如,一名人员存在两条资料绑定,如果关联条件没有限定为其中一条,就不满足 每行一条记录。多条结果符合业务需要时,应选择关系或明细粒度。
一对多结果中的主表值会重复。直接汇总主表金额可能重复计算,请按业务含义选择数据集粒度和聚合方式。
调整并复用字段配置
在 字段匹配结果 中点击字段的 调整,配置取值位置和关联值格式。
关联值可能是直接的 ID/编码、包含标识的对象,或标识/对象列表。对象格式需要指定其中的标识位置。关联显示名称会单独解析,原始值继续用于匹配。
通用字段可以应用到其他表单。候选列表仅包含字段编码、类型和读取来源一致的表单。保存后会替换所选表单中该字段的取值位置和关联值格式,保留名称、选项和其他字段。
匹配结果会区分当前规则中 已配置 的字段,以及其他规则覆盖的 已有规则 字段。字段已由其他规则覆盖时,不需要仅因为新建规则而重新配置。
展开明细与合并同结构表
JSON/XML 列表代表明细行时,可以展开明细。选择列表位置、配置明细字段,并决定无明细记录是否保留。
同类记录分散在不同表中时,例如按年份分表,可以使用同结构多表合并。需要确认每个来源的字段映射;这与通过关联增加列的方式不同。
检查预览
检查多条记录的空值、关联名称、日期时间及重复行。字段为空时,先将配置的来源和路径与实际样例对比,再检查显示格式。
保存并应用读取配置后,再创建或刷新数据集。