企业官网建设流程全解析

目录

前言

一、什么是转换例程？

为什么需要转换例程？

二、例程在哪里定义？

如何找到它？

表级查询方式

三、如何发现代码中的转换例程？

四、如何在程序中强制使用/调用（应用）转换例程？

1、自动转换：系统隐式调用

2、 手动调用：输出格式化

3、手动调用：输入 / 输出函数

五、常用标准转换例程速查

六、常见踩坑点与误区

1. 查询条件格式不匹配

2. 字符串操作丢失转换

3. ALV 内表无 DDIC 引用不自动转换

4. 混淆 INPUT 与 OUTPUT 方向

5. 自定义例程接口不规范

七、如何创建自定义转换例程

六、总结与实践

前言

在 SAP ABAP 开发中，我们常常会遇到这样的场景：数据库中存储的物料号是“000000001000000123”，但用户在屏幕上看到的却是“1000000123”；用户输入的单位是“PC”，但在系统内部却变成了“XXXX”（或一个3位代码）。这一切的背后，都是转换例程在发挥作用。

那么，这个神秘的“例程”到底是什么？它在哪里定义？又是如何工作的？

一、什么是转换例程？

转换例程（Conversion Routine）是 SAP ABAP 数据字典中的一种标准机制，它的核心作用是作为 “翻译官” 或 “格式器”，在内部存储值和外部显示值之间进行双向自动转换。

• 内部存储: 系统为了统一、高效、避免歧义而存储的格式。例如物料号前面用零补齐到 18 位、单位使用 3 位标准码等。
• 外部展示: 用户期望看到的、符合业务习惯与阅读理解的格式。例如去掉前导零的物料号、业务常用单位简写等。

注意：转换例程 ≠ 编辑屏蔽（Edit Mask）。编辑屏蔽是静态格式模板（如日期的__.__.____），只能做简单的格式拼接；转换例程基于函数模块实现，支持校验、查表、多语言适配等复杂逻辑。二者都可用于输出格式化，但转换例程能力更强、应用范围更广。

为什么需要转换例程？

• 数据一致性: 保证所有程序在内部使用统一格式进行存储、比较和计算，避免格式差异导致的逻辑错误。
• 用户体验: 让用户看到友好、易读的输入输出格式，符合不同语言、不同业务的使用习惯。
• 解耦: 修改外部展示格式时，只需修改例程逻辑，无需修改所有引用该字段的程序代码。

二、例程在哪里定义？

转换例程是基于域（Domain）绑定的。当你为某个数据元素（Data Element）指定了域，而该域上挂接了转换例程，那么所有使用这个数据元素的字段、变量都会自动继承这个例程。

如何找到它？

1. 输入事务代码 SE11。
2. 选择“域”，输入域名（例如 MATNR 或你之前问的 MEINS）。
3. 点击“更改”或“显示”。
4. 在菜单栏或页签中找到 “增补/输出” 或 “例程” 相关选项。

• 在这里，你会看到 “转换例程” 的输入框。
• 例如，在物料号的域 MATNR 上，通常会有一个名为 MAT1 的例程；在单位的域 MEINS 上，则有一个名为 CUNIT 的例程。

表级查询方式

转换例程名称存储在系统表DD01L（域属性表）的CONVEXIT字段中，可通过 SE16N 查询该表批量获取域对应的例程；也可通过DD04L（数据元素表）、DD03L（表字段表）逐层回溯查询。

三、如何发现代码中的转换例程？

在程序运行时，我们如何动态地知道一个字段是否有转换例程，甚至它的名称是什么？

示例代码：

DATA: lv_matnr TYPE mara-matnr VALUE '000000000000001234', lv_edit_mask TYPE c LENGTH 20. " 检查字段 LV_MATNR 是否有关联的转换例程 DESCRIBE FIELD lv_matnr EDIT MASK lv_edit_mask. IF sy-subrc = 0. WRITE: / '该字段的转换例程是:', lv_edit_mask. ELSE. WRITE: / '该字段没有转换例程。'. ENDIF.

四、如何在程序中强制使用/调用（应用）转换例程？

转换例程的调用分为系统自动调用和手动显式调用两种场景。

1、自动转换：系统隐式调用

这是最容易被忽略、也最容易踩坑的特性。只要字段参考了绑定例程的数据元素，在标准 UI 场景中系统会自动完成双向转换，无需手动写代码：

• 选择屏幕：PARAMETERS/SELECT-OPTIONS定义的字段，用户输入外部值后，系统自动执行 INPUT 转换，程序中拿到的是内部格式。
• 屏幕 Painter 字段：对话程序的屏幕字段自动完成输入 / 输出双向转换。
• WRITE 输出：直接输出参考了 DDIC 的变量时，默认自动执行 OUTPUT 转换。
• ALV 报表：字段若参考标准 DDIC 结构 / 数据元素，会自动触发 OUTPUT 转换。

示例（WRITE 自动转换）：

DATA: lv_matnr TYPE mara-matnr VALUE '000000000000001234'. WRITE lv_matnr. " 自动输出：1234（去掉前导零的外部格式）

2、 手动调用：输出格式化

当变量未参考 DDIC、或需要强制指定格式时，可使用WRITE ... USING EDIT MASK手动应用例程或格式模板。

示例：

DATA: lv_date TYPE d VALUE '20260714'. " 假设日期字段关联了例程，但此处我们直接指定一个格式 WRITE: / '应用格式转换后的日期:', lv_date USING EDIT MASK '__.__.____'. " 直接指定转换例程名 DATA: lv_matnr TYPE char18 VALUE '000000000000001234'. WRITE lv_matnr USING EDIT MASK 'MATN1'. " 按物料号例程输出

注：对于日期、时间等字段，它们实际上是由系统自动进行格式化的，USING EDIT MASK提供了更灵活的控制。

3、手动调用：输入 / 输出函数

这是开发中最灵活、最常用的方式，尤其适用于接口数据处理、文件导入导出、字符串拼接等非 UI 场景。

转换例程对应一对标准函数，命名规则固定：

• 外部 → 内部：CONVERSION_EXIT_<例程名>_INPUT
• 内部 → 外部：CONVERSION_EXIT_<例程名>_OUTPUT

示例（物料号转内部格式）：

CALL FUNCTION 'CONVERSION_EXIT_MATN1_INPUT' EXPORTING input = lv_matnr_external " 用户输入的外部值：1234 IMPORTING output = lv_matnr_internal " 转为内部格式：000000000000001234 EXCEPTIONS length_error = 1.

方向总结：

• 内部 → 外部 (显示给用户)：调用 CONVERSION_EXIT_<例程>_OUTPUT 函数或依赖 UI 场景自动转换。
• 外部 → 内部 (用户输入/文件导入)：调用 CONVERSION_EXIT_<例程>_INPUT，或依赖选择屏幕自动转换。

五、常用标准转换例程速查

SAP 预置了大量标准转换例程，开发中最高频的包括：

六、常见踩坑点与误区

转换例程的隐式特性很容易导致开发问题，以下是最高频的坑点：

1. 查询条件格式不匹配

数据库中存储的永远是内部格式。如果直接用外部格式写 WHERE 条件，会导致查询无结果。

" 错误示例：数据库存的是18位带零物料号，用外部值查不到 SELECT SINGLE * FROM mara WHERE matnr = '1234'.

2. 字符串操作丢失转换

将带例程的字段赋值给普通字符变量、或进行字符串拼接时，得到的是内部格式，而非显示格式，需要手动调用_OUTPUT函数转换。

3. ALV 内表无 DDIC 引用不自动转换

如果 ALV 内表字段是自定义TYPE c、未参考标准数据元素，系统无法识别转换例程。解决方案：要么字段参考 DDIC 元素，要么在字段目录中手动指定edit_mask，或提前手动转换。

4. 混淆 INPUT 与 OUTPUT 方向

记住一个原则：进系统用 INPUT，出系统用 OUTPUT。方向用反会导致数据格式异常，甚至报错。

5. 自定义例程接口不规范

自定义转换例程的函数必须严格使用INPUT作为导入参数、OUTPUT作为导出参数，否则系统无法自动调用。

七、如何创建自定义转换例程

当标准例程无法满足业务需求时（如自定义单据号规则、特殊编码格式），可以创建自定义转换例程，步骤如下：

• 规划例程名称：最多 5 位字符，自定义建议以 Z 开头，如ZORDNO。
• 创建一对函数模块（SE37）：
  • 严格遵循命名规范：CONVERSION_EXIT_ZORDNO_INPUT、CONVERSION_EXIT_ZORDNO_OUTPUT
  • 导入参数固定为INPUT，导出参数固定为OUTPUT，类型与业务域匹配
  • 在函数内实现格式转换、校验等业务逻辑
• 绑定到域（SE11）：打开对应域，在 “转换例程” 处填入例程名并激活。
• 生效验证：所有使用该域的数据元素、表字段、程序变量，都会自动继承该转换例程。

六、总结与实践

1、DDIC 阶段优先设计：定义新域 / 数据元素时，编码、单位、日期类字段优先绑定转换例程，这是 SAP 标准最佳实践，能大幅减少冗余的格式处理代码。

2、程序开发边界原则：

· 数据进入系统（用户输入、接口导入、文件上传）：第一时间执行 INPUT 转换，再做业务处理

· 数据流出系统（报表输出、接口下发、文件导出）：最后一步执行 OUTPUT 转换

· 程序内部逻辑、数据库查询：统一使用内部格式

3、调试排查思路：遇到数据显示异常、查询无结果时，优先排查域绑定的例程、当前数据的格式、转换函数的方向是否正确。

掌握转换例程，能让你的 ABAP 代码更符合 SAP 标准规范，数据更统一，同时避免大量因格式不匹配导致的业务 Bug。