5.3 KiB
2026-10-23 当前页面职责
字段映射已简化为BPM流程与节点目录:自动采集开关、BPM连接选择、只读更新、搜索和流程/节点列表。目录持久化,提供分类规则新增匹配项的下拉候选。Excel导入只改分类草稿,不能修改此目录;未知流程或节点逐行警告且不能直接启用执行。内部详情适配器和历史证据保留。以下旧版字段来源编辑说明仅作为历史技术资料,当前页面不再提供这些控件。最新操作见 业务配置与Excel导入。
旧版字段来源编辑(历史资料)
入口:业务设置 → 字段映射。管理员低频维护,日常人员查看结果即可。分类规则消费本页已生效接口,负责流程节点、收件人和通知/归档策略;本页集中维护字段来源。
- 搜索已采集订单(标题、流水号或已能确定的主订单号),选择后自动定位左侧实际流程/版本。默认已采集待办,可切换历史;左侧仍显示未采集版本。也可展开“从 BPM 选择”,选授权连接后只读采集;默认全部待办配置采样,历史必须主动选择。实时列表只搜索已读取的标题/流水号,不能搜索尚未采集的表单值。列表15分钟有效,采集前重新核对版本、身份及连接。
- 选单后自动显示主订单、0数量、客户等实际值,以及全部标题订单。优先复用同流程/版本草稿,其次唯一生效配置,最后采用当前真实字段唯一标签;已有草稿中的空项不会自动补齐。不依赖模型、不借其他版本或参考配置兜底。多个同名候选在业务项下选择;完整字段搜索及技术路径收进“调整字段对应(高级)”,展开才读取全部字段。
- 主订单号必须对应表单明确字段。客户、数量、日期、更改原因等按实际需要对应;数量与金额分开。摘要固定按标题订单号拆段,HA订单也保留,不需选择表单摘要。邮件摘要输出按行显示订单号、机芯号、产品型号、客户简称、出货方式、总数量;未取得项明确标注,0数量保留。不同摘要段落仍关联同一个BPM事件,不自动创建额外PDF任务。
- 选单与预览只读,不产生草稿版本、检查凭据、执行任务或邮件;只有调整来源才标为未保存。显式保存草稿后点击检查,对照原始标题查看主订单、全部标题订单和各分类PDF文件名。草稿保存不会影响当前生效映射。修改样本或字段后,旧检查立即失效;预览通过不能代替服务端检查。
- 核对受影响分类,勾选确认后点击“确认生效”。服务端再次核对版本、采集证据和关联分类上下文;之后关联已发布分类暂停,需到分类规则第04步重新检查并发布。已有冻结批次保持原内容。
状态包括未采集、待配置、待检查、检查通过、检查未通过、已核验、版本变化。参考配置仅供理解,不代表已核验配置,不允许直接启用真实分类。未知版本须重新采集配置。
失败会保留输入。若保存成功但刷新失败,页面分别提示两个结果。保存/检查/生效响应丢失时,先查询持久状态并核对本次操作标识、版本、样本和来源;无法确认则禁用重复提交,刷新核对。旧检查不能冒充新请求成功。采集明确失败后可再次读取;结果不明时保留操作标识。
新写入接口分为 field-mappings/draft、check、activate,携带当前草稿版本与幂等标识。旧 adapters 写入仅生成待检查草稿,不能直接标为已核验;旧字符串路径可读取为表单来源。
只读入口为 GET field-samples/catalog 和 POST field-mappings/propose。目录先按连接授权,再搜索及稳定游标分页;提案每次从服务端重取所选证据,不接受客户端字段值或元数据。页面初次读取 fields?view=directory 只取覆盖/操作摘要,不带完整表单或旧检查实际值;高级区沿用完整 fields 接口。操作员和只读成员只能看有权连接的证据,实时采样与配置写入仍仅管理员可用。
采集及检查不会发信、归档或办理节点。正式自动通知仍暂停;真实类别、字段、存储、邮箱及预览完成现场核验后再另行启用。
历史样本显示实际流程版本;历史接口未提供办理节点及通知接收时间,页面使用“历史查看(未提供办理节点)”和“流程发起时间”。历史证据可检查字段对应,不能用于分类规则的真实通知节点发布检查。若文件名采用接收时间,历史检查中的日期只是发起时间示例,正式执行仍须验证真实待办接收时间。
历史采样仅使用已观察的已办/任务查询接口,按配置流程读取最近100条中的最新实际版本,最多尝试同版本三份。不是全部历史版本的完整档案;未出现的流程保持“未采集”,不同名称不自动合并。多行字段采集独立于PDF排版核验,字段有证据不表示PDF导出已就绪。
ZCode 已内置本项目的“BPM 样本与字段映射”技能,见技能接入说明。可建议采集和准备草稿操作卡;确认生效和分类发布仍由管理员在配置页面完成。