流程图模板:梳理决策、负责人和异常
流程图模板将范围明确的任务转化为有明确名称的动作、可回答的决策问题和明确结果。连接可执行节点前,先填写分支标签和负责角色。下方实例模板描绘 CSV 导入前的分流检查:确定解析规则配置,隔离结构不一致的文件,或准备映射清单,全程不写入目标记录。
作者:Ai Flowi · 发布于
选择流程边界与输出
本流程从一份冻结的合成 CSV 文件副本开始,最终产生三种材料之一:准备好的映射清单、隔离报告或解析配置尚未确定的记录。记录导入属于另一流程。因此,清单表示拟议映射已可供检查,并不表示任何行已插入。
之前的请求接收流程图涵盖更正和人工审核;本模板则将文件解释、结构验收和目标映射分开处理。
绘图前,将决策写成答案可观察的问题。“文件看起来没问题”无法说明哪些检查决定了路线;“每条解析后的记录是否都具有声明的列数?”则可以。文件引用与解析规则配置应一起冻结:中途更换分隔符,会对相同字节产生不同解释,使之前的列数检查失效。
复制可编辑的工作流程图
将这段 Mermaid 源码复制到支持 Mermaid 的现有编辑器中。矩形表示动作,菱形表示问题,圆角终点标明产生的材料。这些标签描述的是人工设计的流程,并非声称 AI Flowi Workflow 内置了相应 CSV 导入控制。
flowchart TD
A([Frozen file copy]) --> B[Identify parsing profile]
B --> C{Exactly one profile established?}
C -- Yes --> D[Inspect parsed record widths]
C -- No --> F[Profile analyst resolves interpretation]
F --> G{Explicit profile established?}
G -- Yes --> D
G -- No --> H([Held: unresolved profile note])
D --> E{All record widths consistent?}
E -- No --> Q([Quarantine report])
E -- Yes --> M[Record explicit column mapping]
M --> P([Mapping manifest prepared])
分析人员路线有明确边界:如果在本次分流检查中无法确定解析规则配置,应记录不确定性并停止。不要不断猜测,直到某个解析器接受文件。隔离会保留冻结的输入和结构差异的位置;它不是删除记录或丢弃原始文件的指令。
填写决策与责任表
| 动作 | 负责角色 | 决策证据 | 输出 |
|---|---|---|---|
| 冻结输入 | 导入操作人员 | 文件引用和不可变的工作副本 | 供所有后续检查使用、标识明确的输入 |
| 确定解析规则配置 | 导入操作人员 | 声明的编码、分隔符、引号及表头规则 | 一份已确定的配置,或交由分析人员处理 |
| 解决歧义 | 解析配置分析人员 | 来源导出规范与候选解释 | 明确配置,或解析配置尚未确定的记录 |
| 检查结构 | 导入操作人员 | 将预期列数与每条解析后记录比较 | 结构一致的结果,或列明差异的隔离报告 |
| 映射列 | 映射维护人员 | 已确定配置、表头位置和目标字段含义 | 连接每个源列与拟议目标字段的清单 |
列映射需要独立材料,因为列数相同并不能证明含义相同。按 reference、message、version 排列的三列文件,不能沿用为 reference、version、message 编写的清单。除表头标签外,还应保留来源位置;否则,重复标签会让仅按名称的映射产生歧义。
修复无去向的分支和缺失的责任分配
BEFORE
Identify profile -> Inspect widths -> Map columns [role missing] -> End
Identify profile -> Ambiguous -> [no destination]
AFTER
Ambiguous profile -> Profile analyst -> Explicit profile or held note
Established profile -> Inspect every record -> Quarantine or column mapping
Consistent structure -> Mapping maintainer -> Prepared manifest
草稿中的歧义分支直接停止,没有保留候选解释。修复时应明确解析配置分析人员,并标明暂缓结果。同时,将笼统的结束框替换为清单材料,并由映射维护人员负责创建。这样,读者就能看出解析成功、但映射尚未记录时还有哪些工作未完成。
让一个合成文件走过修复后的流程。其声明配置使用 UTF-8 文本、逗号分隔符、双引号包围字段,以及表头行。一条消息在引号内含有逗号。如果直接统计原始行中的逗号,会误报多出一列;按照声明的引号规则检查记录,才能保留预期的三个字段。另一条记录确实只有两个字段,因此整个批次在映射前进入隔离报告。本流程不包含任何部分目标写入。
收到更正后的文件时,将其冻结为新输入并重新检查。不要覆盖旧隔离证据,也不要将旧结论套用于新文件的内容。如果替换文件结构一致,由映射维护人员在清单中记录来源位置和目标含义。该材料可交给另行设计的导入流程。
无需执行导入即可检查分支覆盖
- 跟踪一份配置明确且记录结构一致的文件,直到准备好清单;确认终点标明的是材料,而非已完成导入。
- 将配置缺失或冲突的情况跟踪到分析人员。分别演练配置已确定和仍未解决两种答案。
- 将一条解析后结构不一致的记录跟踪到隔离。检查报告是否保留记录位置和预期列数。
- 使用引号内的分隔符和引号内的换行作为示例:记录不一定与物理行一一对应。
- 映射时检查重复表头和变更的列顺序。不能仅凭结构一致就选用旧映射。
这些是桌面推演式覆盖检查。数据流图可以另行跟踪哪些文件字段进入存储;本图记录每项解释决策之后对应的流程结果。
在 AI Flowi Workflow 中表示一个路由决策
状态:已有文档说明。 Condition 已记录在组件目录中;Ai Flowi 尚未进行生产环境测试。
其接口请参阅 Condition 参考;本练习只演示外部检查确定结构检查结果后,如何选择对应分支。
示例配置,并非已记录的测试
准备 AI Flowi Workflow 账户和一份模拟的 JSON 检查记录。将 Condition 的 data_input 设为该材料,key_name 设为 width_state,operator 设为
,equalscompare_value 设为 consistent。分别使用一个结构一致和一个不一致的测试样例,检查两个路由输出。此独立路由检查不需要提供商账户或 API 密钥;后续使用提供商服务时,需要自己的凭据并单独计费。
预期输出是在所选分支上返回该材料。这里的 Condition 不会解析 CSV,也不会生成隔离报告。连接动作前,应将缺少 width_state 作为独立的未解决输入检查;不要认为比较操作验证了检查来源。
工作流图模板有哪些限制?
本模板适用于导入前的文件级分流检查。它没有规定部分接受、并行解析、目标事务或正式 BPMN 语义。如果业务需要接受正确记录并隔离错误记录,应先定义记录标识、批次总量和被拒记录报告如何核对,再修改整份文件隔离的规则。