SAP事件（转 感谢原创）

 

1报表过程事件

报表过程事件是在报表运行过程中由系统自动控制，按照一定次序被触发的事件，其目的是从数据库中选择数据并整理，准备进行列表输出。这些事件从报表程序启动开始就被系统顺序触发，现分述如下：

INITIATION: 初始化事件，用于程序初始化，例如选择屏幕中字段默认值的填充。

START-OF-SELECTION: 选择开始事件，如果报表中含有选择屏幕，则在选择屏幕的处理结束后触发，使报表程序的默认事件块。如果程序中部分代码不隶属于任何事件关键字，则自动被插入该事件块的初始部分。

END-OF-SELECTION:选择结束事件，如果程序中使用逻辑数据库，则在所有逻辑数据处理结束后触发。一般在该事件中输出列表。

2选择屏幕事件

如果报表需要使用选择屏幕接受用户输入，除定义选择屏幕元素之外，还需要编辑选择屏幕事件块来选择屏幕行为进行控制，与其相关的系列事件将在INITIATION之后START-OF-SELECTION之前被触发。现分述如下：

AT SELECTION-SCREEN OUTPUT :选择屏幕PBO事件，显示选择屏幕之前触发。

AT SELECTION-SCREEN。。。选择屏幕PAI事件，用户在选择屏幕中执行某些功能后被触发。该事件关键字语句包含多个附加项，可以用于控制选择屏幕状态，并对其中的用户交互进行响应。例如，当用户输入不正确的值时，给处错误消息。或是进行一些妥当性检查。

3逻辑数据库事件

如果报表中使用到逻辑数据库，则在START-OF-SELECTION事件结束后将触发数据库事件。现说明如下：

GET node 。。。选择逻辑数据库中当前级别数据中的数据。

GET node LATE 选择逻辑数据库中上一级别数据源中的数据。

逻辑数据库事件的作用也是选择并整理数据，因而也可以将其看作是一种报表过程事件。

4列表事件

在所有报表过程和选择屏幕事件结束后，系统将开始触发列表事件，这些事件块控制列表输出状态，负责处理列表过程中的交互并响应用户行为。主要有以下四种列表事件块。

TOP-OF-PAGE:页眉控制，在每个新页面开始时触发。

END-OF-PAGE:页脚控制，在当前页面结束时触发。

AT LINE-SELECTION:行选择控制，用户选择某列表行时触发。

AT USER-COMMAND : 用户交互控制，用户选择某个GUI功能时触发。

如果一个报表中定义了后两种事件之一，则称其为交互之列表，因为这种表不仅能显示列表输出，还可以根据用户的行为给出更多其他的交互式信息。

 

一般性的报表事件触发过程如下：

1          一旦用户开始运行报表过程的可执行程序，事件LOAD-OF-PROGRAM首先被触发，程序开始运行。

2          INITIALZATIONG 被触发。

3          如果程序中定义了供用户输入的选择屏幕，每次选择屏幕输出之前，事件AT SELECTION-SCREEN OUTPUT

被触发。

4          如果用户在选择屏幕中输入某些值后执行某些功能，系统将触发AT SELECTION-SCREEN。

5          之后触发START-OF-SELECTION事件。

6          如果报表中使用到逻辑数据库，则接下来触发的事件为GET和GET LATE。

逻辑数据库是一种数据源，为程序提供数据筛选和整理的方式，在逻辑数据库内部，数据条目通过循环一行一行读入程序，并可以在GET事件块内部进行处理。

7          之后执行END-OF-SELECTION事件，如有列表，一般在该事件之后输出列表，此后系统运行时环境将控制交给显示服务器。

8          然后触发页眉，页脚控制的TOP-OF-PAGE和END-OF-PAGE.

9          如果程序中定义有列表事件，则系统可以响应用户在列表屏幕中的行为，触发各种程序中交互事件。行选择交互事件（AT LINE-SELECTION）允许用户从列表中选择某行，并将触发响应的事件。如果用户选择其他子定义的功能代码（功能代码与相关菜单，按钮或键盘热键有关，又程序员在GUI状态中定义），将触发用户指令交互，即AT USER-COMMAND事件。

 

事件块的中止

事件块的中止分为有条件中止和无条件中止。

1 有条件中止 CHECK

CHEXK:如果CHECK语句中的条件为假，则系统离开当前事件并转向下一个事件块（不一定是END-OF-SELECTION）。但是如果CHECK用在事件块内部的循环语句中，则只作用于当前循环。

2 无条件中止STOP,EXIT

STOP:立即结束任何当前事件，直接转向END-OF-SELECTION.

EXIT:立即离开任何模块，直接转向列表输出屏幕，不执行END-OF-SELECTION。

 

AT SELECTION-SCREEN

（1）.其实就像一个FORM，所以在这个事件里声明的变量都是局部变量。

（2）.根据SY-UCOMM这个系统变量可以判断用户的命令

（3）.在这个事件里响应的是屏幕上选择条件中的事件，例如CHECKBOX的选择与否，RADIOBUTTON的选择，LISTBOX的选择等等。

所以分为以下几个方面：

1. ... ON field ：在PARAMETER变化时触发的事件，对于选择屏幕某字段输入的PAI事件，当该字段的值被传递给程序时被触发，可以应用于改字段本身的正确性检查，如可系统提示错误，则可以在该字段中重新输入，此时其他元素呈灰色，不接受输入

2. ... ON END OF sel ：SELECT-OPTION触发的事件,用于整个选择表输入结束后各行的检查

3. ... ON VALUE-REQUEST FOR psel_low_high ：当光标位于某屏幕字段时，选择的帮助(F4)

4. ... ON HELP-REQUEST FOR psel_low_high ：当光标位于某屏幕字段时，选择的帮助(F1)

5. ... ON RADIOBUTTON GROUP radi ：单选按钮事件，必须进行整体输入检查

6. ... ON BLOCK block ：框架的触发事件

7. ... OUTPUT ：响应屏幕上的事件，修改选择屏幕的唯一方法