SAP物料主数据增强实战：BADI_MATERIAL_CHECK与BADI_MATERIAL_REF应用解析

1. 为什么我们需要对物料主数据进行增强？

如果你在SAP里做过物料主数据的维护，不管是MM01创建还是MM02修改，肯定遇到过这样的场景：业务部门提了一堆“个性化”需求。比如，新建某个特定类型的物料时，工厂字段必须自动带出对应的利润中心；又或者，物料描述里必须包含客户指定的某些关键字，否则就不让保存。这些需求，标准SAP功能往往无法直接满足。

这时候，你就需要用到SAP提供的“增强”手段了。简单来说，增强就是在不修改SAP标准代码的前提下，给标准程序“打补丁”，插入我们自己的业务逻辑。这就像是给一辆出厂的原装汽车加装倒车影像和行车记录仪，功能更强了，但车子的核心框架没动。

在物料主数据这个领域，SAP提供了两个非常经典且实用的增强点（BADI）：BADI_MATERIAL_CHECK和BADI_MATERIAL_REF。前者像个严格的“门卫”，专门负责在保存前检查你输入的数据合不合规；后者则像个贴心的“助手”，在你创建数据时，自动帮你把一些默认值填好。用好这两个BADI，能解决我们日常开发中80%以上的物料主数据定制化需求。我做了这么多年SAP开发，这两个BADI几乎是每个项目都会用到的“常客”，今天我就结合自己的实战经验，带你彻底搞懂它们。

2. 数据校验的“守门员”：BADI_MATERIAL_CHECK详解

2.1 它是什么？什么时候被触发？

你可以把BADI_MATERIAL_CHECK想象成物料主数据保存前的最后一道安检。当你点击MM01、MM02或者MM03（某些情况下）的保存按钮时，在标准系统执行完自身的检查之后，这个BADI的代码就会被调用。它的核心任务就是执行自定义的业务规则校验。如果校验不通过，它可以弹出错误（E）或警告（W）消息，阻止保存或提醒用户。

我举个例子你就明白了。假设公司规定，所有“ZRAW”（原材料）类型的物料，其基本计量单位必须为‘KG’。标准系统可没这个规则。这时，我们就可以在BADI_MATERIAL_CHECK里写一段逻辑：当物料类型等于‘ZRAW’，且基本计量单位不等于‘KG’时，就抛出一个错误消息，让用户无法保存。这样一来，就从系统层面强制规范了数据录入，避免了后续业务（如采购、生产）因数据不规范而出错。

2.2 手把手创建与实施BADI_MATERIAL_CHECK

理论说再多不如动手做一遍。我们从头开始，创建一个BADI_MATERIAL_CHECK的实施。

第一步：进入实施创建界面打开事务码SE19（业务加载项构建器），这是我们操作所有BADI的“大本营”。在初始屏幕，选择“创建实施”，然后在“业务加载项”字段里，输入我们的大名：BADI_MATERIAL_CHECK。回车后，系统会确认这个BADI是否存在。

第二步：给实施起个名字点击创建按钮后，会弹出一个对话框让你输入“实施名称”。这个名字最好遵循你们公司的命名规范，比如ZMM_MATERIAL_CHECK，或者加上业务含义，如Z_CHECK_MAT_TYPE_UNIT。我个人的习惯是名字里能看出用途，这样以后维护起来一目了然。

第三步：深入核心接口方法创建成功后，你就进入了实施的定义界面。这里最关键的是找到接口方法。双击“接口”组件，或者点开左侧树形结构，你会发现一个叫IF_EX_MATERIAL_CHECK的接口，里面只有一个方法：CHECK_DATA。没错，我们所有的校验逻辑，都要写在这个方法里面。双击CHECK_DATA方法，就可以进入ABAP代码编辑器了。

2.3 在CHECK_DATA方法里编写你的校验逻辑

现在来到了最核心的编码环节。CHECK_DATA方法自带了很多输入参数，它们把当前正在保存的物料数据都“打包”送给了我们。常用的有：

• I_MARA：包含了物料通用视图的数据，比如物料号、物料类型、基本计量单位等。
• I_MARC：包含了物料工厂视图的数据，比如采购类型、特殊采购类等。
• I_MBEW：包含了物料评估视图的数据。
• I_MPOP：包含了物料预测视图的数据。
• ... 还有其他很多视图的参数。

我们的逻辑就基于这些输入参数来写。继续用上面的例子，我们来实现“原材料物料类型必须用KG做单位”的校验。

METHOD if_ex_material_check~check_data. " 定义消息变量，用于返回错误或警告 DATA: lv_msgv1 TYPE symsgv. " 示例1：检查原材料物料类型的基本计量单位 IF i_mara-mtart = 'ZRAW' AND i_mara-meins <> 'KG'. " 将物料号放入消息变量，使错误信息更明确 lv_msgv1 = i_mara-matnr. " 调用MESSAGE命令，类型'E'代表错误，会阻止保存 MESSAGE e001(zmm_msg) WITH lv_msgv1 INTO DATA(lv_dummy). " 将消息导出到BADI的返回结构（某些版本可能需要通过C_MESSAGE参数返回） " 这里演示一种常见做法：直接使用MESSAGE语句，BADI会自动捕获。 ENDIF. " 示例2：检查特定工厂下的物料，必须维护采购组 IF i_marc-werks = '1000' AND i_marc-ekgrp IS INITIAL. MESSAGE e002(zmm_msg) WITH i_marc-werks i_mara-matnr. ENDIF. ENDMETHOD.

几个实战中的关键点：

1. 消息类：代码中的zmm_msg需要替换为你自己在SE91创建的消息类。消息文本可以定义为“物料 &1 为原材料，其基本计量单位必须为KG”。
2. 错误与警告：使用MESSAGE e...会直接阻止事务保存。如果只是想提醒用户，可以用MESSAGE w...（警告），用户可以选择忽略继续保存。
3. 性能考虑：CHECK_DATA在每次保存时都会执行，所以里面的代码一定要高效。避免在循环里访问数据库，尽量使用单条查询或缓存。

2.4 实际测试与排坑经验

代码写完了，千万别急着上线。一定要进行充分测试。

测试步骤：

1. 用MM01创建一个物料类型为‘ZRAW’的物料。
2. 在基本视图里，故意把基本计量单位设成‘EA’（个）。
3. 点击保存。这时，你应该立刻看到一个我们自定义的错误消息弹出来，并且保存按钮变灰，事务无法继续。

我踩过的坑：

• 视图判断遗漏：早期有次写校验，只检查了I_MARA的数据，结果用户通过MM02只维护工厂视图时，校验没触发。后来才明白，这个BADI在每个视图保存时都会触发，但传入的参数可能只包含当前正在维护的视图数据。所以写逻辑时，最好先判断一下传入的参数结构是否初始，或者用IS SUPPLIED来判断某个参数是否被传递了值。
• 消息不弹出：有时候消息编号写错了，或者消息类没激活，导致错误逻辑走了，但用户看不到提示，只是保存不了，体验很差。务必用SE91检查好消息配置。
• 与标准检查冲突：你的自定义校验不能和SAP标准校验逻辑矛盾。比如，标准要求物料描述不能为空，你的校验就不能允许它为空。

3. 智能填充的“好帮手”：BADI_MATERIAL_REF解析

3.1 它的职责与触发时机

如果说BADI_MATERIAL_CHECK是保存前的检查官，那么BADI_MATERIAL_REF就是创建时的“智能预填助手”。它的主要用途是：在创建物料主数据（MM01）时，根据一定的业务规则，自动为某些字段提供默认值。

它的触发时机非常明确，就是在你输入物料号、行业领域和物料类型，按回车进入物料创建界面的那一刻。此时，各个标签页的屏幕字段还是空的，系统会调用这个BADI，让你有机会在用户看到屏幕之前，就把一些值填进去。这对于提升用户体验、确保数据规范非常有用。比如，根据输入的工厂自动带出利润中心，根据物料类型自动决定采购类型，或者为某些分类视图的字段设定默认值。

3.2 创建与实施BADI_MATERIAL_REF

创建过程和BADI_MATERIAL_CHECK非常相似。

1. 事务码SE19，创建实施。
2. 输入业务加载项名称：BADI_MATERIAL_REF。
3. 赋予实施一个名字，例如ZMM_MATERIAL_DEFAULT。
4. 查看其接口IF_EX_MATERIAL_REFERENCE，你会发现它有几个方法，最常用的是CREATE_MATERIAL。我们主要在这个方法里写逻辑。

3.3 深入CREATE_MATERIAL方法：赋值与传递的艺术

打开CREATE_MATERIAL方法，你会看到两套参数：一套以I_开头（Input），是系统传入的、用户已经输入或系统默认的少量初始值；另一套以E_开头（Output），是我们需要赋值的、最终要传递到创建屏幕上的字段结构。

这里有一个极其重要的注意事项，也是新手最容易栽跟头的地方：对于你想设置默认值的那个视图，必须先将整个I_结构的内容复制（MOVE-CORRESPONDING）到对应的E_结构，然后再去修改E_结构中具体的字段。如果你不先复制，那么该视图下其他你没赋值的字段，在创建屏幕上就会变成空值，这可能会覆盖掉系统原本的默认值，导致数据错误。

我们来看一个比原始文章更丰富的例子。需求是：当用户在“工厂”视图输入一个特定工厂（如‘1000’）时，自动带出该工厂对应的利润中心，并且自动将“采购类型”设置为“外部采购（F）”。

METHOD if_ex_material_reference~create_material. " 定义本地数据结构 DATA: ls_plant_config TYPE ztplant_config, " 假设的自定义工厂配置表 lv_purch_type TYPE bwart. " --- 处理工厂视图 (MARC) --- " 关键一步：先将输入结构复制到输出结构 MOVE-CORRESPONDING i_marc TO e_marc. " 判断用户是否已输入工厂 IF i_marc-werks IS NOT INITIAL. " 根据工厂从自定义配置表获取利润中心 SELECT SINGLE * INTO ls_plant_config FROM ztplant_config WHERE werks = i_marc-werks. IF sy-subrc = 0. e_marc-prctr = ls_plant_config-profit_center. " 赋值利润中心 ENDIF. " 同时，根据工厂设置采购类型 CASE i_marc-werks. WHEN '1000' OR '1100'. lv_purch_type = 'F'. " 外部采购 WHEN '2000'. lv_purch_type = 'E'. " 内部采购 WHEN OTHERS. lv_purch_type = i_marc-beskz. " 保持原输入或系统默认 ENDCASE. e_marc-beskz = lv_purch_type. ENDIF. " --- 处理采购视图 (MARC-EKGRP 也可在此处理) --- " 如果你想基于物料类型设置默认采购组 IF i_mara-mtart = 'ZHLB' AND e_marc-ekgrp IS INITIAL. " 注意这里判断e_marc e_marc-ekgrp = '001'. ENDIF. " --- 处理通用物料数据 (MARA) --- " 同样需要先复制 MOVE-CORRESPONDING i_mara TO e_mara. " 例如：为特定物料类型设置默认的税分类 IF i_mara-mtart = 'ZFER'. e_mara-taxm1 = '1'. " 标准税率 ENDIF. ENDMETHOD.

3.4 高级应用与性能优化

在实际复杂项目中，BADI_MATERIAL_REF的应用可以更精细。

1. 视图控制：CREATE_MATERIAL方法提供了C_VIEW参数，它告诉你当前正在处理的是哪个视图（比如‘MARA’， ‘MARC’）。你可以利用这个参数，将不同视图的默认值逻辑封装在不同的代码块里，使结构更清晰。虽然系统会为所有视图调用该方法，但通过C_VIEW判断可以避免执行不必要的逻辑。

2. 开关控制：像原始文章示例里提到的ZTSD113表，这是一个非常好的实践。我们通常称它为“增强开关表”或“配置表”。在方法开始时，先去这个表里查一下当前增强是否被激活。这样，当业务需求变化或者某个功能需要临时关闭时，我们不需要修改代码、走传输流程，只需要在配置表里将对应的条目置为无效即可，运维灵活性大大提升。

3. 性能至关重要：这个方法在每次创建物料时都会为每个视图调用。如果你的逻辑里涉及到多次查询数据库，尤其是循环查询，会对性能造成明显影响。我的经验是：

• 使用缓存：对于不常变的基础数据（如工厂-利润中心对照），可以查询一次后缓存到全局内存或应用服务器缓存中。
• 批量读取：如果需要根据一批工厂获取配置，尽量使用FOR ALL ENTRIES IN进行批量查询，而不是在循环内SELECT SINGLE。
• 精简逻辑：只处理必要的字段和视图。

4. CHECK与REF的联合实战与进阶思考

4.1 场景串联：一个完整的业务流

让我们设计一个连贯的业务场景，把两个BADI用起来：业务需求：公司规定，编码以‘PACK-’开头的包装材料（物料类型‘ZPACK’），必须由工厂‘2000’生产，且其生产仓储地点固定为‘0001’。

实现方案：

1. 使用 BADI_MATERIAL_REF：在CREATE_MATERIAL方法中，判断如果I_MARA-MTART = ‘ZPACK’，则自动将E_MARC-WERKS默认设置为‘2000’，并将E_MARC-LGORT（如果是生产相关的）默认设置为‘0001’。这样用户创建这类物料时，工厂和仓储地点已经自动填好，减少了输入工作和出错可能。
2. 使用 BADI_MATERIAL_CHECK：在CHECK_DATA方法中，进行强制校验。判断如果I_MARA-MTART = ‘ZPACK’，那么必须满足两个条件：I_MARC-WERKS必须等于‘2000’，并且I_MARC-LGORT必须等于‘0001’。如果不满足，则抛出错误。这样，即使用户手动修改了默认值，或者通过其他方式（如批量导入）创建数据，最终保存时也会被拦截。

这两个BADI一前一后，形成了“默认值推荐”加“强制规则校验”的双保险，确保了业务规则的严格执行。

4.2 调试技巧：如何精准定位问题

当你写的增强不生效或者报错时，调试是唯一的出路。

• BADI_MATERIAL_CHECK：直接在CHECK_DATA方法里打上外部断点（在SE19实施的方法代码行左侧点击设置断点）。然后去前台执行MM01/MM02，输入数据点击保存，程序就会自动跳转到调试器。
• BADI_MATERIAL_REF：在CREATE_MATERIAL方法里打外部断点。然后去前台执行MM01，输入物料号、行业领域、物料类型后按回车，程序会在进入创建界面之前停住。

调试时，重点关注：

1. 传入的I_参数值是否符合你的预期？
2. 你的条件判断语句（IF）是否走入了正确的分支？
3. 给E_参数的赋值是否成功？
4. 是否有异常被抛出？

4.3 与其它增强方式的对比

除了BADI，SAP物料主数据还有其他增强方式，比如用户出口（User Exit）和增强点（Enhancement Spot）。

• 用户出口（如MM06E005）：这是更早期的增强技术，需要在标准程序的固定子程序中编写代码。功能可能更底层，但灵活性和可维护性通常不如BADI。BADI是面向对象的，定义更清晰，实施更独立。
• 隐式增强点：可以直接在标准SAP函数组或Include程序中插入代码。这种方式非常强大直接，但风险也高，因为如果你插入代码的位置不对，或者SAP版本升级修改了标准代码，你的增强可能会失效或引发错误。BADI是SAP官方定义的接口，升级兼容性更有保障。

我的建议是：优先使用BADI。只有当BADI无法满足需求（比如你需要增强的时点或数据BADI没有暴露）时，再去考虑用户出口或隐式增强。BADI_MATERIAL_CHECK和BADI_MATERIAL_REF已经覆盖了物料主数据维护中最关键的两个环节。

4.4 权限与异常处理

最后，别忘了考虑权限和异常。

• 权限：你的增强逻辑理论上不应该绕过SAP的权限检查。例如，你不能在BADI里给一个没有利润中心维护权限的用户自动填一个利润中心然后让他保存成功。通常，系统会在后续的标准流程中进行权限校验。
• 异常处理：在BADI_MATERIAL_REF的数据库查询中，要做好异常处理（TRY...CATCH或检查SY-SUBRC），避免因为配置表数据缺失导致程序转储。在BADI_MATERIAL_CHECK中，也要确保校验逻辑的健壮性，不要因为某个字段意外为空而导致条件判断出错。

这两个BADI是SAP ABAP开发者工具箱里的利器。理解它们的触发时机、掌握参数传递的要点、写出高效健壮的代码，就能轻松应对物料主数据维护中各种复杂的定制化需求。多动手实践，多思考业务场景，你会发现它们能组合出非常多巧妙的解决方案。