流程自动化执行日志模板:字段、填写规范与示例

流程自动化执行日志按“一次执行一条记录”填写,用来还原某次流程为什么触发、走到哪一步、失败在哪里、由谁处理。本文提供一张可直接复制的空白表,并逐项说明字段口径、必填与选填的划分、失败与成功两条填写示例,以及流程版本变化后的维护方法,方便团队统一记录方式。



要点总览(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 的流程配置与工作项记录可以承载这类执行过程,让日志中的状态与业务对象保持对应;具体字段映射和自动采集范围需按团队实际配置确认。无论使用何种工具,模板、字段说明和示例三处口径保持一致,日志才能在复盘和审计时直接使用。



常见问题


流程执行成功时,失败原因和影响范围还要填吗?


成功执行可以只保留追溯所需字段和关键步骤结果,失败原因、影响范围、处理动作统一写“无”,复核人和复核结论用“—”表示未启用。这样既区分了“没有发生”和“漏填”,也避免成功记录被大量空字段拉长。如果成功执行中出现了跳过步骤或降级处理,建议在扩展列注明,便于后续判断结果是否完整。


同一个流程一天触发很多次,需要每次都单独记一行吗?


建议每次执行单独记一行,执行编号保持唯一,这样失败时能定位到具体批次和具体时间点。如果同一流程高频触发且每次结果一致,可以在团队内约定按批次汇总记录,但汇总记录仍需保留批次内执行次数、时间范围和失败条数,并确保出现异常时能拆回单次执行。汇总口径一旦确定,应在字段说明中写明,避免不同人各记各的。


复核人必须和填写人分开吗?


复核人由非处理人担任,作用是独立判断失败原因是否写清、影响范围是否列全、处理动作是否闭环。流程简单、执行全部成功时可以不设复核,复核人和复核结论留空或用“—”标注。失败记录和影响范围较大的执行建议安排复核,复核结论为“需补充”或“需返工”时,要写明缺什么、改什么,便于处理人补齐后再次复核。


流程改版后,旧日志的字段要不要跟着改?


历史记录保持原样,不因新版本回溯修改。流程版本升级时,在流程清单中登记新版本号,核对执行日志的流程版本取值是否同步更新,旧版本执行记录继续保留原版本号。新增步骤或分支时,优先在扩展列增加对应字段,并先在字段说明中定义口径再投入使用,保证新旧记录可以通过版本号区分。


日志应该保存多久,由谁负责归档?


归档周期按流程重要程度和团队制度确定,高频流程可按月归档,低频流程可按季度归档,保留时长结合团队合规要求设定,本文不给出统一时限。归档时保留原始记录和对应版本的字段说明,指定流程负责人或平台管理员负责执行,并在定期抽查中检查必填字段完整性、失败原因可定位性和处理动作闭环情况。