流程图模板:梳理决策、负责人和异常

流程图模板将范围明确的任务转化为有明确名称的动作、可回答的决策问题和明确结果。连接可执行节点前,先填写分支标签和负责角色。下方实例模板描绘 CSV 导入前的分流检查:确定解析规则配置,隔离结构不一致的文件,或准备映射清单,全程不写入目标记录。

作者:Ai Flowi · 发布于

选择流程边界与输出

本流程从一份冻结的合成 CSV 文件副本开始,最终产生三种材料之一:准备好的映射清单、隔离报告或解析配置尚未确定的记录。记录导入属于另一流程。因此,清单表示拟议映射已可供检查,并不表示任何行已插入。

之前的请求接收流程图涵盖更正和人工审核;本模板则将文件解释、结构验收和目标映射分开处理。

绘图前,将决策写成答案可观察的问题。“文件看起来没问题”无法说明哪些检查决定了路线;“每条解析后的记录是否都具有声明的列数?”则可以。文件引用与解析规则配置应一起冻结:中途更换分隔符,会对相同字节产生不同解释,使之前的列数检查失效。

复制可编辑的工作流程图

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 文本、逗号分隔符、双引号包围字段,以及表头行。一条消息在引号内含有逗号。如果直接统计原始行中的逗号,会误报多出一列;按照声明的引号规则检查记录,才能保留预期的三个字段。另一条记录确实只有两个字段,因此整个批次在映射前进入隔离报告。本流程不包含任何部分目标写入。

收到更正后的文件时,将其冻结为新输入并重新检查。不要覆盖旧隔离证据,也不要将旧结论套用于新文件的内容。如果替换文件结构一致,由映射维护人员在清单中记录来源位置和目标含义。该材料可交给另行设计的导入流程。

无需执行导入即可检查分支覆盖

  1. 跟踪一份配置明确且记录结构一致的文件,直到准备好清单;确认终点标明的是材料,而非已完成导入。
  2. 将配置缺失或冲突的情况跟踪到分析人员。分别演练配置已确定和仍未解决两种答案。
  3. 将一条解析后结构不一致的记录跟踪到隔离。检查报告是否保留记录位置和预期列数。
  4. 使用引号内的分隔符和引号内的换行作为示例:记录不一定与物理行一一对应。
  5. 映射时检查重复表头和变更的列顺序。不能仅凭结构一致就选用旧映射。

这些是桌面推演式覆盖检查。数据流图可以另行跟踪哪些文件字段进入存储;本图记录每项解释决策之后对应的流程结果。

在 AI Flowi Workflow 中表示一个路由决策

状态:已有文档说明。 Condition 已记录在组件目录中;Ai Flowi 尚未进行生产环境测试。

其接口请参阅 Condition 参考;本练习只演示外部检查确定结构检查结果后,如何选择对应分支。

示例配置,并非已记录的测试

准备 AI Flowi Workflow 账户和一份模拟的 JSON 检查记录。将 Condition 的 data_input 设为该材料,key_name 设为 width_state,operator 设为 equals,compare_value 设为 consistent。分别使用一个结构一致和一个不一致的测试样例,检查两个路由输出。此独立路由检查不需要提供商账户或 API 密钥;后续使用提供商服务时,需要自己的凭据并单独计费。

预期输出是在所选分支上返回该材料。这里的 Condition 不会解析 CSV,也不会生成隔离报告。连接动作前,应将缺少 width_state 作为独立的未解决输入检查;不要认为比较操作验证了检查来源。

工作流图模板有哪些限制?

本模板适用于导入前的文件级分流检查。它没有规定部分接受、并行解析、目标事务或正式 BPMN 语义。如果业务需要接受正确记录并隔离错误记录,应先定义记录标识、批次总量和被拒记录报告如何核对,再修改整份文件隔离的规则。