SAP ABAP Data Element O2EVHNAME (Event Handler Name in a BSP Page)
Hierarchy
SAP_BASIS (Software Component) SAP Basis Component
   BC-DWB-TOO-WAB (Application Component) Web Application Builder
     SO2_DBLAYER (Package) mySAP Application Server Pages: Database Layer
Basic Data
Data Element O2EVHNAME
Short Description Event Handler Name in a BSP Page  
Data Type
Category of Dictionary Type D   Domain
Type of Object Referenced     No Information
Domain / Name of Reference Type O2EVHNAME    
Data Type CHAR   Character String 
Length 30    
Decimal Places 0    
Output Length 30    
Value Table      
Further Characteristics
Search Help: Name    
Search Help: Parameters    
Parameter ID   
Default Component name    
Change document    
No Input History    
Basic direction is set to LTR    
No BIDI Filtering    
Field Label
  Length  Field Label  
Short 10 Event 
Medium 15 Event Handler 
Long 20 Event Handler 
Heading 15 Event Handler 
Documentation

Definition

There are six event handlers available in pages with flow logic:
OnCreate, OnRequest, OnInitialization, OnManipulation, OnInputProcessing, OnInputProcessing, and OnDestroy.

You have read/write access to the page attributes in all the handlers. However you can also use the following global objects:

OnCreate

This handler is called first, as soon as a page is generated. In stateful applications, it is used once only to initialize data and instantiate objects. You can access the following objects when implementing this handler:

  • Application type ref to application class

    Application class means the individual application class entered in the BSP application. If you do not enter an application class in the BSP application, then you cannot access the object application.

  • Runtime type ref to If_BSP_Runtime
  • Page_Context type ref to If_BSP_Page_Context
  • Page type ref to If_BSP_PAGE

OnRequest

This handler is called whenever there is a user request from a page (before OnInitialization or OnInputProcessing). It is used to restore internal data structures from the request - for example, in stateless applications. You can access the following objects when implementing this handler:

  • Application type ref to application class (see above)
  • Application type ref to Anwendungsklasse (s.o.)
  • Runtime type ref to If_BSP_Runtime
  • Page_Context type ref to If_BSP_Page_Context
  • Page type ref to If_BSP_PAGE
  • Request type ref to If_HTTP_Request
  • Navigation type ref to If_BSP_Navigation
  • Event_Id type String

OnInitialization
This handler is called first when processing a page. Implement data retieval in this handler, if it is needed. You can store the data in page attributes. This allows you to access the data in the layout and the remaining handlers.
You can access the following objects when implementing this handler:

  • Application type ref to application class

    Application class means the individual application class entered in the BSP application. If you do not enter an application class in the BSP application, then you cannot access the object application.

  • Runtime type ref to If_BSP_Runtime
  • Page_Context type ref to If_BSP_Page_Context
  • Page type ref to If_BSP_PAGE
  • Request type ref to If_HTTP_Request
  • Response type ref to If_HTTP_Response
  • Navigation type ref to If_BSP_Navigation

OnManipulation
This handler is used to post-process the HTTP data stream.
You can access the following objects when implementing this handler:

  • Application type ref to application class (see above)
  • Runtime type ref to If_BSP_Runtime
  • Page_Context type ref to If_BSP_Page_Context
  • Page type ref to If_BSP_PAGE
  • Request type ref to If_HTTP_Request
  • Response type ref to If_HTTP_Response
  • Request type ref to If_HTTP_Request
  • Response type ref to If_HTTP_Response

OnInputProcessing
The handler is called when the user dialog occurs. At this point you can implement input checks and trigger the navigation on the next page.
You can access the following objects when implementing this handler:

  • Application type ref to application class (see above)
  • Runtime type ref to If_BSP_Runtime
  • Runtime type ref to If_BSP_Runtime
  • Page_Context type ref to If_BSP_Page_Context
  • Page type ref to If_BSP_PAGE
  • Request type ref to If_HTTP_Request
  • Navigation type ref to If_BSP_Navigation
  • Event_Id type String

OnDestroy
This handler is executed immediately before the page instance is deleted. It includes any closing actions you want to perform on the page.
You can access the following objects in the implementation:

  • Application type ref to application class (see above)
  • Runtime type ref to If_BSP_Runtime
  • Page_Context type ref to If_BSP_Page_Context
  • Page type ref to If_BSP_PAGE

Note
Stricter ABAP syntax checks, in the context of ABAP Objects, apply to Event Handlers.

History
Last changed by/on SAP  20010130 
SAP Release Created in 50A