流程自动化执行日志按“一次执行一条记录”填写,用来还原某次流程为什么触发、走到哪一步、失败在哪里、由谁处理。本文提供一张可直接复制的空白表,并逐项说明字段口径、必填与选填的划分、失败与成功两条填写示例,以及流程版本变化后的维护方法,方便团队统一记录方式。
要点总览(TL;DR)
- 执行日志按“一次执行一条记录”填写,空白表包含执行编号、流程名称与版本、触发方式、触发时间、执行状态、步骤结果、失败原因、影响范围、处理动作、处理人、复核人、复核结论和扩展列。
- 执行编号、流程名称、流程版本、触发方式、触发时间、执行状态六项为必填;失败、部分成功或已中止时,失败原因、影响范围、处理动作、处理人转为必填。
- 填写顺序建议先记追溯字段,再记步骤结果,最后补处置链:发生了什么、影响到谁、怎么处理,复核人由非处理人担任。
- 字段确实不适用时填“不适用”或“无”,不用空白代替;选填字段一旦启用,后续同类记录保持同样填法。
- 流程版本升级时同步核对模板字段,新增步骤或分支优先在扩展列补充,历史记录保留原版本号,不回溯修改。
可复制空白模板:流程自动化执行日志表
下面这张表可以直接复制到文档或表格工具中使用。填写粒度为“一次执行一条记录”:流程每触发并运行一次,就新增一行,不把多次执行合并成一条。表头按记录顺序排列,最后一列留作扩展,供流程新增步骤或分支时补充字段。
| 序号 | 执行编号 | 流程名称 | 流程版本 | 触发方式 | 触发时间 | 执行状态 | 步骤结果 | 失败原因 | 影响范围 | 处理动作 | 处理人 | 复核人 | 复核结论 | 扩展列 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | ||||||||||||||
| 2 | ||||||||||||||
| 3 |
复制时保留表头文字,行数按实际执行次数增减。如果团队已有工单号或流水号体系,可以把“执行编号”与既有编号对齐,减少重复编号。扩展列在首次使用时可以留空,等流程出现新步骤、新分支或新的失败类型时再定义用途,避免一开始把表拉得过宽。
字段说明:每个字段记录什么、怎么填
字段口径需要在模板、说明和示例三处保持一致。下表逐项说明每个字段记录什么、按什么格式填写,填写时以本表为准。
| 字段 | 记录内容 | 填写口径 |
|---|---|---|
| 执行编号 | 本次执行的唯一标识 | 按团队约定生成,如“流程缩写-日期-序号”,同一次执行在后续沟通、工单中沿用同一编号 |
| 流程名称 | 被执行的自动化流程名称 | 使用流程在流程清单中的正式名称,与流程文档保持一致,不写简称或口头叫法 |
| 流程版本 | 本次执行所用的流程版本 | 填写版本号或生效日期,便于区分同一流程不同版本下的执行结果 |
| 触发方式 | 流程被启动的来源 | 按约定取值,如定时触发、事件触发、人工手动触发;同一团队使用同一套取值词 |
| 触发时间 | 流程实际开始执行的时间 | 写到分钟,统一时区;定时任务记录计划时间与实际开始时间不一致时,以实际开始时间为准并在扩展列注明偏差 |
| 执行状态 | 本次执行的整体结果 | 取值约定为成功、失败、部分成功、已中止;部分成功指部分步骤完成、部分步骤未完成 |
| 步骤结果 | 各关键步骤的执行结果 | 按“步骤名:结果”逐项列出,步骤多时只记录关键步骤和失败步骤,结果与执行状态使用同一套取值 |
| 失败原因 | 导致失败或中止的直接原因 | 写具体现象和错误信息,如“接口返回超时”“字段校验不通过”,不写“系统问题”这类无法定位的描述 |
| 影响范围 | 失败对业务对象和下游的影响 | 写明受影响的工作项、单据或数据范围及数量,未造成影响时写“无” |
| 处理动作 | 针对本次执行采取的处理 | 写实际动作,如重试、手工补录、回滚、转人工处理,并注明处理后的结果 |
| 处理人 | 执行处理动作的人 | 填写姓名或工号,与团队账号体系一致 |
| 复核人 | 对记录和处理结果进行复核的人 | 由非处理人担任,复核失败记录和影响范围较大的执行 |
| 复核结论 | 复核后的判断 | 取值约定为通过、需补充、需返工;需补充或需返工时写明缺什么、改什么 |
| 扩展列 | 流程个性化信息 | 按流程需要定义,如重试次数、关联工单号、数据批次号 |
执行状态与步骤结果使用同一套取值,可以让整体结果和单步结果对得上:整体失败时,步骤结果里应能看出哪一步失败;整体成功时,步骤结果不应出现失败项。失败原因、影响范围和处理动作三项构成一条完整的处置链,记录时按“发生了什么、影响到谁、怎么处理”的顺序填写,便于后续复盘时直接读取。
必填与选填:哪些字段不能空
必填字段的作用是保证任何一条记录都能被追溯和复核。执行编号、流程名称、流程版本、触发方式、触发时间、执行状态六项构成追溯的最小集合,缺任何一项都会导致无法定位到具体某次执行。失败原因、影响范围、处理动作、处理人、复核人、复核结论在执行状态为失败、部分成功或已中止时转为必填,成功执行可以只填处理人留空复核人。
| 字段 | 填写要求 | 说明 |
|---|---|---|
| 执行编号 | 必填 | 唯一标识,追溯的起点 |
| 流程名称 | 必填 | 确定是哪条流程 |
| 流程版本 | 必填 | 区分版本差异导致的结果变化 |
| 触发方式 | 必填 | 判断问题是否与触发来源相关 |
| 触发时间 | 必填 | 与其他系统日志对齐时间线 |
| 执行状态 | 必填 | 决定后续字段是否必填 |
| 步骤结果 | 条件必填 | 失败、部分成功、已中止时必填;成功执行可只记关键步骤 |
| 失败原因 | 条件必填 | 非成功状态必填 |
| 影响范围 | 条件必填 | 非成功状态必填,无影响写“无” |
| 处理动作 | 条件必填 | 非成功状态必填,含处理结果 |
| 处理人 | 条件必填 | 发生人工处理时必填 |
| 复核人 | 选填 | 失败记录和影响较大的执行建议填写 |
| 复核结论 | 选填 | 有复核人时填写 |
| 扩展列 | 选填 | 按流程复杂度决定是否启用 |
流程较简单、只做单步数据同步时,步骤结果可以只记一步,复核人和复核结论可以省略,但执行编号、流程名称、流程版本、触发方式、触发时间、执行状态六项仍需保留。字段确实不适用时,填“不适用”或“无”,不用空白代替,空白无法区分“没填”和“没有”。选填字段一旦在某条记录中填写,后续同类记录应保持同样填法,避免同一字段时而填现象、时而填结论。
填写示例:一次失败执行如何完整记录
以下两条示例使用与前面相同的字段,用于校验模板和说明是否一致。示例中的流程名称、编号和人员均为演示情景。
| 字段 | 失败执行示例 | 成功执行示例 |
|---|---|---|
| 执行编号 | SYNC-20250612-018 | SYNC-20250612-019 |
| 流程名称 | 需求状态同步流程 | 需求状态同步流程 |
| 流程版本 | v2.3 | v2.3 |
| 触发方式 | 事件触发 | 事件触发 |
| 触发时间 | 2025-06-12 14:32 | 2025-06-12 15:10 |
| 执行状态 | 失败 | 成功 |
| 步骤结果 | 读取变更:成功;字段映射:成功;写入目标系统:失败 | 读取变更:成功;字段映射:成功;写入目标系统:成功 |
| 失败原因 | 写入目标系统时接口返回超时,重试两次仍失败,错误码 504 | 无 |
| 影响范围 | 3 条需求状态未同步,涉及需求 REQ-1024、REQ-1025、REQ-1027 | 无 |
| 处理动作 | 确认目标系统恢复后手动重跑该批次,3 条需求状态已同步完成 | 无 |
| 处理人 | 张明 | 李华 |
| 复核人 | 王芳 | — |
| 复核结论 | 通过 | — |
| 扩展列 | 重试次数:2;关联工单:OPS-331 | 重试次数:0 |
失败示例的写法要点有三处:失败原因写到错误码和重试次数,便于判断是偶发超时还是持续故障;影响范围列出具体需求编号和数量,方便核对是否全部补齐;处理动作写清处理前提、动作和结果,让复核人能判断处理是否完整。成功示例采用简写,只保留追溯所需字段和关键步骤结果,非成功状态才必填的字段统一写“无”,复核相关字段用“—”表示未启用。
调整与维护方法:让日志长期可用
执行日志要长期可用,关键是让模板跟着流程版本走,并定期校准字段口径。流程每次发布新版本时,同步检查模板字段是否仍能覆盖新版本的步骤和分支;历史记录保持原样,不因新版本回溯修改。
- 版本同步:流程版本升级时,在流程清单中登记新版本号,并核对执行日志的流程版本取值是否同步更新;旧版本执行记录继续保留原版本号。
- 字段扩展:新增步骤或分支时,优先在扩展列增加对应字段,如“分支条件”“跳过步骤”;新增字段先在字段说明中定义口径,再投入使用。
- 归档周期:按流程重要程度和团队制度确定归档周期,高频流程可按月归档,低频流程可按季度归档;归档时保留原始记录和字段说明的对应版本。
- 定期抽查:每月或每季度抽取一定数量的记录,检查必填字段是否完整、失败原因是否可定位、处理动作是否闭环,抽查结果反馈给流程负责人。
- 口径校准:发现同一字段出现多种写法时,统一到字段说明中的取值约定,并在团队内同步更新后的填法。
当流程运行在研发管理平台中时,执行状态、步骤结果和触发时间等字段可以由系统随工作项状态变化自动写入,人工只需补充失败原因、影响范围和处理动作,复核记录也能与工作项关联保存。ONES 的流程配置与工作项记录可以承载这类执行过程,让日志中的状态与业务对象保持对应;具体字段映射和自动采集范围需按团队实际配置确认。无论使用何种工具,模板、字段说明和示例三处口径保持一致,日志才能在复盘和审计时直接使用。
常见问题
流程执行成功时,失败原因和影响范围还要填吗?
成功执行可以只保留追溯所需字段和关键步骤结果,失败原因、影响范围、处理动作统一写“无”,复核人和复核结论用“—”表示未启用。这样既区分了“没有发生”和“漏填”,也避免成功记录被大量空字段拉长。如果成功执行中出现了跳过步骤或降级处理,建议在扩展列注明,便于后续判断结果是否完整。
同一个流程一天触发很多次,需要每次都单独记一行吗?
建议每次执行单独记一行,执行编号保持唯一,这样失败时能定位到具体批次和具体时间点。如果同一流程高频触发且每次结果一致,可以在团队内约定按批次汇总记录,但汇总记录仍需保留批次内执行次数、时间范围和失败条数,并确保出现异常时能拆回单次执行。汇总口径一旦确定,应在字段说明中写明,避免不同人各记各的。
复核人必须和填写人分开吗?
复核人由非处理人担任,作用是独立判断失败原因是否写清、影响范围是否列全、处理动作是否闭环。流程简单、执行全部成功时可以不设复核,复核人和复核结论留空或用“—”标注。失败记录和影响范围较大的执行建议安排复核,复核结论为“需补充”或“需返工”时,要写明缺什么、改什么,便于处理人补齐后再次复核。
流程改版后,旧日志的字段要不要跟着改?
历史记录保持原样,不因新版本回溯修改。流程版本升级时,在流程清单中登记新版本号,核对执行日志的流程版本取值是否同步更新,旧版本执行记录继续保留原版本号。新增步骤或分支时,优先在扩展列增加对应字段,并先在字段说明中定义口径再投入使用,保证新旧记录可以通过版本号区分。
日志应该保存多久,由谁负责归档?
归档周期按流程重要程度和团队制度确定,高频流程可按月归档,低频流程可按季度归档,保留时长结合团队合规要求设定,本文不给出统一时限。归档时保留原始记录和对应版本的字段说明,指定流程负责人或平台管理员负责执行,并在定期抽查中检查必填字段完整性、失败原因可定位性和处理动作闭环情况。
