Mark的技术博客

SAP顾问 | 咨询专家 | IT与AI技术探索者

吴让宇(Mark)

吴让宇(Mark)

SAP顾问 | 咨询专家 | IT与AI技术探索者

吴让宇(Mark)的个人技术博客,专注于SAP系统实施、行业方案咨询、IT技术与AI技术的研究与分享。

SAP Fiori ABAP CDS OData Dify Docker AI LLM

最新文章

ABAP 数据类型

ℹ️概述
当在ABAP中编程时,我们需要使用各种变量来存储各种信息。变量只是保留值的存储位置。基于变量的数据类型,操作系统分配内存并决定在保留内存中可以存储的内容。

📊 基本数据类型

ABAP为程序员提供了丰富的固定长度和可变长度数据类型。

数据类型关键词

类型 关键词 描述
字节字段 X 存储二进制数据
文本域 C 存储字符数据
数字文本字段 N 存储数字字符
日期字段 D 存储日期信息
时间字段 T 存储时间信息
整数 I 存储整数值
浮点数 F 存储浮点数
打包数量 P 存储十进制数
文本字符串 STRING 可变长度文本
字节字符串 XSTRING 可变长度二进制数据

数据类型分类

ABAP数据类型可以分为以下几类:

  • byte: 字节类型
  • numeric: 数字类型
  • character-like: 字符类型

内存占用和范围

类型 典型长度 典型范围 说明
X 1字节 00到FF 任何字节值
C 1个字符 1~65535 文本字符
N 1个字符 1~65535 数字文本
D 8个字符 固定8字符 日期格式
T 6个字符 固定6字符 时间格式
I 4字节 -2147483648至2147483647 32位整数
F 8字节 ±2.225E-308至±1.798E+308 64位浮点数
P 8字节 [-10^(2len-1)+1]到[+10^(2len-1)] 打包十进制数
STRING 可变 任意长度 动态字符串
XSTRING 可变 任意字节值 动态二进制数据
💥代码示例
1
2
3
4
5
6
7
8
9
10
11
12
REPORT YR_SEP_12.
DATA text_line TYPE C LENGTH 40.
text_line = 'A Chapter on Data Types'.
Write text_line.

DATA text_string TYPE STRING.
text_string = 'A Program in ABAP'.
Write / text_string.

DATA d_date TYPE D.
d_date = SY-DATUM.
Write / d_date.

输出结果

1
2
3
A Chapter on Data Types
A Program in ABAP
12092015
📌字符串类型说明
  • 类型STRING数据对象通常应用于固定长度不重要的字符内容
  • DATE类型用于存储日期信息,并且可以存储八位数字
  • N类型只能存储数字字符,不能存储其他字符

🔧 复杂和参考类型

复杂类型分类

复杂类型分为结构类型和表类型。

结构类型

在结构类型中,基本类型和结构(即嵌入在结构中的结构)被分组在一起。你可以只考虑基本类型的分组,但必须意识到结构的嵌套可用性。

💡数据访问
当基本类型被分组在一起时,数据项可以作为分组数据项被访问或者可以访问各个基本类型数据项(结构字段)。

表类型(内部表)

表类型在其他编程语言中更好地称为数组。数组可以是简单数组或结构数组。在ABAP中,数组被称为内部表,并且与其他编程语言相比,它们可以以许多方式被声明和操作。

内部表参数

S.No. 参数 & 描述
1 行类型

内部表的行可以是基本类型、复杂类型或引用类型
2 键

将字段或一组字段指定为标识表行的内部表的键。键包含基本类型的字段
3 访问方法

描述ABAP程序如何访问单个表条目

引用类型

引用类型用于引用类、接口和运行时数据项的实例。ABAP OOP运行时类型服务(RTTS)允许在运行时声明数据项。

⚠️引用类型用途
  • 用于面向对象编程中的对象引用
  • 用于动态创建和操作数据
  • 支持运行时类型检查

📊 ABAP数据类型关系图



graph TD
    A[ABAP数据类型] --> B[基本数据类型]
    A --> C[复杂类型]
    A --> D[引用类型]
    
    B --> B1[字节类型<br/>X, XSTRING]
    B --> B2[字符类型<br/>C, N, STRING]
    B --> B3[数值类型<br/>I, F, P]
    B --> B4[日期时间<br/>D, T]
    
    C --> C1[结构类型]
    C --> C2[表类型/内部表]
    
    D --> D1[对象引用]
    D --> D2[接口引用]
    D --> D3[运行时类型]

💡 最佳实践

  1. 数据类型选择:

    • 对于固定长度的文本使用TYPE C
    • 对于动态文本使用TYPE STRING
    • 对于数字计算使用TYPE I或TYPE F
    • 对于货币金额使用TYPE P
  2. 内存管理:

    • 合理设置字段长度,避免浪费内存
    • 注意数据类型的范围限制
    • 对于大数字考虑使用F类型
  3. 性能考虑:

    • 避免频繁转换数据类型
    • 合理使用STRING的动态特性
    • 注意P类型的小数位限制

ABAP 格式化数据

ℹ️概述
ABAP提供各种类型的格式化选项以格式化程序的输出。例如,您可以创建包含不同颜色或格式样式的各种项目的列表。WRITE语句是用于在屏幕上显示数据的格式化语句。

📝 WRITE语句语法

WRITE语句的语法是:

1
WRITE <format> <f> <options>.

参数说明

  • <format> - 输出格式规范,可以是指示从新行开始的输出的显示的正斜杠(/)
  • <f> - 数据变量或编号文本
  • <options> - 格式化选项

格式规范示例

格式规范 说明
/ 从新行开始
04(6) 从第4列开始,列长度为6
20 显示在第20列

🔘 基本格式化选项

对齐方式

编号 选项 说明
1 LEFT-JUSTIFIED 指定输出为左对齐
2 CENTERED 表示输出居中
3 RIGHT-JUSTIFIED 指定输出为右对齐

位置控制

编号 选项 说明
4 UNDER 输出直接在字段下启动
5 NO-GAP 指定字段之后的空白被拒绝

编辑掩码

编号 选项 说明
6 USING EDIT MASK 表示格式模板的规范
7 NO-ZERO 如果字段只包含零,则它们将被空格替换

🔢 数字格式化选项

编号 选项 说明
1 NO-SIGN 指定屏幕上不显示前导符号
2 EXPONENT 指定在类型F(浮点字段)中,指数在中定义
3 ROUND 类型P字段先乘以10**(-r),然后四舍五入为整数值
4 CURRENCY 表示格式化是根据货币值存储在TCURX数据库表中
5 UNIT 指定小数位数根据单位,如类型P的T006数据库表中指定
6 DECIMALS 指定数字的数目必须显示在小数点后面

📅 日期格式化选项

格式化选项 示例
DD/MM/YY 13/01/15
MM/DD/YY 01/13/15
DD/MM/YYYY 13/01/2015
MM/DD/YYYY 01/13/2015
DDMMYY 130115
MMDDYY 011315
YYMMDD 150113
📌日期格式说明
  • DD - 代表两个数字中的日期
  • MM - 代表两个数字中的月份
  • YY - 代表两个数字中的年份
  • YYYY - 代表一年中的四个数字

📝 示例代码

基本格式化示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
REPORT ZTest123_01.
DATA:
n(9) TYPE C VALUE 'Tutorials',
m(5) TYPE C VALUE 'Point'.

-- 基本输出
WRITE: n, m.

-- 换行和对齐
WRITE: / n, / m UNDER n.

-- 无间隙连接
WRITE: / n NO-GAP, m.

-- 时间格式化
DATA time TYPE T VALUE '112538'.
WRITE: / time, -- 输出: 112538
/(8) time USING EDIT MASK '__:__:__'. -- 输出: 11:25:38

输出:

1
2
3
4
5
6
Tutorials Point
Tutorials
Point
TutorialsPoint
112538
11:25:38

数字格式化示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
REPORT ZTest123_01.
DATA:
amount TYPE P DECIMALS 2 VALUE 1234.56,
number TYPE I VALUE -12345,
float TYPE F VALUE 1234.5678.

-- 基本数字输出
WRITE: / 'Basic amount:', amount.
WRITE: / 'Basic number:', number.

-- 格式化选项
WRITE: / 'NO-SIGN:', number NO-SIGN.
WRITE: / 'CURRENCY:', amount CURRENCY 'EUR'.
WRITE: / 'DECIMALS:', amount DECIMALS 4.
WRITE: / 'ROUND:', amount ROUND 2.

-- 浮点数格式化
WRITE: / 'EXPONENT:', float EXPONENT 2.

输出:

1
2
3
4
5
6
7
Basic amount: 1,234.56
Basic number: -12345
NO-SIGN: 12345
CURRENCY: €1,234.56
DECIMALS: 1,234.5600
ROUND: 1,235.00
EXPONENT: 1.23457E+03

日期格式化示例

1
2
3
4
5
6
7
8
9
10
11
REPORT ZTest123_01.
DATA: date TYPE D VALUE '20240315'.

-- 不同日期格式
WRITE: / 'Date format 1:', date DD/MM/YYYY.
WRITE: / 'Date format 2:', date MM/DD/YYYY.
WRITE: / 'Date format 3:', date YYMMDD.
WRITE: / 'Date format 4:', date DDMMYY.

-- 使用编辑掩码
WRITE: / 'Custom format:', date USING EDIT MASK 'Day: DD Month: YYYY'.

输出:

1
2
3
4
5
Date format 1: 15/03/2024
Date format 2: 03/15/2024
Date format 3: 240315
Date format 4: 150324
Custom format: Day: 15 Month: 2024

🎨 高级格式化技巧

1. 颜色和样式

1
2
3
4
5
6
7
8
9
10
11
12
REPORT ZTest123_01.
DATA: text TYPE C VALUE 'Colored Text'.

-- 设置颜色
FORMAT COLOR COL_POSITIVE.
WRITE: / 'Positive Text', text.

FORMAT COLOR COL_NEGATIVE.
WRITE: / 'Negative Text', text.

FORMAT COLOR COL_HEADING.
WRITE: / 'Heading Text', text.

2. 热点功能

1
2
3
4
5
6
7
8
9
10
11
12
13
REPORT ZTest123_01.
DATA:
lv_field(10) VALUE 'Click Me',
lv_value TYPE I VALUE 100.

-- 创建热点
WRITE: / lv_field HOTSPOT ON.
WRITE: / 'Value:', lv_value.

AT LINE-SELECTION.
IF sy-lspos = 1. -- 点击第一列
WRITE: / 'You clicked on:', lv_field.
ENDIF.

3. 列对齐和布局

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
REPORT ZTest123_01.
DATA:
col1 TYPE C VALUE 'Name',
col2 TYPE C VALUE 'Age',
col3 TYPE C VALUE 'City',
val1 TYPE C VALUE 'John',
val2 TYPE I VALUE 30,
val3 TYPE C VALUE 'New York'.

-- 表格形式输出
WRITE: / col1 UNDER col1,
col2 UNDER col2,
col3 UNDER col3.

ULINE.

WRITE: / val1 LEFT-JUSTIFIED,
val2 RIGHT-JUSTIFIED,
val3 CENTERED.

输出:

1
2
3
Name    Age   City
------------------
John 30 New York

⚙️ 常用格式化组合

1. 货币格式化

1
2
3
4
5
6
7
8
9
10
REPORT ZTest123_01.
DATA:
amount TYPE P DECIMALS 2 VALUE 12345.67,
currency TYPE C VALUE 'USD'.

-- 不同货币格式
WRITE: / 'Basic:', amount.
WRITE: / 'Currency:', amount CURRENCY currency.
WRITE: / 'With Unit:', amount UNIT 'PC'.
WRITE: / 'Round:', amount ROUND -2.

2. 时间格式化

1
2
3
4
5
6
7
REPORT ZTest123_01.
DATA: time TYPE T VALUE '143025'.

-- 不同时间格式
WRITE: / 'Basic:', time.
WRITE: / 'With mask:', time USING EDIT MASK '__:__:__'.
WRITE: / 'Short:', time USING EDIT MASK '__:__'.

3. 列宽控制

1
2
3
4
5
6
7
8
9
REPORT ZTest123_01.
DATA:
long_text TYPE C VALUE 'This is a long text that needs to be formatted',
short_text TYPE C VALUE 'Short'.

-- 控制列宽
WRITE: / long_text.
WRITE: /(20) long_text. -- 限制宽度为20
WRITE: / short_text NO-GAP.

🎯 实际应用场景

1. 报表输出格式化

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
" 生成格式化的销售报表
REPORT ZSalesReport.
DATA:
lt_sales TYPE TABLE OF zsals,
wa_sales TYPE zsals.

SELECT * FROM zsals INTO TABLE lt_sales
WHERE bukrs = '1000'
UP TO 100 ROWS.

" 报表标题
WRITE: / 'SALES REPORT'.
ULINE.
WRITE: / 'Company' HOTSPOT ON,
'Material' HOTSPOT ON,
'Quantity' RIGHT-JUSTIFIED,
'Amount' RIGHT-JUSTIFIED.

ULINE.

LOOP AT lt_sales INTO wa_sales.
WRITE: / wa_sales-bukrs UNDER 'Company',
wa_sales-matnr UNDER 'Material',
wa_sales-menge RIGHT-JUSTIFIED,
wa_sales-netwr RIGHT-JUSTIFIED CURRENCY 'EUR'.
ENDLOOP.

2. ALV报表基础

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
" ALV显示前的数据准备
DATA: lt_fieldcat TYPE TABLE OF lvc_s_fcat.

" 定义字段目录
APPEND VALUE #(
fieldname = 'MATNR'
coltext = 'Material Number'
outputlen = 18
hotspot = 'X'
) TO lt_fieldcat.

APPEND VALUE #(
fieldname = 'MAKTX'
coltext = 'Description'
outputlen = 40
hotspot = 'X'
) TO lt_fieldcat.

APPEND VALUE #(
fieldname = 'NETWR'
coltext = 'Net Value'
outputlen = 15
currency = 'EUR'
hotspot = 'X'
) TO lt_fieldcat.

3. Web界面格式化

1
2
3
4
5
6
7
8
9
10
11
12
13
14
" 生成HTML格式的输出
REPORT ZWebOutput.
DATA: html TYPE STRING.

" 构建HTML内容
html = '<table border="1">' &&
'<tr><th>Name</th><th>Age</th></tr>' &&
'<tr><td>John</td><td>30</td></tr>' &&
'</table>'.

" 写入HTML
CALL FUNCTION 'HTML '
EXPORTING
html = html.

⚠️ 注意事项

1. 性能考虑

1
2
3
4
5
6
7
8
9
10
11
" ❌ 性能差:频繁的格式化
DO 1000 TIMES.
WRITE: / 'Line:', sy-index USING EDIT_MASK '0000'.
ENDDO.

" ✅ 性能好:预格式化
DATA: lv_text TYPE C VALUE 100.
DO 1000 TIMES.
lv_text = |Line: { sy-index ALIGN = 'LEFT' }|.
WRITE: / lv_text.
ENDDO.

2. 内存使用

1
2
3
4
5
" ❌ 内存浪费:大字符串
DATA: lv_large TYPE C VALUE 100000.

" ✅ 内存优化:按需分配
DATA: lv_optimized(80) TYPE C.

3. 显示控制

1
2
3
4
5
6
" 控制显示区域
WRITE: / 'Header' COLOR COL_HEADING.
ULINE.

WRITE: / 'Content' UNDER 'Header'.
ULINE.

💡 格式化最佳实践

1. 一致性原则

  • 保持整个应用程序的格式化风格一致
  • 使用标准的颜色和样式
  • 统一的日期和数字格式

2. 可读性优化

  • 合理的列宽和对齐
  • 适当的间距和分隔
  • 清晰的标题和说明

3. 性能优化

  • 避免在循环中进行复杂格式化
  • 使用预定义的格式模板
  • 减少不必要的格式化选项

4. 用户体验

  • 考虑不同用户的显示偏好
  • 提供格式化选项的配置
  • 确保格式化后的数据易于理解

💡 最佳实践

1. 格式化设计原则

  • 根据数据类型选择合适的格式化选项
  • 保持输出的可读性和一致性
  • 考虑不同用户的显示需求

2. 代码质量

  • 使用有意义的格式化选项
  • 添加必要的注释说明
  • 保持代码的简洁和清晰

3. 维护考虑

  • 将格式化逻辑集中管理
  • 使用参数化格式化选项
  • 避免硬编码格式化值

4. 测试验证

  • 测试各种格式化选项
  • 验证显示效果
  • 检查性能影响

ABAP 常量和文本值

ℹ️概述
文字是您在程序的源代码中创建的未命名数据对象,他们完全由他们的价值定义,您不能更改文字的值。常量是通过使用声明性语句静态创建的命名数据对象,分配给常数的值在程序执行期间不能更改。

📝 文字类型

文字有两种基本类型:

🔢 数字字面量

数字文字是可以有前缀符号的数字序列。在数字文字中,没有十进制分隔符,也没有带尾数和指数的符号。

1
183.  -97.  +326.

🔤 字符文字

字符文字是用单引号括起来的ABAP程序的源代码中的字母数字字符序列。

1. 文本字段文字 (类型C)

用单引号括起的字符文字具有预定义的ABAP类型C。

1
2
3
REPORT YR_SEP_12.
Write 'Tutorials Point'.
Write / 'ABAP Tutorial'.

2. 字符串文字 (类型STRING)

包含在后引号中的文字具有ABAP类型STRING。

1
2
3
REPORT YR_SEP_12.
Write `Tutorials Point `.
Write / `ABAP Tutorial `.

⚠️ 重要区别

特性 文本字段文字 字符串文字
引号类型 单引号 ' 后引号 `
数据类型 C STRING
尾随空白 被忽略 被保留
输出示例 Tutorials Point Tutorials Point
📌输出结果
上述两种情况的输出相同:
1
2
Tutorials Point
ABAP Tutorial

🎯 CONSTANTS声明

语法格式

1
CONSTANTS <f> TYPE <type> VALUE <val>.

参数说明

  • <f> - 指定常量的名称
  • <type> - 表示常量的类型,继承与现有数据类型相同的技术属性
  • <val> - 为声明的常量名<f>赋值一个初始值
⚠️必须使用VALUE子句
我们应该使用CONSTANTS语句中的VALUE子句。子句”VALUE”用于在声明期间为常量赋予初始值。

CONSTANTS与DATA的区别

特性 DATA CONSTANTS
值可变性 可更改 不可更改
声明方式 DATA CONSTANTS
初始化 可选 必须指定
用途 存储变量数据 存储固定值

📊 常量类型

1. 基本常量

涉及基本数据类型的常量。

1
2
3
REPORT YR_SEP_12.
CONSTANTS PQR TYPE P DECIMALS 4 VALUE '1.2356'.
Write: / 'The value of PQR is:', PQR.

输出:

1
The value of PQR is: 1.2356

2. 复杂常量

由多个字段组成的结构化常量。

1
2
3
4
5
BEGIN OF EMPLOYEE,
Name(25) TYPE C VALUE 'Management Team',
Organization(40) TYPE C VALUE 'Tutorials Point Ltd',
Place(10) TYPE C VALUE 'India',
END OF EMPLOYEE.
💡代码解析
EMPLOYEE是一个由Name、Organization和Place字段组成的复杂常量。

3. 参考常量

引用其他对象或数据的常量。

1
CONSTANTS null_pointer TYPE REF TO object VALUE IS INITIAL.
📌参考常量用途
我们可以在比较中使用常量引用,或者我们可以将其传递给过程。

🔧 常量使用示例

实际应用场景

1. 配置常量

1
2
3
4
5
" 应用程序配置常量
CONSTANTS:
MAX_RETRIES TYPE I VALUE 3,
TIMEOUT_SECS TYPE I VALUE 30,
DEBUG_MODE TYPE C VALUE 'X'.

2. 业务规则常量

1
2
3
4
5
" 业务规则
CONSTANTS:
TAX_RATE TYPE P DECIMALS 2 VALUE '0.18',
DISCOUNT_THRESHOLD TYPE I VALUE 1000,
CURRENCY_CODE TYPE C VALUE 'CNY'.

3. 系统常量

1
2
3
4
5
" 系统参数
CONSTANTS:
COMPANY_CODE TYPE C VALUE '1000',
FISCAL_YEAR TYPE N VALUE '2024',
DECIMAL_SEPARATOR TYPE C VALUE '.'.

🎨 常量命名规范

推荐的命名模式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
✅ 使用大写字母和下划线:
MAX_LENGTH
DEFAULT_VALUE
ERROR_MESSAGE

✅ 带有业务含义的常量:
TAX_RATE_VAT
DISCOUNT_SENIOR
CURRENCY_USD

✅ 系统配置常量:
DB_HOST_NAME
API_TIMEOUT
MAX_LOGIN_ATTEMPTS

常量的作用域

作用域 声明位置 特点
全局常量 在全局声明部分 整个程序可见
局部常量 在子程序/方法中 仅在声明范围内可见
类常量 在类定义中 类的静态属性

🔄 常量与变量的对比



graph TD
    A[数据对象] --> B[变量]
    A --> C[常量]
    
    B --> B1[可修改]
    B --> B2[使用DATA声明]
    B --> B3[无初始值]
    
    C --> C1[不可修改]
    C --> C2[使用CONSTANTS声明]
    C --> C3[必须有初始值]

最佳实践

  1. 何时使用常量:

    • 固定值配置
    • 业务规则
    • 系统参数
    • 常用字符串
  2. 避免使用常量的情况:

    • 需要频繁变化的值
    • 用户输入的数据
    • 运行时计算的结果

💡 最佳实践

1. 常量声明原则

  • 常量名称要有意义,使用大写字母
  • 始终指定数据类型
  • 为常量提供有初始值
  • 遵循命名规范

2. 使用场景选择

  • 使用常量而不是硬编码值
  • 将常量集中管理
  • 常量值变更时只需修改一处
  • 使用常量提高代码可读性

3. 性能考虑

  • 常量在编译时就确定值
  • 运行时访问常量比变量更快
  • 常量不占用运行时内存

ABAP 数据元素

📋 概述

数据元素描述ABAP数据字典中的各个字段。它们是复杂类型的最小不可分割单元,用于定义:

  • 表字段的类型
  • 表的结构组件
  • 行类型

语义定义

数据元素不仅定义技术规格,还提供:

  • 关于表字段的含义信息
  • 屏幕字段的编辑信息
  • 自动可用于引用数据元素的所有屏幕字段

基本类型 vs 引用类型



graph TD
    A[数据元素] --> B[基本类型]
    A --> C[引用类型]
    
    B --> B1[直接定义类型]
    B --> B2[分配域]
    
    C --> C1[引用其他数据元素]
    C --> C2[引用预定义类型]

🛠️ 创建数据元素

步骤1:准备工作

在创建新数据元素之前,需要检查任何现有的数据元素是否具有表字段中所需的相同语义规范。如果有,应该使用现有的数据元素。

步骤2:启动事务

使用事务 SE11 进入ABAP字典。

步骤3:选择数据元素类型

在ABAP字典的初始屏幕中选择数据类型的单选按钮:



graph LR
    A[SE11事务] --> B[选择数据类型单选按钮]
    B --> C[输入数据元素名称]
    C --> D[点击CREATE按钮]

命名规则

  • 对象名称始终以 “Z” 或 “Y” 开头
  • 确保在客户名称空间下创建

步骤4:确认类型选择

在CREATE TYPE弹出窗口中选择”数据元素”单选按钮,然后点击绿色复选标记图标。

步骤5:输入基本信息

数据元素维护屏幕

  • 在短文本字段中输入说明(如”客户数据元素”)
  • 注意:必须先输入短文本,才能输入其他属性

步骤6:分配类型

数据元素可以通过以下方式分配类型:

分配方式 说明 示例
基本类型 直接定义基本数据类型 CHAR, NUMC, DEC
引用类型 引用其他数据元素 REFERENCE TO OTHER_DTEL
分配域 分配给域 DOMAIN ZCUST

创建基本数据元素



graph TB
    A[数据元素] --> B[选择域]
    A --> C[选择预定义类型]
    
    B --> B1[ZCUST域]
    C --> C1[CHAR类型]
    C --> C2[NUMC类型]

步骤7:设置字段标签

在字段标签选项卡中输入:

标签类型 描述 用途
短文本 简短的描述 列表显示
中等文本 中等长度的描述 工具提示
长文本 详细的描述 帮助文档
标题 标题文本 屏幕标题

自动生成长度

按Enter键,系统会自动为这些标签生成合适的长度。

步骤8:保存对象

  1. 保存更改

    • 将显示”创建对象目录条目”弹出窗口
    • 输入包名称或使用本地对象
  2. 激活数据元素

    • 点击激活图标(火柴图标)
    • 或按 Ctrl + F3

步骤9:激活处理

激活过程

  1. 激活名为”DTEL”的顶部条目(如Z_CUST)
  2. 点击绿色勾号按钮
  3. 状态栏显示”对象已激活”

激活日志

如果出现错误或警告:

  • 系统自动显示激活日志
  • 可以通过实用程序(M)→激活日志查看

🔍 数据元素属性详解

基本属性

属性 描述 示例
短文本 数据元素的简短描述 “客户编号”
数据类型 基础数据类型 CHAR, NUMC, DEC
长度 字符长度 10, 20, 40
小数位 小数位数 2, 3

引用属性

属性 描述 作用
引用类型 引用的对象类型 基础类型或引用类型
域名 关联的域名称 技术规格定义
数据类型 ABAP数据类型 技术实现

字段标签

标签 长度 用途
短文本 40字符 列表显示
中等文本 60字符 工具提示
长文本 80字符 帮助文本
标题 60字符 屏幕标题

💡 数据元素的使用场景

1. 表字段定义

1
2
3
4
5
* 使用数据元素定义表字段
TABLES: scustom.
DATA: customer_id TYPE scustom-id,
name TYPE scustom-name,
address TYPE scustom-address.

2. 变量声明

1
2
3
4
* 使用数据元素声明变量
DATA: order_number TYPE vbeln, " 销售订单号
material TYPE matnr, " 物料编号
quantity TYPE mengt_field. " 数量字段

3. 参数定义

1
2
3
* 使用数据元素定义参数
PARAMETERS: p_carrid TYPE spfli-carrid, " 航空公司ID
p_connid TYPE spfli-connid. " 航班连接ID

🎯 数据元素的优势

1. 语义一致性

  • 为相同的业务概念使用相同的数据元素
  • 确保数据含义的一致性

2. 维护效率

  • 更改数据元素属性自动更新所有引用
  • 减少重复维护工作

3. 用户友好性

  • 提供有意义的字段标签
  • 改善用户界面体验

⚠️ 注意事项

1. 重用原则

  • 优先使用现有数据元素
  • 避免重复创建相同语义的数据元素

2. 命名规范

  • 使用有意义的名称
  • 遵循Z或Y前缀规则

3. 激活要求

  • 必须先保存短文本
  • 激活前检查所有属性
  • 激活失败时查看日志

ABAP 日期和时间

ℹ️概述
ABAP毫不保留地引用了公历日历,在世界大部分地区有效。我们可以将输出转换为特定国家/地区的日历。日期是指定到关于日历的精确日、周或月的时间。时间被指定为相对于一天的精确秒或分钟。ABAP总是以24小时格式保存时间。输出可以具有特定于国家的格式。日期和时间通常被解释为在当前时区有效的本地日期。

🔧 数据类型

ABAP提供了两种内置类型来处理日期和时间:

基本数据类型

1
2
3
4
5
6
7
8
9
DATA: 
date TYPE D, -- 日期类型
time TYPE T, -- 时间类型
year TYPE I, -- 年份
month TYPE I, -- 月份
day TYPE I, -- 日期
hour TYPE I, -- 小时
minute TYPE I, -- 分钟
second TYPE I. -- 秒数

数据类型格式

数据类型 格式 说明 示例
D YYYYMMDD 固定长度字符类型 20100913 表示 2010年9月13日
T HHMMSS 固定长度字符类型 102305 表示 10:23:05

⏰ 时间戳类型

除了这些内置类型,其他两种类型用于存储UTC格式的时间戳:

编号 数据类型 说明
1 TIMESTAMP 类型P - 长度8无小数
格式:YYYYMMDDhhmmss
表示短时间戳
2 TIMESTAMPL 类型P - 长度11小数7
格式:YYYYMMDDhhmmss,mmmuuun
表示长时间戳,包含秒的分数

📅 当前日期和时间

获取系统日期

1
2
3
4
5
6
7
8
REPORT YR_SEP_15.
DATA: date_1 TYPE D.
date_1 = SY-DATUM. -- 系统日期
Write: / 'Present Date is:', date_1 DD/MM/YYYY.

-- 增加日期
date_1 = date_1 + 06.
Write: / 'Date after 6 Days is:', date_1 DD/MM/YYYY.

输出:

1
2
Present Date is: 21.09.2015
Date after 6 Days is: 27.09.2015
📌日期计算说明
变量date_1分配有当前系统日期SY-DATUM的值。对于ABAP中的日期计算,这意味着我们将日期对象的日期组件增加6天。ABAP运行时环境足够聪明,可以在每月结束时翻转日期值。

时间计算

1
2
3
4
5
6
7
8
REPORT YR_SEP_15.
DATA: time_1 TYPE T.
time_1 = SY-UZEIT. -- 系统时间
Write /(60) time_1 USING EDIT MASK 'Now the Time is: __:__:__'.

-- 增加时间(75秒)
time_1 = time_1 + 75.
Write /(60) time_1 USING EDIT MASK 'A Minute and a Quarter from Now, it is: __:__:__'.

输出:

1
2
Now the Time is: 11:45:05
A Minute and a Quarter from Now, it is: 11:46:20

🕐 时间戳操作

使用GET TIME STAMP

1
2
3
4
5
6
7
8
9
10
11
REPORT YR_SEP_12.
DATA:
stamp_1 TYPE TIMESTAMP, -- 短时间戳
stamp_2 TYPE TIMESTAMPL. -- 长时间戳

-- 获取当前时间戳
GET TIME STAMP FIELD stamp_1.
Write: / 'The short time stamp is:', stamp_1 TIME ZONE SY-ZONLO.

GET TIME STAMP FIELD stamp_2.
Write: / 'The long time stamp is:', stamp_2 TIME ZONE SY-ZONLO.

输出:

1
2
The short time stamp is: 18.09.2015 11:19:40
The long time stamp is: 18.09.2015 11:19:40,9370000
📌时区处理
在上面的示例中,我们使用TIME ZONE添加WRITE语句显示时间戳。此添加根据指定的时区的规则格式化时间戳的输出。系统字段SY-ZONLO用于显示在用户首选项中配置的本地时区。

🔍 日期时间函数

1. 日期格式化

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
DATA: 
ld_date TYPE D VALUE '20240315',
ld_char(10).

-- 格式化为 DD/MM/YYYY
ld_char = ld_date+6(2) && '/' && ld_date+4(2) && '/' && ld_date(4).
Write: / 'Formatted Date:', ld_char. -- 15/03/2024

-- 使用转换函数
CALL FUNCTION 'CONVERT_DATE_TO_EXTERNAL'
EXPORTING
date_internal = ld_date
IMPORTING
date_external = ld_char.

Write: / 'External Format:', ld_char.

2. 时间计算

1
2
3
4
5
6
7
8
9
10
11
12
13
DATA: 
ld_date TYPE D,
ld_days TYPE I VALUE 30,
ld_result TYPE D.

ld_date = sy-datum.
-- 增加30天
ld_result = ld_date + ld_days.
Write: / 'After 30 days:', ld_result.

-- 计算2周前
ld_result = ld_date - 14.
Write: / '2 weeks ago:', ld_result.

3. 时间差计算

1
2
3
4
5
6
7
8
DATA: 
ld_date1 TYPE D VALUE '20240301',
ld_date2 TYPE D VALUE '20240331',
ld_days_diff TYPE I.

-- 计算天数差
ld_days_diff = ld_date2 - ld_date1.
Write: / 'Days between dates:', ld_days_diff.

🌐 时区处理

获取时区信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
DATA: 
lv_time_zone TYPE TIMEZONE,
lv_timestamp TYPE TIMESTAMP.

-- 获取系统时区
lv_time_zone = sy-zonlo.
Write: / 'System Time Zone:', lv_time_zone.

-- 转换时区
GET TIME STAMP FIELD lv_timestamp.
CONVERT TIME STAMP lv_timestamp
TIME ZONE 'UTC'
INTO DATE DATA(ld_date_utc)
TIME DATA(ld_time_utc).

Write: / 'UTC Date:', ld_date_utc.
Write: / 'UTC Time:', ld_time_utc.

时区转换

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
DATA: 
lv_timestamp TYPE TIMESTAMP,
lv_date TYPE D,
lv_time TYPE T,
lv_tzone TYPE TIMEZONE VALUE 'CET'. -- 中欧时间

-- 获取当前时间戳
GET TIME STAMP FIELD lv_timestamp.

-- 转换为指定时区
CONVERT TIME STAMP lv_timestamp
TIME ZONE lv_tzone
INTO lv_date lv_time.

Write: / 'Time in CET:', lv_date, lv_time.

📊 实际应用场景

1. 业务日期处理

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
" 计算工作日
DATA:
ld_start_date TYPE D VALUE '20240301',
ld_end_date TYPE D,
ld_work_days TYPE I.

ld_end_date = ld_start_date + 30. -- 项目截止日期

" 计算工作日(排除周末)
DO 31 TIMES.
IF ld_start_date+6(2) CO '012345' AND " 周一到周五
ld_start_date+6(2) <> '00'. " 不是周末
ADD 1 TO ld_work_days.
ENDIF.
ADD 1 TO ld_start_date.
ENDDO.

Write: / 'Total Work Days:', ld_work_days.

2. 时间戳记录

1
2
3
4
5
6
7
8
9
10
11
12
13
14
" 记录操作时间戳
DATA:
lv_timestamp TYPE TIMESTAMP,
lv_operation_log TYPE TABLE OF tsmd_log.

" 获取操作开始时间
GET TIME STAMP FIELD lv_timestamp.

" 记录日志
APPEND VALUE #(
uname = sy-uname
timestampl = lv_timestamp
action = 'CREATE_ORDER'
) TO lv_operation_log.

3. 日期验证

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
" 验证日期有效性
DATA:
ld_input_date TYPE D VALUE '20240230',
lv_valid TYPE ABAP_BOOL.

" 检查日期是否有效
CALL FUNCTION 'DATE_CHECK_PLAUSIBILITY'
EXPORTING
date = ld_input_date
IMPORTING
plausible = lv_valid.

IF lv_valid = abap_true.
Write: / 'Date is valid'.
ELSE.
Write: / 'Date is invalid'.
ENDIF.

⚠️ 注意事项

1. 日期范围

1
2
3
4
5
6
" ❌ 危险:可能产生无效日期
DATA: ld_date TYPE D.
ld_date = '20241301'. -- 无效的月份

" ✅ 安全:使用系统日期
ld_date = sy-datum.

2. 时区转换

1
2
3
4
5
6
7
8
" 注意时区对时间计算的影响
DATA:
lv_utc_time TYPE T VALUE '235959',
lv_local_time TYPE T.

" 考虑时区差异进行转换
" 例如UTC+8时区,需要加8小时
lv_local_time = lv_utc_time + 80000.

3. 时间戳精度

1
2
3
4
5
6
7
8
9
10
11
" TIMESTAMP精度:秒
" TIMESTAMPL精度:微秒
DATA:
lv_short TYPE TIMESTAMP,
lv_long TYPE TIMESTAMPL.

GET TIME STAMP FIELD lv_short.
GET TIME STAMP FIELD lv_long.

Write: / 'Short precision:', lv_short.
Write: / 'Long precision:', lv_long.

💡 性能优化

1. 批量日期处理



graph LR
    A[单条日期处理] --> B[性能问题]
    B --> C[批量处理优化]
    C --> D[减少函数调用]
    C --> E[使用内表循环]

2. 缓存常用日期

1
2
3
4
5
6
7
8
9
" 缓存频繁使用的日期
DATA: gv_current_date TYPE D VALUE sy-datum.
DATA: gv_fiscal_year TYPE N VALUE sy-datum(4).

" 使用缓存而不是每次都获取
IF gv_current_date <> sy-datum.
gv_current_date = sy-datum.
gv_fiscal_year = sy-datum(4).
ENDIF.

3. 时区处理优化

1
2
3
4
5
6
7
8
9
10
" 减少时区转换次数
DATA:
lv_timezone TYPE TIMEZONE VALUE sy-zonlo,
lv_timestamp TYPE TIMESTAMP.

" 一次性转换
GET TIME STAMP FIELD lv_timestamp.
CONVERT TIME STAMP lv_timestamp
TIME ZONE lv_timezone
INTO DATA(ld_date) DATA(ld_time).

💡 最佳实践

1. 日期处理原则

  • 使用标准数据类型(D、T)
  • 验证日期的有效性
  • 注意闰年和其他特殊情况

2. 时间处理原则

  • 使用24小时格式
  • 考虑时区差异
  • 正确处理时间溢出

3. 时间戳使用

  • 根据精度需求选择类型
  • 考虑存储空间
  • 注意UTC与本地时间的转换

4. 性能考虑

  • 减少不必要的日期时间转换
  • 使用批量处理
  • 缓存频繁使用的日期时间值

ABAP 搜索帮助

🔍 搜索帮助概述

定义

搜索帮助是ABAP字典的另一个存储库对象,用于以列表的形式显示字段的所有可能值。此列表也称为命中列表。

主要功能

  • 替代手动输入:可以选择从命中列表中输入值
  • 提高效率:避免冗长乏味的输入过程
  • 减少错误:防止手动输入时出现错误

🎯 搜索帮助的作用



graph LR
    A[用户输入] --> B[搜索帮助]
    B --> C[命中列表]
    C --> D[选择值]
    D --> E[自动填充]
    E --> F[数据验证]

🛠️ 创建搜索帮助

步骤1:启动事务

使用事务 SE11,选择”搜索帮助”的单选按钮,输入要创建的搜索帮助名称(如ZSRCH1),单击创建按钮。

步骤2:选择搜索帮助类型

系统提示创建搜索帮助类型,选择基本搜索帮助(默认值)。

步骤3:定义选择方法

在”选择方法”中指明数据源:

数据源类型 说明 示例
表 使用表作为数据源 ZCUSTOMERS1
视图 使用视图作为数据源 ZVIEW_TEST

步骤4:设置对话框类型

选择”对话框类型”,控制限制性对话框的外观:

选项 说明 用途
立即显示值 直接显示值列表 快速选择
带限制的对话框 先过滤再显示 精确查找
对话框用于输入帮助 手动输入后显示 辅助输入

步骤5:定义参数区域

为每个搜索帮助参数或字段,根据要求输入这些列字段。

参数字段详解

字段 描述 用途
搜索帮助参数 来自数据源的字段 参与搜索的字段
Import 复选框,是否为导入参数 参考搜索帮助
Export 复选框,是否为导出参数 将值传输到屏幕字段
LPos 选择列表中的物理位置 控制显示顺序
SPos 限制对话框中的物理位置 控制输入顺序
Data Element 数据元素名称 继承数据类型

示例参数设置

参数 Import Export LPos SPos 说明
CUSTOMER ☑️ ☑️ 1 1 客户编号参与搜索
NAME ☑️ ☑️ 2 2 客户姓名参与搜索

步骤6:测试和激活

一致性检查

按F8执行一致性检查,激活搜索帮助。

测试搜索帮助

系统显示”测试搜索帮助ZSRCH1”屏幕。

步骤7:功能验证

在”CUSTOMER”的”Ready for inp”屏幕字段中输入数字100004,按Enter键。

输出示例

系统显示客户编号100004和名称”STEPHEN”。

💡 搜索帮助的使用场景

1. 数据输入辅助

1
2
3
4
* 在屏幕中使用搜索帮助
PARAMETERS: p_carrid TYPE spfli-carrid
OBLIGATORY
MATCHCODE OBJECT ZCARRID.

2. 报表查询

1
2
3
4
* 在SELECT语句中使用
SELECT * FROM scustom
INTO TABLE lt_customers
WHERE id = '100004'.

3. 动态搜索

1
2
3
4
5
6
7
8
* 动态调用搜索帮助
CALL FUNCTION 'F4IF_INT_TABLE_VALUE_REQUEST'
EXPORTING
retfield = 'CARRID'
dynprofield = 'P_CARRID'
value_org = 'C'
TABLES
value_tab = lt_values.

🔧 参数设置详解

Import vs Export

类型 作用 场景
Import 将值传入搜索帮助 参考搜索帮助,基于输入值过滤
Export 将值从搜索帮助传出 将选择的值返回到屏幕字段

位置控制

位置字段 控制范围 示例
LPos 选择列表显示顺序 1表示第一个显示
SPos 限制对话框输入顺序 1表示第一个输入字段

⚠️ 注意事项

1. 数据源选择

  • 确保数据源表或视图已激活
  • 数据源字段需要有合适的搜索条件
  • 考虑数据量对性能的影响

2. 参数设置

  • 合理设置Import和Export标志
  • 正确配置LPos和SPos顺序
  • 确保Data Element匹配

3. 性能考虑

  • 避免过于复杂的搜索条件
  • 限制返回的记录数量
  • 考虑索引优化

🎯 最佳实践

1. 命名规范

  • 使用有意义的名称
  • 遵循Z或Y前缀规则
  • 名称清晰表达功能

2. 参数设计

  • 只包含必要的搜索字段
  • 设置合适的默认值
  • 提供足够的过滤选项

3. 用户体验

  • 显示有意义的标签
  • 提供清晰的排序
  • 支持模糊查询

ABAP 用户出口

🎯 用户出口概述

用户出口(User Exits)是SAP系统中用于==增强标准功能==的机制。当标准SAP提取器不提供期望的数据或所需的功能时(例如在授权或时间检查中),可以使用用户出口。

用户出口通常用于==销售和分销(SD)模块==。SAP在销售、运输和计费领域提供了许多用户出口。



graph TD
    A[SAP标准程序] --> B{是否满足需求?}
    B -->|是| C[直接使用]
    B -->|否| D[使用用户出口]
    D --> E[自定义修改]
    E --> F[增强后的功能]

访问用户出口

要访问每个销售区域中可用的退出,使用以下路径:

IMG → Sales and Distribution → System Modifications → User Exits

SD区域中每个出口的文档将在此详细解释。

💡查找销售凭证处理的用户出口
如果要在销售凭证处理(合同、报价或销售订单)中查找用户出口,请按照上述路径继续展开 Sales → User Exits。单击文档图标以查看销售凭证处理中提供的所有用户出口。

📋 主要用户出口类型

编号 用户出口名称 说明
1 USEREXIT_FIELD_MODIFICATION 用于修改屏幕属性
2 USEREXIT_SAVE_DOCUMENT 在用户点击保存时执行操作
3 USEREXIT_SAVE_DOCUMENT_PREPARE 检查输入字段、显示弹出式窗口并确认文档
4 USEREXIT_MOVE_FIELD_TO_VBAK 将用户标题更改移动到标题工作区
5 USEREXIT_MOVE_FIELD_TO_VBAP 将用户项目更改移动到SAP项目工作区

🔍 用户出口的特点

特征 说明
功能范围 功能与客户出口相同,但==仅适用于SD模块==
实现方式 退出实现为对==函数模块==的调用
本质 用户出口是对==SAP标准程序的修改==
⚠️注意
用户出口主要是对SAP标准程序的修改,修改时需要特别谨慎,确保不影响标准功能的正常运行。

💡 示例:查找用户出口

以下程序用于查找指定事务代码中的用户出口:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
REPORT zuserexit1.
TABLES:
tstc,
tstct,
tadir,
trdir,
tfdir,
enlfdir,
modsapt,
modact.
DATA:
jtab LIKE tadir OCCURS 0 WITH HEADER LINE,
field1(30),
v_devclass LIKE tadir-devclass.

PARAMETERS: p_tcode LIKE tstc-tcode OBLIGATORY.

SELECT SINGLE *
FROM tstc
WHERE tcode EQ p_tcode.
IF sy-subrc EQ 0.
SELECT SINGLE *
FROM tadir
WHERE pgmid = 'R3TR'
AND object = 'PROG'
AND obj_name = tstc-pgmna.
MOVE tadir-devclass TO v_devclass.

IF sy-subrc NE 0.
SELECT SINGLE *
FROM trdir
WHERE name = tstc-pgmna.
IF trdir-subc EQ 'F'.

SELECT SINGLE *
FROM tfdir
WHERE pname = tstc-pgmna.

SELECT SINGLE *
FROM enlfdir
WHERE funcname = tfdir-funcname.

SELECT SINGLE *
FROM tadir
WHERE pgmid = 'R3TR'
AND object = 'FUGR'
AND obj_name = enlfdir-area.
MOVE tadir-devclass TO v_devclass.
ENDIF.
ENDIF.

SELECT *
FROM tadir
INTO TABLE jtab
WHERE pgmid = 'R3TR'
AND object = 'SMOD'
AND devclass = v_devclass.

SELECT SINGLE *
FROM tstct
WHERE sprsl EQ sy-langu
AND tcode EQ p_tcode.
FORMAT COLOR COL_POSITIVE INTENSIFIED OFF.

WRITE:/(19) 'Transaction Code - ',
20(20) p_tcode,
45(50) tstct-ttext.
SKIP.

IF NOT jtab[] IS INITIAL.
WRITE:/(95) sy-uline.
FORMAT COLOR COL_HEADING INTENSIFIED ON.
WRITE:/1 sy-vline,
2 'Exit Name',
21 sy-vline ,
22 'Description',
95 sy-vline.
WRITE:/(95) sy-uline.
LOOP AT jtab.
SELECT SINGLE *
FROM modsapt
WHERE sprsl = sy-langu
AND name = jtab-obj_name.
FORMAT COLOR COL_NORMAL INTENSIFIED OFF.
WRITE:/1 sy-vline,
2 jtab-obj_name HOTSPOT ON,
21 sy-vline ,
22 modsapt-modtext,
95 sy-vline.
ENDLOOP.
WRITE:/(95) sy-uline.
DESCRIBE TABLE jtab.
SKIP.
FORMAT COLOR COL_TOTAL INTENSIFIED ON.
WRITE:/ 'No of Exits:' , sy-tfill.
ELSE.
FORMAT COLOR COL_NEGATIVE INTENSIFIED ON.
WRITE:/(95) 'User Exit doesn''t exist'.
ENDIF.
ELSE.
FORMAT COLOR COL_NEGATIVE INTENSIFIED ON.
WRITE:/(95) 'Transaction Code Does Not Exist'.
ENDIF.

AT LINE-SELECTION.
GET CURSOR FIELD field1.
CHECK field1(4) EQ 'JTAB'.
SET PARAMETER ID 'MON' FIELD sy-lisel+1(10).
CALL TRANSACTION 'SMOD' AND SKIP FIRST SCREEN.

执行示例

处理时,输入事务代码 ME01,然后按 F8(执行)按钮。

💥使用方法
  1. 运行程序,输入要查询的事务代码
  2. 按 F8 执行
  3. 程序会列出该事务代码关联的所有用户出口
  4. 点击出口名称可跳转到 SMOD 进行查看

🏗️ SAP增强技术对比



graph TD
    A[SAP增强技术] --> B[用户出口<br>User Exit]
    A --> C[客户出口<br>Customer Exit]
    A --> D[BADI<br>Business Add-In]
    B --> B1["仅SD模块<br>修改标准程序"]
    C --> C1["模块化增强<br>函数模块调用"]
    D --> D1["面向对象<br>可多次实现<br>支持过滤器"]

特征 用户出口 客户出口 BADI
适用范围 主要SD模块 所有模块 所有模块
实现方式 修改标准程序 函数模块调用 类的接口实现
可实现次数 一次 一次 多次
SAP版本 R/3 R/3 ECC 6.0+

⚠️ 注意事项

  1. 用户出口主要用于==SD模块==,但也可在其他模块中使用
  2. 修改用户出口需要==谨慎操作==,以确保不影响标准功能
  3. 建议在修改前==备份相关代码==
  4. 用户出口的修改需要==适当的授权==
  5. 新项目建议优先使用 ==BADI== 替代用户出口

ABAP 新语法

概述

SAP S/4HANA 引入了一系列 ABAP 新语法特性,使代码更加简洁、可读和现代化。本文档详细介绍这些新语法及其与传统语法的对比。

ℹ️版本要求
部分新语法功能需要 NetWeaver 7.40+ 或 7.54+ 版本支持。

2.1 Variable in-line declaration

内联变量声明,无需预先使用 DATA 语句声明变量。

1
2
3
4
5
6
" 新语法 (NW 7.40+)
DATA(variable) = 'A'.

" 传统语法
DATA variable TYPE string.
MOVE 'A' TO variable.
💡优势
  • 减少代码行数
  • 变量类型自动推断
  • 提高代码可读性

2.2 Use build-in function

使用内置函数替代语句操作。

1
2
3
4
5
6
" 新语法 - 使用内置函数
DATA(uppercase) = to_upper( lowercase ).

" 传统语法
DATA uppercase TYPE string.
TRANSLATE lowercase TO UPPER CASE.

常用内置函数

函数 说明 示例
to_upper() 转大写 to_upper( text )
to_lower() 转小写 to_lower( text )
strlen() 字符串长度 strlen( text )
substring() 截取子串 substring( val = text off = 1 len = 2 )

2.3 += operation

简化的复合赋值运算符(>= NW 7.54 支持)。

1
2
3
4
5
6
7
8
9
10
11
" 新语法 (>= NW 7.54)
index += 1.
count -= 1.
total *= 2.

" 传统语法
index = index + 1.
" 或
ADD 1 TO index.
SUBTRACT 1 FROM count.
MULTIPLY total BY 2.
⚠️版本注意
+=、-=、*=、/= 等复合运算符需要 NetWeaver 7.54 或更高版本。

2.4 Key word NEW to instantiate object

使用 NEW 关键字实例化对象,替代 CREATE OBJECT。

1
2
3
4
5
6
7
8
9
10
11
12
" 新语法
DATA(object) = NEW /clean/my_class( ).
DATA(lo_alv) = NEW cl_gui_alv_grid( i_parent = cl_gui_container=>default_screen ).

" 传统语法
DATA object TYPE REF TO /dirty/my_class.
CREATE OBJECT object TYPE /dirty/my_class.

DATA lo_alv TYPE REF TO cl_gui_alv_grid.
CREATE OBJECT lo_alv
EXPORTING
i_parent = cl_gui_container=>default_screen.

NEW 语法优势

  • 代码更简洁
  • 类型推断更准确
  • 支持链式调用
  • 支持内联声明

2.5 Key word FOR

使用 FOR 迭代表达式替代循环,实现函数式风格的表操作。

1
2
3
4
5
6
7
" 新语法 - FOR 表达式
result = VALUE #( FOR row IN input ( row-text ) ).

" 传统语法 - LOOP 循环
LOOP AT input INTO DATA(row).
INSERT row-text INTO TABLE result.
ENDLOOP.

更多示例

1
2
3
4
5
6
7
" 带条件的 FOR 表达式
result = VALUE #( FOR row IN input WHERE ( type = 'A' ) ( row-text ) ).

" 嵌套 FOR 表达式
result = VALUE #( FOR wa_1 IN tab1
FOR wa_2 IN tab2 WHERE ( key = wa_1-key )
( value = wa_1-val + wa_2-val ) ).
💥使用场景
  • 数据转换
  • 内表过滤
  • 批量数据处理
  • 生成测试数据

2.6 READ TABLE

使用表表达式(方括号)替代 READ TABLE 语句。

1
2
3
4
5
6
7
8
" 新语法 - 表表达式
DATA(line) = value_pairs[ name = 'A' ].

" 传统语法
READ TABLE value_pairs INTO DATA(line) WITH KEY name = 'A'.
IF sy-subrc = 0.
" 处理数据
ENDIF.

处理不存在的行

1
2
3
4
5
6
7
" 使用 OPTIONAL 避免异常
DATA(line) = VALUE #( value_pairs[ name = 'A' ] OPTIONAL ).

" 或使用 line_exists 检查
IF line_exists( value_pairs[ name = 'A' ] ).
DATA(line) = value_pairs[ name = 'A' ].
ENDIF.

读取指定行

1
2
3
4
5
" 读取第5行
DATA(line) = internal_table[ 5 ].

" 使用默认值
DATA(line) = VALUE #( internal_table[ key = 'X' ] OPTIONAL ).

2.7 xsdbool to do boolean expression

使用 xsdbool 进行布尔表达式求值,简化条件判断。

1
2
3
4
5
6
7
8
9
10
11
12
" 新语法
DATA(exists) = xsdbool( line_exists( value_pairs[ name = 'A' ] ) ).
IF line_exists( value_pairs[ name = 'A' ] ).
" 处理存在的情况
ENDIF.

" 传统语法
READ TABLE value_pairs TRANSPORTING NO FIELDS WITH KEY name = 'A'.
DATA(exists) = xsdbool( sy-subrc = 0 ).
IF exists = abap_true.
" 处理存在的情况
ENDIF.

xsdbool 返回值

条件 返回值
真 'X' (abap_true)
假 '' (abap_false)

使用场景

1
2
3
4
5
6
7
8
" 在 SQL WHERE 条件中使用
SELECT * FROM mara
INTO TABLE @lt_mara
WHERE xsdbool( matnr IS NOT NULL ) = @abap_true.

" 在条件逻辑中使用
DATA: flag TYPE abap_bool.
flag = xsdbool( value > 0 ).

2.8 select BKPF-AWKEY

使用新语法进行 SQL 查询,包括 concat 函数和 @ 转义符处理复合字段。

场景说明

BKPF-AWKEY 是财务凭证表中的复合关键字段,由 BUKRS + BELNR + GJAHR 组成。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
TYPES: BEGIN OF ts_doc_key,
bukrs TYPE bkpf-bukrs,
belnr TYPE bkpf-belnr,
gjahr TYPE bkpf-gjahr,
END OF ts_doc_key,
BEGIN OF ts_doc_header,
bukrs TYPE bkpf-bukrs,
belnr TYPE bkpf-belnr,
gjahr TYPE bkpf-gjahr,
awtyp TYPE bkpf-awtyp,
awsys TYPE bkpf-awsys,
awkey TYPE bkpf-awkey,
END OF ts_doc_header.

DATA: lt_doc_key TYPE SORTED TABLE OF ts_doc_key
WITH UNIQUE KEY bukrs belnr gjahr.
DATA: lt_header1 TYPE STANDARD TABLE OF ts_doc_header
WITH EMPTY KEY,
lt_header2 TYPE STANDARD TABLE OF ts_doc_header
WITH EMPTY KEY.

方法1: 使用 concat 连接复合键

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
" 准备10个凭证键
SELECT bukrs,
belnr,
gjahr
FROM bkpf
INTO TABLE @lt_doc_key
UP TO 10 ROWS
WHERE awtyp = 'BKPF'.

" 使用 concat 连接字段匹配 AWKEY
SELECT a~bukrs,
a~belnr,
a~gjahr,
a~awtyp,
a~awsys,
a~awkey
FROM bkpf AS a INNER JOIN @lt_doc_key AS b
ON a~awkey = concat( concat( b~belnr, b~bukrs ), b~gjahr )
WHERE a~awtyp = 'BKPF'
INTO TABLE @lt_header1.

方法2: 分别匹配字段(推荐)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
" 分别匹配各字段,性能更优
SELECT a~bukrs,
a~belnr,
a~gjahr,
a~awtyp,
a~awsys,
a~awkey
FROM bkpf AS a INNER JOIN @lt_doc_key AS b
ON a~bukrs = b~bukrs
AND a~belnr = b~belnr
AND a~gjahr = b~gjahr
WHERE a~awtyp = 'BKPF'
INTO TABLE @lt_header2.

WRITE: 'Done'.
💡性能对比
方法 优点 缺点
concat 代码简洁 可能无法使用索引,性能较差
分别匹配 可以利用数据库索引,性能更优 代码稍长

推荐:在性能敏感场景优先使用分别匹配的方法。


总结

ABAP 新语法是 SAP S/4HANA 平台的重要改进,主要包括:

特性 语法 优势
内联声明 DATA(var) = value 简化变量声明
内置函数 to_upper() 代码更简洁
复合运算符 index += 1 减少冗余代码
NEW 关键字 NEW class( ) 替代 CREATE OBJECT
FOR 迭代 FOR ... IN ... 函数式风格
表表达式 table[ key ] 替代 READ TABLE
布尔表达式 xsdbool() 简化条件判断
SQL 增强 concat(), @ 更强大的查询能力
💡最佳实践
  1. 在新项目中优先使用新语法
  2. 重构现有代码时逐步采用新语法
  3. 注意版本兼容性要求
  4. 性能敏感场景需充分测试

ABAP 表

📊 表的基本概念

表的定义

表可以独立于ABAP字典中的数据库来定义。当在ABAP词典中激活表时,也在数据库中创建其字段的类似副本。

自动转换

在ABAP字典中定义的表自动转换为与数据库兼容的格式,因为表的定义取决于SAP系统使用的数据库。

表的结构

表由一个或多个字段组成,每个字段都使用其数据类型和长度进行定义。存储在表中的大量数据分布在表中定义的几个字段中。

🔧 表字段的类型

字段元素详解

编号 元素 说明 示例
1 字段名称 给字段赋予的名称,最多16个字符 CLIENT, NAME
2 键标志 确定字段是否属于关键字字段 ☑️ 主键字段
3 字段类型 为字段分配数据类型 CHAR, NUMC, DEC
4 字段长度 可在字段中输入的字符数 10, 20, 40
5 小数位数 定义小数点后允许的位数 2, 3
6 短文本 描述相应字段的含义 “客户ID”

字段命名规则

  • 长度限制:最多16个字符
  • 字符组成:数字、字母和下划线
  • 起始字符:必须以字母开头

🛠️ 在ABAP字典中创建表

步骤1:启动事务

使用事务 SE11,选择”数据库表”单选按钮,输入要创建的表名称(如ZCUSTOMERS1),点击创建按钮。

步骤2:基本信息设置

交货和维护选项卡

  1. 在简短说明字段中输入描述性短文本
  2. 点击交货类别字段旁边的搜索帮助图标
  3. 选择 “A [应用程序表(主数据和事务数据)]” 选项
  4. 从”数据浏览器/表视图维护”下拉菜单中选择”允许显示/维护”选项

步骤3:字段定义

选择字段选项卡,开始定义表字段:



graph TD
    A[表设计] --> B[字段定义]
    B --> C[字段名称]
    B --> D[数据元素]
    B --> E[键标志]
    
    C --> C1[CLIENT]
    C --> C2[CUSTOMER]
    C --> C3[NAME]
    C --> C4[TITLE]
    C --> C5[DOB]

步骤4:创建关键字段

CLIENT字段

  • 字段名称:CLIENT
  • 数据元素:MANDT
  • 设置:选中”键”框
  • 系统自动填写:数据类型、长度、小数和简短描述

CUSTOMER字段

  • 字段名称:CUSTOMER
  • 数据元素:ZCUSTNUM(需要创建)
  • 设置:选中”键”框

步骤5:创建数据元素

当数据元素不存在时,系统会提示创建:

  1. 双击新的数据元素
  2. 在”创建数据元素”窗口中回答”是”
  3. 在简短说明区域输入”客户编号”

步骤6:域的创建

基本数据类型定义

  1. 在”定义”选项卡中,点击数据类型框
  2. 从下拉菜单中选择 “NUMC” 类型
  3. 在”编号”中输入数字8
  4. 在”小数位数”区域中输入0
  5. 选择输出长度为8,按Enter键

字段标签创建

创建四个字段标签:

  • 短文本
  • 中等文本
  • 长文本
  • 标题

步骤7:保存和激活

  1. 点击保存按钮
  2. 激活对象
  3. 按F3返回维护/更改数据元素屏幕
  4. 保存并激活元素

步骤8:技术设置

从工具栏中选择”技术设置”:

设置项 选项 说明
数据类 APPL0 应用程序表
大小类别 0 第一个大小类别
缓冲选项 不允许缓冲 避免数据不一致

步骤9:最终激活

  1. 点击保存
  2. 回到表格并激活它
  3. 系统显示”表’ZCUSTOMERS1’被激活”

📝 表的创建流程总结

创建步骤图解



graph TB
    A[SE11事务] --> B[选择数据库表]
    B --> C[输入表名]
    C --> D[定义字段]
    D --> E[设置数据元素]
    E --> F[创建域(如果需要)]
    F --> G[设置技术属性]
    G --> H[保存激活]

字段创建注意事项

  1. 数据元素:每个字段必须具有数据元素
  2. 属性继承:字段从数据元素获取数据类型、长度、小数位数和短文本
  3. 键设置:关键字段必须选中”键”框
  4. 命名规范:字段名称必须以字母开头,最多16个字符

💡 表的使用场景

1. 数据存储

1
2
3
* 使用表存储数据
TABLES: scustom.
DATA: customer TYPE scustom.

2. 数据操作

1
2
3
* 读取表数据
SELECT * FROM scustom INTO TABLE lt_customers
WHERE carrid = 'LH'.

3. 表维护

1
2
3
4
5
* 维护表数据
CALL FUNCTION 'VIEW_MAINTENANCE_CALL'
EXPORTING
action = 'A'
view_name = 'ZVIEW'.

⚠️ 重要注意事项

1. 激活顺序

  • 先激活域
  • 再激活数据元素
  • 最后激活表

2. 性能考虑

  • 合理设置缓冲选项
  • 选择合适的数据类
  • 考虑表的大小类别

3. 数据完整性

  • 定义合适的主键
  • 设置正确的数据类型
  • 使用适当的约束

ABAP 模块化

🎯 模块化概述

定义

模块化是将大型和复杂的任务分解成更小和更简单的任务,每个任务放置在其单独的模块中。

模块化的优势



graph TD
    A[模块化编程] --> B[代码重用]
    A --> C[减少冗余]
    A --> D[提高可读性]
    A --> E[易于维护]
    A --> F[专注开发]

模块化的好处

  1. 开发效率:开发者可以集中精力,不会分心
  2. 代码重用:相同代码可以被多次使用
  3. 可维护性:即使是在后续维护周期中也能保持良好的可读性
  4. 调试便利:小的、模块化的代码段易于调试

🔧 ABAP中的模块化类型

1. 源代码级别的模块化

Local Macros(本地宏)

  • 在程序内部定义的宏
  • 用于重复使用的代码片段
  • 使用 DEFINE 和 END-OF-DEFINITION 定义
1
2
3
4
5
DEFINE write_header.
WRITE: / '---------------------------------'.
WRITE: / &1.
WRITE: / '---------------------------------'.
END-OF-DEFINITION.

Global Include Programs(全局包含程序)

  • 独立的程序文件
  • 可以被多个程序包含
  • 使用 INCLUDE 语句
1
INCLUDE Z_GLOBAL_UTILS.  " 包含全局工具程序

2. 处理块级别的模块化

处理块的分类

类型 调用方式 说明
事件块 从程序外部和ABAP运行时环境调用 如 START-OF-SELECTION
对话模块 从程序外部调用 如 PBO、PAI 模块
子程序 从ABAP程序内部调用 使用 PERFORM 语句
功能模块 从ABAP程序内部调用 使用 CALL FUNCTION 语句

📝 模块化源代码

源代码模块化概念

模块化源代码意味着在模块中放置一个ABAP语句序列,可以根据用户的需求在程序中调用。

源代码模块的好处

  • 增强可读性:使ABAP程序更易于理解和维护
  • 避免重复:防止不断重复写入相同的语句
  • 易于理解:使代码对于第一次阅读的人来说更容易理解

💡 模块化编程示例

1. 本地宏示例

1
2
3
4
5
6
7
8
* 定义格式化宏
DEFINE format_number.
WRITE: / &1 USING EDIT MASK '__.__.__,--'.
END-OF-DEFINITION.

* 使用宏
format_number '1234567.89'.
format_number '9876543.21'.

2. 包含程序示例

1
2
3
4
5
6
7
8
9
10
11
* 主程序
REPORT z_main_program.
INCLUDE Z_GLOBAL_CONSTANTS. " 包含常量定义
INCLUDE Z_GLOBAL_FUNCTIONS. " 包含函数定义

START-OF-SELECTION.
DATA: lv_result TYPE i.

* 使用包含的函数
lv_result = calculate_discount( 1000, 10 ).
WRITE: / 'Discount Amount:', lv_result.

3. 子程序示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
REPORT z_subroutine_example.

* 定义子程序
FORM calculate_tax USING iv_amount TYPE p
CHANGING cv_tax_amount TYPE p.
DATA: lv_rate TYPE p VALUE 0.10.

cv_tax_amount = iv_amount * lv_rate.
ENDFORM.

* 调用子程序
DATA: lv_amount TYPE p VALUE 1000,
lv_tax TYPE p.

PERFORM calculate_tax USING lv_amount
CHANGING lv_tax.

WRITE: / 'Tax Amount:', lv_tax.

🎯 模块化最佳实践

1. 模块设计原则



graph LR
    A[模块设计原则] --> B[单一职责]
    A --> C[高内聚低耦合]
    A --> D[接口清晰]
    A --> E[功能独立]

2. 命名规范

模块类型 命名规则 示例
宏 以Z开头,描述功能 Z_FORMAT_DATE
包含程序 Z_GLOBAL_前缀 Z_GLOBAL_UTILS
子程序 动词+名词 CALCULATE_TOTAL
功能模块 模块组名+功能 Z_DEMO_CALCULATE

3. 代码组织建议

  1. 按功能分组:将相关功能的代码放在一起
  2. 避免重复:提取公共代码到独立模块
  3. 文档化:为每个模块添加清晰的注释
  4. 测试独立:确保每个模块可以独立测试

⚠️ 注意事项

1. 模块大小

  • 保持模块适当大小
  • 避免过大或过小的模块
  • 确保模块功能单一

2. 依赖管理

  • 减少模块间的依赖
  • 明确模块接口
  • 避免循环依赖

3. 性能考虑

  • 避免过度模块化
  • 平衡代码复用和性能
  • 考虑调用开销
0%