SAP-ABAP：SAP基础数据校验工具开发系列博客（共5篇）第三篇：SAP接口对接开发：实现数据的实时/批量校验交互

SAP基础数据校验工具开发系列博客（共5篇）

第三篇：SAP接口对接开发：实现数据的实时/批量校验交互

校验引擎和规则配置搭建完成后，工具需要与SAP系统以及可能的第三方系统进行数据交互。业务场景多种多样：在物料主数据保存时实时校验并拦截错误；在数据批量导入时异步校验并反馈结果；甚至外部数据治理平台通过API调用校验服务。本文详解工具与SAP系统的三种主流对接方案：RFC函数调用 （实时同步）、OData接口 （实时/外部调用）、IDoc（批量异步），并分享接口容错、异常重试、数据一致性保障的实践方案，确保工具在各类业务场景下稳定、可靠地提供校验服务。

---

一、对接场景分析

根据数据量、实时性要求的不同，主数据校验工具需要支持以下三种对接模式：

对接模式	适用场景	数据量	实时性	典型触发方式
实时同步校验（RFC）	前台业务操作（MM01/XD01等）保存前	单条	高（毫秒级）	SAP增强/BADI调用
实时外部校验（OData）	外部MDM系统、ESB总线调用	单条或少量	中（秒级）	HTTP请求
批量异步校验（IDoc）	定时批量同步主数据、接口导入	成百上千条	低（分钟级）	后台作业、文件触发

三种模式可以共存，工具根据调用方式自动适配。

---

二、方案一：RFC函数调用（实时同步校验）

2.1 适用场景

• 在SAP标准事务码（如MM01创建物料、XD01创建客户）保存时，调用校验工具进行实时检查。
• 用户点击保存后，系统先执行校验，若失败则提示并阻止保存，成功则继续。

2.2 开发步骤

步骤1：创建RFC函数模块

事务码SE37，创建函数模块ZMD_CHECK_MATERIAL，属性设置为"远程启用"（Remote-Enabled）。

FUNCTION ZMD_CHECK_MATERIAL.
*"----------------------------------------------------------------------
*"*"局部接口：
*"  IMPORTING
*"     VALUE(IV_MATNR) TYPE  MATNR
*"  EXPORTING
*"     VALUE(EV_FAILED) TYPE  FLAG
*"     VALUE(ET_MESSAGES) TYPE  ZMD_T_MESSAGE
*"----------------------------------------------------------------------

  " 调用校验引擎（内部FORM）
  PERFORM execute_rule_engine USING iv_matnr
                             CHANGING ev_failed et_messages.
ENDFUNCTION.

步骤2：在业务保存出口中调用RFC函数

以物料主数据为例，在BADI MATERIAL_SAVE 或 MGA_BADI 的SAVE方法中，添加调用逻辑。

METHOD save.
  DATA: lv_failed TYPE flag,
        lt_messages TYPE TABLE OF zmd_message.

  CALL FUNCTION 'ZMD_CHECK_MATERIAL'
    DESTINATION 'NONE'          " 本地调用，非RFC远程
    EXPORTING
      iv_matnr = ls_mara-matnr
    IMPORTING
      ev_failed = lv_failed
      et_messages = lt_messages.

  IF lv_failed = 'X'.
    LOOP AT lt_messages INTO DATA(ls_msg).
      MESSAGE ls_msg-msg TYPE 'E' DISPLAY LIKE 'E'.
    ENDLOOP.
  ENDIF.
ENDMETHOD.

注意 ：在增强中调用时，建议使用本地调用（DESTINATION 'NONE'），避免网络开销。若工具部署在独立系统，则需配置RFC目标。

2.3 容错与重试

实时同步校验对响应时间敏感，应避免长时间等待。建议：

• 设置超时限制（如3秒），超时后默认放行并记录日志。
• 发生通信故障时，捕捉异常并友好提示用户稍后重试。

TRY.
    CALL FUNCTION 'ZMD_CHECK_MATERIAL'
      DESTINATION lv_rfc_dest
      ...
    CATCH cx_sy_native_call_error INTO DATA(lx_ex).
      MESSAGE '校验服务暂时不可用，请稍后重试' TYPE 'W'.
      ev_failed = abap_false.   " 降级：允许保存
      " 记录异常日志
      PERFORM write_error_log.
ENDTRY.

---

三、方案二：OData接口（实时/外部调用）

3.1 适用场景

• 外部主数据管理系统（MDM）通过RESTful API调用校验服务。
• SAP UI5/Fiori应用前端直接调用校验接口。
• 微服务架构中的轻量级交互。

3.2 开发步骤

步骤1：创建OData服务（事务码SEGW）

1. 创建项目ZMD_CHECK_SRV。
2. 定义实体类型MaterialCheck，包含输入参数Matnr，输出属性Failed、Messages。
3. 实现GET_ENTITY方法（或CREATE方法用于POST请求）。

步骤2：在服务实现中调用校验引擎

METHOD materialcheck_get_entity.
  DATA: lv_failed TYPE flag,
        lt_messages TYPE TABLE OF zmd_message.

  " 从请求中获取物料号
  DATA(lv_matnr) = it_key_values[ KEY_NAME = 'Matnr' ]-value.

  " 调用校验引擎
  CALL FUNCTION 'ZMD_CHECK_MATERIAL_INTERNAL'
    EXPORTING
      iv_matnr = lv_matnr
    IMPORTING
      ev_failed = lv_failed
      et_messages = lt_messages.

  " 填充输出结构
  er_entity-matnr = lv_matnr.
  er_entity-failed = lv_failed.
  er_entity-messages = lt_messages.
ENDMETHOD.

步骤3：注册并激活OData服务

使用事务码/IWFND/MAINT_SERVICE激活服务。

步骤4：外部系统调用示例（HTTP）

GET /sap/opu/odata/sap/ZMD_CHECK_SRV/MaterialCheckSet(Matnr='000000000010000321')

响应格式（JSON）：

{
  "Matnr": "000000000010000321",
  "Failed": true,
  "Messages": [
    { "Msg": "物料号长度应为18，当前为15" }
  ]
}

3.3 容错与性能

• OData服务默认支持分页、过滤，批量校验时可利用$batch请求。
• 设置服务超时参数（/IWFND/CONF）。
• 使用缓存（如/IWBEP/CACHE）暂存校验结果，避免短时间内重复校验同一物料。

---

四、方案三：IDoc批量数据同步校验

4.1 适用场景

• 从外部系统定期批量导入主数据（如MDM每晚推送物料主数据变更）。
• 需要异步处理，处理结果通过IDoc状态或邮件通知。

4.2 开发步骤

步骤1：定义IDoc类型

事务码WE30，创建IDoc类型ZMD_CHECK_RESULT，包含以下段：

• 控制段（E1ZMDCTL）：发送方、接收方、时间戳。
• 数据段（E1ZMDDAT）：包含物料号、校验是否通过、错误消息列表（多个行）。

步骤2：创建出站处理函数

事务码WE42，创建IDoc出站处理函数ZMD_IDOC_OUTBOUND。在函数中编写逻辑：接收外部系统发来的IDoc，解析物料清单，调用校验引擎，生成结果IDoc发回。

FUNCTION ZMD_IDOC_OUTBOUND.
  DATA: lt_idoc_ctl TYPE TABLE OF edidc,
        lt_idoc_data TYPE TABLE OF edidd,
        ls_idoc_ctl LIKE LINE OF lt_idoc_ctl.

  " 解析传入的IDoc
  CALL FUNCTION 'IDOC_INBOUND_READ'
    EXPORTING
      idoc_number = lv_idoc_num
    TABLES
      idoc_contrl = lt_idoc_ctl
      idoc_data   = lt_idoc_data.

  " 循环处理每个物料
  LOOP AT lt_idoc_data INTO ls_data WHERE segnam = 'E1ZMDDAT'.
    " 调用校验引擎
    PERFORM check_single_material USING ls_data-matnr
                              CHANGING lv_failed lt_msgs.
    " 生成结果记录
    ls_result-matnr = ls_data-matnr.
    ls_result-failed = lv_failed.
    ls_result-msg = lt_msgs.
    APPEND ls_result TO lt_results.
  ENDLOOP.

  " 构建结果IDoc
  PERFORM build_result_idoc USING lt_results
                             CHANGING lt_result_idoc_data.

  " 发送结果IDoc
  CALL FUNCTION 'IDOC_OUTBOUND_WRITE'
    EXPORTING
      idoc_control = ls_result_ctl
    TABLES
      idoc_data    = lt_result_idoc_data.
ENDFUNCTION.

步骤3：配置端口和合作伙伴

事务码WE20，定义合作伙伴（如外部系统ID），配置出站IDoc类型和函数。

4.3 容错与重试

• 幂等性设计：每个IDoc携带唯一事务ID，校验工具需记录已处理的IDoc，避免重复处理。
• 重试机制 ：若校验过程中发生临时性错误（如数据库锁），可使用WAIT并重试3次，仍失败则返回错误状态，触发IDoc重传。
• 监控与告警 ：事务码WE05查看IDoc状态，失败IDoc自动发送邮件通知管理员。

---

五、数据一致性保障

5.1 实时校验与业务事务的一致性

在SAP增强中调用校验时，如果校验通过，但后续业务保存失败（例如用户取消保存），则校验工具不应记录任何日志（因为数据未持久化）。因此，校验逻辑中只做只读检查 ，不写入校验结果表。只有最终数据成功落库后，才通过异步方式记录校验历史。

5.2 批量校验的幂等性

批量校验（IDoc或后台作业）可能因网络重传导致同一批数据被多次处理。解决方案：

• 在规则引擎执行前，根据业务主键+批次号查询日志表，已处理过则跳过。
• 写入结果日志时使用INSERT ... ON DUPLICATE KEY UPDATE（如果是HANA数据库）或先SELECT再UPDATE/INSERT。

5.3 分布式事务

工具与SAP业务操作通常在同一数据库（同一系统），无需额外分布式事务。若校验工具部署在独立微服务（例如基于OData的云服务），则需通过补偿事务或最终一致性模式处理。

---

六、三种方案对比与选型建议

方案	优点	缺点	最佳实践
RFC	原生支持，调用简单，同步实时	依赖RFC目标配置，不适合大批量	用于SAP增强内实时校验
OData	跨平台，标准RESTful，便于前端/外部系统	需要额外配置网关服务，性能略低于RFC	用于外部系统调用、Fiori应用
IDoc	异步可靠，支持批量，自带重试和监控	配置复杂，实时性差	用于夜间批量数据同步或大文件导入

综合建议：

• 内部SAP模块之间交互 → RFC。
• 外部非SAP系统调用 → OData。
• 批量数据同步 → IDoc。

---

七、总结

本文介绍了SAP主数据校验工具的三种接口对接方案：RFC（实时同步）、OData（实时跨平台）、IDoc（批量异步）。每种方案都给出了开发步骤和关键代码示例，并分享了接口容错（超时处理、降级策略）、异常重试（指数退避、消息重传）以及数据一致性（幂等性、最终一致）的实践方案。

通过合理选择和组合这些接口，校验工具可以无缝嵌入到各种业务场景中，无论是前台操作、后台批量还是外部系统集成，都能提供可靠的数据质量保障。

下一篇将探讨可视化校验结果输出与问题闭环流程实现，让用户直观看到错误详情并跟踪整改过程。

💬 你在实际项目中用过哪种接口方式？遇到过哪些性能或数据一致性挑战？欢迎留言交流。

作者 ：你的SAP学习伙伴

版本记录：2026年6月