跳到主要内容

系统数据读取和保存

概述​

为满足客户在数据同步过程中的自定义场景的去重需求，安捷云本地部署2.0.9版本新增了日志读取 与日志设置 功能。通过将流程执行日志持久化存储与查询，用户可有效识别已处理数据，避免重复推送，保障数据一致性。

一、日志读取​

功能描述​

读取当前流程中已存储的日志记录，用于判断指定数据是否已被处理。

核心参数说明​

参数名说明
数据唯一标识用于查询日志的关键标识，通常为数据编码或ID。

输出数据​

参数名说明
data对账日志的详情。
success对应唯一标识的数据是否已经成功写入到目标系统。

日志读取界面
Preview

二、日志设置​

功能描述​

将当前流程的执行日志存储至系统，用于记录数据写入状态，并支持后续查询与去重。

核心参数说明​

参数名说明
数据唯一标识当前流程中存储日志的唯一标识，同一标识仅保留一条日志，重复存储时执行更新操作。
目标系统标识数据成功写入目标系统后返回的标识，可用于系统间对账。
状态码执行结果标识，0 表示成功，其他值为失败，可根据业务扩展。
错误信息数据写入失败时的详细错误描述。
汇总ID列表若原始数据经过汇总处理，可在此记录关联的汇总ID，便于后续跟踪。

日志设置界面
Preview

三、典型应用场景​

场景描述：ERP基础档案同步至OA系统​

客户需将ERP中的基础档案信息按修改时间增量推送到OA系统，并要求实现数据去重，避免重复推送。

流程步骤​

  1. 定时执行 ：流程按设定频率自动触发。
  2. 查询ERP数据 ：根据修改时间获取增量数据。
  3. 数据格式转换 ：将ERP数据转换为OA系统可接收的格式。
  4. 循环处理每条数据 ：
    • 调用 日志读取 ，传入数据唯一标识（如编码或ID）
    • 若success = true，则结束当前条目的处理
    • 若success = false，则：
      a. 调用OA接口写入数据
      b. 写入成功后，调用 日志设置 ，记录该数据的唯一标识、目标系统标识、成功状态等
  5. 流程结束 ，等待下一次定时执行。

场景价值​

  • 防重复 ：通过日志判断是否已处理，确保数据不重复推送
  • 可追溯 ：完整记录同步状态，便于对账与排查问题
  • 灵活可控 ：用户可自定义状态码与错误处理逻辑

四、注意事项​

  1. 唯一标识应确保在业务维度内唯一且稳定（如使用数据ID或编码组合）。
  2. 建议在写入目标系统成功后再记录日志，避免日志与真实执行结果不一致。
  3. 可结合“汇总ID列表”字段处理批量或聚合数据场景。

如有疑问或需进一步配置支持，请联系安捷云技术支持团队。