Form Events
This topic describes the Form Events, and their parameters when using JavaScript™ API in HCL Leap.
There are many events available to hook into on a form that are accessed from the forms Edit Properties dialog.
Table 1. JavaScript™ objects available in form events
Variable | Full name | Description | Example | Type |
---|---|---|---|---|
app | Application object | Contains functions for accessing global general information | app.isSingleFormView() |
GUI |
form | Form object | For accessing the pages and controlling page navigation | form.getPage('P_Page1'); |
GUI |
BO | Business Object object | Top level data object for the form. | BO.F_Username.getValue(); |
DATA |
Table 2. Form Events
Event | Description | Example |
afterSave | Called after the form is submitted or saved to the server. Changes made to the form in this event are lost, as it was already submitted. | Custom alert message:
|
beforeSave | Called just before the form is about to be submitted to the server. Any changes to data in the form are saved. | Make a field lowercase before submission:
|
onDataReceived | Applicable only when the form is hosted inside IBM® WebSphere® Portal. This event is called when the form receives data from another portlet. The data is provided with the pData parameter, which is a string containing arbitrary data passed in by portal. | Update Info Message:
|
onHide | Called after the form is hidden. | |
onDestruct | Same as onHide. Legacy event. | |
onLoad | Called after data Business Object is attached to the Form, and its values loaded into the interface, whether it is a new form or an existing form. If the form is new, this event is called after onNew. | Update the current Datetime into a Timestamp item:
|
onNew | Called when a blank form is created, and after the default values are loaded. Ideal location to pre-populate, or do first time setup of data. | Populate an item with the current user:
|
onShow | Called after the form is shown. This can occur after onNew and onLoad. | onShowActionButtons | Called after the stage action buttons are created and shown. |
validateButtonPressed | Called after every stage action button is pressed and the ID of the button is passed in as the pActionId parameter. Returning false in this event cancels the action taken by the button press. | Verify the user is cancelling:
|
Parent topic: Running Custom JavaScript – Events