ABAP AT SELECTION-SCREEN 事件详解：选择屏幕校验与动态处理

AT SELECTION-SCREEN 是 ABAP 报表程序中处理选择屏幕的重要事件。它主要用于在用户输入选择条件之后、程序正式进入 START-OF-SELECTION 之前，对选择屏幕数据进行检查、补充处理，或响应用户在选择屏幕上的操作。

对于 Report 程序来说，选择屏幕通常是用户和程序之间的第一道交互入口。因此，AT SELECTION-SCREEN 经常承担“执行前检查”的角色：用户点击执行按钮、回车、触发帮助请求或选择屏幕功能后，系统会进入选择屏幕处理逻辑；如果校验不通过，可以直接返回选择屏幕，让用户重新输入。

1. 执行时机

一个常见的 ABAP Report 执行过程可以简化理解为：

INITIALIZATION.
" 显示 Selection Screen
AT SELECTION-SCREEN.
START-OF-SELECTION.
END-OF-SELECTION.

各事件的职责大致如下：

• INITIALIZATION：在选择屏幕首次显示前设置默认值。
• AT SELECTION-SCREEN OUTPUT：选择屏幕显示前执行，常用于动态调整字段显示状态。
• AT SELECTION-SCREEN：用户提交或触发选择屏幕动作后执行，常用于输入校验。
• START-OF-SELECTION：开始执行主要业务逻辑。
• END-OF-SELECTION：主数据选择结束后的收尾处理。

所以，AT SELECTION-SCREEN 通常发生在用户输入完成之后、业务逻辑真正开始之前。

2. 最常见用途：输入校验

最常见的写法是在全局 AT SELECTION-SCREEN 中检查整个选择屏幕的输入值：

PARAMETERS: p_matnr TYPE mara-matnr.

AT SELECTION-SCREEN.

  IF p_matnr IS INITIAL.
    MESSAGE 'Material不能为空' TYPE 'E'.
  ENDIF.

这段代码的效果是：

• 用户在选择屏幕点击执行。
• 系统进入 AT SELECTION-SCREEN。
• 如果 p_matnr 为空，抛出错误消息。
• 程序不会继续进入 START-OF-SELECTION。
• 用户会停留在选择屏幕上重新维护输入条件。

这里的关键点是 MESSAGE ... TYPE 'E'。错误消息会中断当前选择屏幕处理流程，阻止报表进入后续主逻辑。

3. 检查某一个字段

如果只想针对某个字段做校验，可以使用字段级事件：

PARAMETERS: p_age TYPE i.

AT SELECTION-SCREEN ON p_age.

  IF p_age < 18.
    MESSAGE '年龄不能小于18岁' TYPE 'E'.
  ENDIF.

AT SELECTION-SCREEN ON p_age 适合做字段级检查。更严谨地说，它是在选择屏幕 PAI 处理中，当参数字段内容被传递到 ABAP 程序时触发，而不是只有用户“修改过字段”才触发。

字段级校验的好处是定位更明确：如果字段校验失败，系统会让相关字段重新变为可输入状态，方便用户修正。

4. 常见事件变体

AT SELECTION-SCREEN 有多个常用变体，对应不同的选择屏幕处理场景：

实际开发中，全局校验、字段级校验、OUTPUT 动态控制和 F4 帮助是使用频率最高的几类。

5. 与 AT SELECTION-SCREEN OUTPUT 的区别

初学者最容易混淆的是这两个事件：

AT SELECTION-SCREEN OUTPUT.

和：

AT SELECTION-SCREEN.

它们的区别可以用 PBO 和 PAI 来理解：

• AT SELECTION-SCREEN OUTPUT：类似 Dynpro 的 PBO，在选择屏幕显示前执行。
• AT SELECTION-SCREEN：属于选择屏幕 PAI 处理，在用户提交输入或触发动作后执行。

OUTPUT 通常用于动态控制界面，例如隐藏字段、设置只读、控制必输状态等：

PARAMETERS: p_test TYPE char10.

AT SELECTION-SCREEN OUTPUT.

  LOOP AT SCREEN.
    IF screen-name = 'P_TEST'.
      screen-input = 0.    " 不可输入
      MODIFY SCREEN.
    ENDIF.
  ENDLOOP.

而无附加项的 AT SELECTION-SCREEN 更常用于提交后的统一检查：

AT SELECTION-SCREEN.

  IF p_test IS INITIAL.
    MESSAGE '请输入测试值' TYPE 'E'.
  ENDIF.

简单记忆：

• 显示前改界面，用 AT SELECTION-SCREEN OUTPUT。
• 提交后验数据，用 AT SELECTION-SCREEN。

6. F4 帮助示例

如果需要为某个参数自定义 F4 输入帮助，可以使用 ON VALUE-REQUEST：

PARAMETERS: p_bukrs TYPE bukrs.

AT SELECTION-SCREEN ON VALUE-REQUEST FOR p_bukrs.

  " 在这里调用自定义搜索帮助或函数模块
  " 例如 F4IF_INT_TABLE_VALUE_REQUEST

这种写法常用于字段没有合适的数据字典搜索帮助，或者需要根据业务条件动态生成可选值的场景。

7. 单选按钮组响应

选择屏幕中如果使用单选按钮组，通常用 ON RADIOBUTTON GROUP 响应该组的选择：

PARAMETERS: r_a RADIOBUTTON GROUP g1 DEFAULT 'X',
            r_b RADIOBUTTON GROUP g1.

AT SELECTION-SCREEN ON RADIOBUTTON GROUP g1.

  IF r_b = 'X'.
    " 根据选项 B 执行对应检查或状态处理
  ENDIF.

需要注意的是，单选按钮不能像普通参数一样使用 AT SELECTION-SCREEN ON r_a 做单字段事件处理，应使用单选组事件。

8. 面试常考回答

如果面试中问：AT SELECTION-SCREEN 的作用是什么？

可以这样回答：

AT SELECTION-SCREEN 是 ABAP Report 选择屏幕处理事件，通常在用户提交选择条件之后、START-OF-SELECTION 之前触发。它主要用于校验用户输入、处理字段级检查、Block 检查、单选按钮组响应，以及 F1/F4 帮助请求。如果在事件中发送 MESSAGE TYPE 'E'，程序不会继续进入主逻辑，而是返回选择屏幕让用户重新输入。

更进一步，可以补充一句：

AT SELECTION-SCREEN OUTPUT 对应选择屏幕 PBO，常用于显示前动态控制字段；无附加项的 AT SELECTION-SCREEN 对应提交后的整体检查，更接近选择屏幕 PAI 的处理逻辑。

9. 小结

AT SELECTION-SCREEN 是 ABAP Report 选择屏幕开发中非常核心的事件。它的价值不只是“校验输入”，还包括响应字段帮助、处理单选按钮组、检查 Block、控制退出命令等选择屏幕交互。

日常开发时可以按这个思路选择事件：

• 默认值初始化：用 INITIALIZATION。
• 显示前动态调整界面：用 AT SELECTION-SCREEN OUTPUT。
• 单字段输入校验：用 AT SELECTION-SCREEN ON field。
• 多字段或整屏综合校验：用 AT SELECTION-SCREEN。
• 自定义 F4/F1 帮助：用 ON VALUE-REQUEST 或 ON HELP-REQUEST。

理解这些事件的执行位置，就能更清楚地控制选择屏幕从“显示、输入、校验”到“正式执行”的完整流程。

参考资料

• SAP Help Portal：AT SELECTION-SCREEN
• ABAP Keyword Documentation：AT SELECTION-SCREEN Events
• ABAP Keyword Documentation：AT SELECTION-SCREEN Quick Reference