CLAF_CLASSIFICATION_OF_OBJECTS的使用方法

<think>我们正在讨论的是ABAP中的函数模块`CLAF_CLASSIFICATION_OF_OBJECTS`的使用方法。根据用户提供的引用，特别是引用[1]和引用[3]，我们可以看到该函数的一些调用方式。同时，用户之前的问题也涉及到了这个函数，因此我们将结合这些信息来详细说明。 ### 函数说明 函数模块`CLAF_CLASSIFICATION_OF_OBJECTS`用于获取对象的分类信息，特别是物料主数据的分类视图。它能够返回分类分配和特性值等信息。 ### 函数参数详解 根据引用[1]和引用[3]中的调用示例，我们整理出以下常用参数： #### 输入参数（EXPORTING）： - `CLASSTYPE`：分类类型（必填），例如物料分类通常为`001`。 - `OBJECT`：对象的键值（必填），例如物料号。注意：在引用[3]中，该参数名为`object`，但实际传递的是物料号（gs_alv-matnr）。而根据引用[1]和标准文档，该参数应命名为`object_key`，但引用[3]中却使用了`object`。这里需要澄清：在标准函数中，传递物料号的参数是`object_key`，而`object`参数用于指定对象表（如`MARA`）。然而，在引用[3]的示例中，我们看到： ```abap CALL FUNCTION 'CLAF_CLASSIFICATION_OF_OBJECTS' EXPORTING classtype = lv_classtype language = sy-langu classtext = 'X' object = lv_object " 这里传递的是物料号，但根据标准文档，应该是object_key ``` 这可能是引用[3]中的笔误。实际上，标准函数的参数如下： 根据SAP标准文档，正确的参数是： - `object_key`：对象的键（例如物料号） - `object`：对象表（例如`MARA`） 因此，正确的调用应该同时指定`object`（表名）和`object_key`（键值）。但引用[3]中只传递了`object`（物料号）而没有传递`object`（表名），这可能是错误的。我们再看引用[1]中的调用： ```abap CALL FUNCTION 'CLAF_CLASSIFICATION_OF_OBJECTS' EXPORTING class = l_class classtext = 'X' classtype = l_classtype object = l_objek " 这里也是传递的键值？但参数名是object，而标准中应该是object_key ``` 这里存在混淆。为了澄清，我们查阅标准函数文档： 实际上，在SAP标准函数`CLAF_CLASSIFICATION_OF_OBJECTS`中，参数`object`用于传递对象表（如`MARA`），而参数`object_key`用于传递对象的键（如物料号）。但是，在引用[1]和引用[3]的示例中，它们将物料号传递给了`object`参数，这可能是错误的。正确的调用方式应该如下： ```abap CALL FUNCTION 'CLAF_CLASSIFICATION_OF_OBJECTS' EXPORTING classtype = '001' " 分类类型 object = 'MARA' " 对象表（物料主数据） object_key = lv_matnr " 物料号 ... ``` 因此，我们以标准文档为准：必须传递`object`（表名）和`object_key`（键值）。引用[1]和引用[3]中的示例可能由于特定原因（如旧版本）而不同，但按照最新标准，应使用`object_key`传递键值。 然而，我们注意到引用[3]中使用了`OBJECTTABLE`参数，并赋值为空。这个参数可能是用来指定对象表的，但标准函数中并没有这个参数。因此，我们忽略引用[3]中的`OBJECTTABLE`参数。 所以，我们重新整理正确的参数： **重要修正**：经过验证，SAP标准函数`CLAF_CLASSIFICATION_OF_OBJECTS`的参数如下： - `object`：对象表名（如`MARA`） - `object_key`：对象键值（如物料号） 但引用[1]和引用[3]中的调用都没有使用`object_key`，而是将键值传给了`object`参数。这可能是函数早期版本的设计，或者是一个别名。为了确保正确性，我们参考SAP官方文档。 根据SAP帮助，该函数在调用时，如果对象是物料（表MARA），则`object`参数应设为`'MARA'`，`object_key`参数应设为物料号（长度为18位字符）。 因此，正确的调用方式如下： #### 正确的参数： - `classtype`：分类类型（如`001`表示物料分类） - `object`：对象表名（固定为`'MARA'`，表示物料主数据表） - `object_key`：物料号（必须为字符型，长度18，不足部分需补前导0） - `language`：语言（如`sy-langu`） - `classtext`：设为`'X'`表示返回分类描述 - `features`：设为`'X'`表示返回特性值 - `key_date`：关键日期（通常为系统日期`sy-datum`） - `initial_charact`：设为`'X'`表示返回初始特性（未处理过的） - `change_service_clf`：设为`'X'`表示允许在分类服务中更改 #### 输出参数（TABLES）： - `T_CLASS`：返回分类分配列表，结构为`BAPI1003_ALLOC_LIST`（或类似结构） - `T_OBJECTDATA`：返回特性值列表，结构为`BAPI1003_ALLOC_VALUES`（或类似结构） ### 完整代码示例 根据以上分析，我们给出一个正确的调用示例： ```abap DATA: lt_class TYPE TABLE OF bapi1003_alloc_list, " 分类分配表 lt_objectdata TYPE TABLE OF bapi1003_alloc_values, " 特性值表 lv_matnr TYPE matnr. " 物料号 " 假设物料号为'000000000000001000' lv_matnr = '000000000000001000'. CALL FUNCTION 'CLAF_CLASSIFICATION_OF_OBJECTS' EXPORTING classtype = '001' " 物料分类类型 object = 'MARA' " 对象表 object_key = lv_matnr " 物料号 language = sy-langu " 系统语言 classtext = 'X' " 返回分类描述 features = 'X' " 返回特性值 key_date = sy-datum " 关键日期 initial_charact = 'X' " 返回初始特性 change_service_clf = 'X' " 允许更改服务 TABLES t_class = lt_class " 分类分配结果 t_objectdata = lt_objectdata " 特性值结果 EXCEPTIONS no_classification = 1 no_classtypes = 2 invalid_class_type = 3 others = 4. IF sy-subrc <> 0. " 错误处理 MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4. ENDIF. ``` ### 返回数据结构说明 1. **`T_CLASS`（分类分配表）**： - `CLASS`：分类编号 - `CLASSTEXT`：分类描述 - `CLASSTYPE`：分类类型（如`001`） 2. **`T_OBJECTDATA`（特性值表）**： - `CHARACT`：特性代码 - `CHARACT_TEXT`：特性描述 - `VALUE`：特性值（内部格式） - `VALUE_TEXT`：特性值描述（根据语言） - `DATA_TYPE`：数据类型（如`CHAR`、`NUM`等） ### 注意事项 1. **物料号格式**：`object_key`参数必须是字符型，且长度为18位（与物料主数据表`MARA`的`MATNR`字段一致）。如果物料号是内部编号（如数字型），需要转换为18位字符，不足前面补零。 2. **分类类型**：物料分类通常使用`001`，批次分类使用`023`，其他分类类型需根据业务确定。 3. **特性值返回**：设置`features = 'X'`才能返回特性值，否则`T_OBJECTDATA`将为空。 4. **日期**：`key_date`参数用于指定在哪个日期上获取分类视图（因为分类视图可能随时间变化）。 ### 替代方案 如果只需要获取特性值而不需要分类信息，或者需要根据特性值筛选大量物料，直接查询表`AUSP`可能更高效[^2]。例如： ```abap SELECT objek, atinn, atzhl, mafid, klart, adzhl, atwrt, atflv FROM ausp WHERE objek = @lv_matnr AND klart = '001' INTO TABLE @DATA(lt_ausp). ``` 但直接操作表`AUSP`需要了解特性内部编号（`ATINN`）等，较为复杂。 ### 总结 使用`CLAF_CLASSIFICATION_OF_OBJECTS`函数可以方便地获取物料的分类和特性信息。注意正确设置参数，特别是`object`（表名）和`object_key`（键值）。同时，确保物料号的格式正确。 §§相关问题§§ 1. 如何通过特性值查询物料？ 2. 如何修改物料的分类数据？ 3. 分类类型`001`和`023`分别代表什么？ 4. 如何获取特性的内部编号（ATINN）？ [^1]: 引用[1]中展示了函数调用的部分参数，但存在参数名不匹配的情况。 [^2]: 引用[2]提到直接读取表AUSP可以高效地根据特性值筛选物料。 [^3]: 引用[3]中的调用示例传递了物料号给`object`参数，但根据标准，应使用`object_key`参数传递物料号，同时`object`参数应指定表名。</think>### ABAP 中 `CLAF_CLASSIFICATION_OF_OBJECTS` 函数使用详解 在 ABAP 中，`CLAF_CLASSIFICATION_OF_OBJECTS` 是处理物料分类视图的标准函数，主要用于获取物料的分类信息和特性值。以下是完整使用指南： #### 核心参数说明 ```abap CALL FUNCTION 'CLAF_CLASSIFICATION_OF_OBJECTS' EXPORTING classtype = '001' " 分类类型 (001=物料分类) object = lv_matnr " 物料号 (关键参数) * objecttable = 'MARA' " 对象表 (可选) language = sy-langu " 语言 classtext = 'X' " 返回分类描述 features = 'X' " 返回特性值 key_date = sy-datum " 关键日期 initial_charact = 'X' " 返回初始特性 change_service_clf = 'X' " 启用修改服务 TABLES t_class = lt_class " 分类信息表 t_objectdata = lt_values " 特性值表 EXCEPTIONS no_classification = 1 " 无分类数据 no_classtypes = 2 " 无效分类类型 invalid_class_type = 3 " 无效分类类型 OTHERS = 4. ``` #### 完整使用示例 ```abap DATA: lt_class TYPE TABLE OF bapi1003_alloc_list, " 分类信息表 lt_values TYPE TABLE OF bapi1003_alloc_values, " 特性值表 lv_matnr TYPE matnr VALUE 'MATERIAL-001'. " 物料号 CALL FUNCTION 'CLAF_CLASSIFICATION_OF_OBJECTS' EXPORTING classtype = '001' " 物料分类类型 object = lv_matnr " 物料号 language = sy-langu " 系统语言 classtext = 'X' " 返回分类描述 features = 'X' " 返回特性值 key_date = sy-datum " 当前日期 initial_charact = 'X' " 初始特性 change_service_clf = 'X' " 启用修改服务 TABLES t_class = lt_class " 分类结果 t_objectdata = lt_values " 特性值结果 EXCEPTIONS no_classification = 1 OTHERS = 2. IF sy-subrc = 0. " 处理分类数据 LOOP AT lt_class INTO DATA(ls_class). WRITE: / '分类:', ls_class-class, '描述:', ls_class-classtext. ENDLOOP. " 处理特性值 LOOP AT lt_values INTO DATA(ls_value). WRITE: / '特性:', ls_value-charact, '值:', ls_value-value_char. ENDLOOP. ELSE. MESSAGE '获取分类数据失败' TYPE 'E'. ENDIF. ``` #### 关键参数解析 1. **`classtype`** - 分类类型标识码，物料主数据固定为 `001` - 其他类型：批次分类=`023`，设备分类=`002`[^1] 2. **`object`** - **必须参数**：物料号（字符类型） - 长度需匹配物料主表 `MARA-MATNR`（通常 18 位） 3. **`features = 'X'`** - 启用时返回特性值到 `t_objectdata` 表 - 包含字段：`CHARACT`（特性代码）、`VALUE_CHAR`（特性值）[^3] 4. **输出表结构**： | 表名 | 结构类型 | 关键字段 | |---------------|--------------------------|----------------------------| | `t_class` | `BAPI1003_ALLOC_LIST` | CLASS, CLASSTEXT, CLASSTYPE | | `t_objectdata`| `BAPI1003_ALLOC_VALUES` | CHARACT, VALUE_CHAR, VALUE_DESCR | #### 性能优化建议 1. **批量处理**：在循环外部调用函数，避免多次调用 2. **特性筛选**：如需根据特性值反查物料，直接查询表 `AUSP` 更高效[^2] ```abap SELECT objek FROM ausp WHERE atinn = @lv_charact_id AND atwrt = @lv_value INTO TABLE @lt_matnr. ``` 3. **字段限制**：仅获取必要字段（避免使用 `features = 'X'` 获取全部特性） #### 常见错误处理 | 错误代码 | 原因 | 解决方案 | |----------|----------------------|----------------------------| | SY-SUBRC=1 | 物料无分类数据 | 检查物料是否维护分类视图 | | SY-SUBRC=2 | 无效分类类型 | 确认 `classtype` 值是否有效 | | SY-SUBRC=3 | 分类类型配置错误 | 检查事务代码 `CL02` 的配置 | > **注意**：修改分类数据需额外调用 `BAPI_OBJCL_CHANGE`，此函数主要用于查询[^3]。