Skip to content

ABAP Keyword Documentation →  ABAP - Reference →  User Dialogs →  Dynpros →  Statements in the Screen Flow Logic 

MODULE

Other versions: 7.31 | 7.40 | 7.54

Syntax


MODULE mod [ AT {EXIT-COMMAND|CURSOR-SELECTION} ] 
          [ ON {CHAIN-INPUT|CHAIN-REQUEST} ]
           [ SWITCH switch ].

Extras

1. ... AT EXIT-COMMAND

2. ... AT CURSOR-SELECTION

3. ... ON {CHAIN-INPUT|CHAIN-REQUEST}

4. ... SWITCH switch

Effect

The statement MODULE of the dynpro flow logic calls the dialog module mod of the ABAP program. MODULE can be used either as a keyword or as an addition of statement FIELD. When using it as an addition, the call of the dialog module depends on conditions for the dynpro fields.

As a keyword, the statement calls the dialog module mod of the respective ABAP program. At PAI time, the additions AT and ON can be used to specify conditions for the call of the dialog module.

At PBO time, any dialog module defined in the ABAP program can be called with the addition OUTPUT. At PAI, POH, and POV time, any dialog module defined with the addition INPUT can be called or without any addition. If the dialog module mod does not exist in the ABAP program, a non-handleable exception is raised. After a dialog module is processed in the ABAP program, processing of the dynpro flow logic is resumed after the position of the call, unless the dynpro processing is completed within the dialog module.

MODULE can be used as a keyword only at PBO and PAI time. At POH and POV time, MODULE can be used only as an addition of the statement FIELD .


Note

Do not mix up the statement MODULE of the dynpro flow logic with the identically named statement MODULE for defining dialog modules in the ABAP program.

Addition 1

... AT EXIT-COMMAND

Effect

Addition AT EXIT-COMMAND at the event PAI causes module mod to be called exactly if:

  • the function used to trigger event PAI has function type "E"
  • a character string starting with "E" was entered in the command field of the system toolbar and was confirmed by pressing Enter.

The dialog module is called before the automatic input checks defined in the system or in ABAP Dictionary and independently of its position in the event block. The only dynpro field transported to the ABAP program is the OK field. If the function that triggered the PAI event does not fulfill any of the above prerequisites, the statement MODULE is not executed.

If multiple statements MODULE have the addition AT EXIT COMMAND , only the first one is executed. If no statement MODULE has the addition AT EXIT COMMAND, a PAI is processed as normal: The predefined input checks are executed and then the PAI event block is processed sequentially. Provided the dynpro processing is not terminated in the dialog module mod, after the return from the dialog module, the complete PAI processing is executed. The addition AT EXIT COMMAND cannot be used with the statement FIELD.


Note

The function type of a function is determined in Screen Painter or Menu Painter. Usually those functions of the user interface are defined with function type "E" that are assigned to the icons Back, Exit and Cancel in the standard toolbar of the GUI status. Therefore, the called dialog module should terminate the dynpro processing and allow security checks, if required.

Addition 2

... AT CURSOR-SELECTION

Effect

The addition AT CURSOR-SELECTION at PAI time causes the module mod to be called only if

  • The function used to trigger event PAI has function code "CS" and function type "S"
  • The cursor is placed on a single input or output field of the screen at the moment of the user action

The call occurs within the usual PAI processing, meaning that the automatic input checks defined in the system or in ABAP Dictionary are executed and the statement MODULE is called according to its position in the event block. More specifically, the addition can be used with the statement FIELD.

If the PAI event is triggered under the above circumstances, the function code is not passed to sy-ucomm and the OK field. They keep their previous values.


Note

The function type and function code of a function are determined in Screen Painter or in Menu Painter. It is best to use the function code "CS" in Menu Painter for the function code F2 and, in this way, assign it to the double-click function of the mouse. This makes it possible to assign dialog modules to the selection of input or output fields.

Addition 3

... ON {CHAIN-INPUT|CHAIN-REQUEST}

Effect

These conditions make sense only within chains using the statements CHAIN and ENDCHAIN. They check the individual conditions ON INPUT or ON REQUEST for all dynpro fields that are specified so far within the current chain after FIELD. The dialog module is called if at least one of the dynpro fields fulfills the respective condition.

Addition 4

... SWITCH switch

Effect

If the addition SWITCH is specified, the dialog module mod is called only if the switch specified by switch has the status ON.

With switch, a switch defined in the Repository must be specified directly. If the specified switch does not exist, the dialog module will not be called.

The addition cannot be specified with the statement FIELD. There, the switch assigned to the dynpro field in Screen Painter applies.


Example

Typical structure of a simple dynpro flow logic. At PBO, a dialog module status_0100 is called to set the GUI status, at PAI, a dialog module leave_100 is called to handle functions with function type "E" and a dialog module user_command_0100 to handle the other user actions.

PROCESS BEFORE OUTPUT.
  MODULE status_0100.
PROCESS AFTER INPUT.
  MODULE leave_100 AT EXIT-COMMAND.
  MODULE user_command_0100.

The relevant ABAP program must implement the dialog modules and may have a structure like the one below. Since dialog modules do not have any local data, it is best to handle the actual editing within procedures called depending on the function code.

DATA: ok_code TYPE sy-ucomm,
      ...
MODULE status_0100 OUTPUT.
  SET PF-STATUS 'STATUS_0100'.
ENDMODULE.

MODULE leave_100 INPUT.
  CASE ok_code.
    WHEN 'BACK'.
      ...
    WHEN 'CANCEL'.
      ...
    WHEN 'EXIT'.
      LEAVE PROGRAM.
    ...
  ENDCASE.
ENDMODULE.

MODULE user_command_0100 INPUT.
  CASE ok_code.
    WHEN ...
      CALL ...
      ...
  ENDCASE.
ENDMODULE.

Continue

Module Call - Examples