Page Events

Description

Displays the page name associated with the event.

Note

The field displays if accessed from the WebApp Vertical View Import / Export tab.

Displays the event that runs on the page, or the name of the field that triggers the event rule to run.

Event rules can be created to run:

• OnLoad – Executes prior to the page displaying, allowing lazy data population.

• OnValidate – Executes when a record is saved or the user clicks the boaStatus icon.

• BeforeDelete – Executes before a record can be deleted.

Indicates that this event is active.

Click to open the Page Validation Rules page to add and edit a validation rule. Validation rules run before business rules and validate data based on certain conditions.

Click to open the Page Business Rules page to add and edit a Business rule. Business rules run after validation rules complete. Business rules execute based on whether validations pass or fail.

Description

Event Description

Displays the name of the page. This value is populated from the DESCRIPTION field on the Page's page and is not editable.

Displays the event that runs on the page, or the name of the field that triggers the event rule to run.

Event rules can be created to run:

• OnLoad – Executes prior to the page displaying, allowing lazy data population.

• OnValidate – Executes when a record is saved or the user clicks the boaStatus icon.

• BeforeDelete – Executes before a record can be deleted.

Messages

Displays the message that appears before running this event and prompts the user with a confirmation message to continue. Most irreversible or not easily reversible actions should include a Pre Message to ensure the user doesn’t accidentally disrupt a process. If the Pre Message is not specified, then the user will not receive a message that the process is about to occur.

Displays the message that appears when this event finishes processing.

Events display their message after execution. This ensures that the user always receives a confirmation that their action has completed.

If the Post Message is not specified, then the user will not receive a message that the process has completed.

Comments

Displays comments entered by the user.

Description

Displays the method in which the event is executed. There are three options:

• Disabled – This option provides the least likeliness of a deadlock as well as fastest execution time. However, when running a series of procedures, an error in one will not result in a rollback of the previous procedures. This could potentially leave the database in an unstable state, if these procedures are not idempotent.

• Enabled – This option provides the functionality of rolling back in the event of an error. This rollback is applied per Execution Groups, which are formed by sequential sets of stored procedures. For example:

  1. Three stored procedures run.

  2. An External Page runs.

  3. Three more procedures run.

  This results in two Execution Groups (first three, and last three). In the event a procedure within one of the Execution Groups fails, any other procedure that has been run within that group is undone. This setting carries the highest potential of deadlock. A failure within an Execution Group does not cause any other execution groups to roll back.

• Serialized – This option is similar to Enabled, with the added locking at the Page Event level. When this option is chosen, each event invocation will ensure exclusive execution of the underling Page Events rules. This option reduces the number of procedure related deadlocks occurring, but can lead to event lock related timeouts if several users are attempting to execute the same event simultaneously.

  Note

  This option must not be used if the column property supports multi-row action.

Displays whether the user is navigated back to the previous page or to the page’s Vertical View after the Event rule(s) finishes processing.

For example, the Page Designer sets this option to Back in cases where the user may be expected to navigate to a second page, click a particular button, and then be sent back to the previous page where that event has affected the previous record.

The Page Designer sets this option to Vertical in cases where an action on the Horizontal View results in information that must display to the user on the Vertical View.

Displays the level at which the event is run, either at the page level or against a specific record on the page. The default and most commonly used Event Level is Row, which passes the row information to the event.

Page level execution is only supported for toolbar buttons defined from the Toolbar view for the page. It does not pass row-level information to the event. If a toolbar button is set to page-level event, the button can be clicked when there are no records on the page.

Note

When the event is OnLoad, the only option in this list box is Page.

If checked, the Bulk Execution feature is enabled on the page and the Bulk Execution tab is visible.

Bulk Execution is the ability to run an event on a Syniti Construct page for all records or a subset of those records via a simple, guided user experience.

Note

Bulk Execution is only available for On Validate events.

Refer to Use Bulk Execution and Configure Bulk Execution for more information.

Web App Event Properties

If checked, this Event can be called via a business rule from a page in any WebApp. The page’s keys are inserted into the Page Event Parameters as the initial parameters.

Note

If unchecked, the Parameters icon is not active.

Displays whether the Event runs on the Horizontal or Vertical View.

Click to open the Page Event Parameters page, where a user can view, add and edit parameters required to call this public WebApp Event. At a minimum, these include the primary keys for this table.

Note

Parameters can be set for Public events only. The Public check box must be checked for this icon to be active.

Description

If checked, any business rules registered to the OnValidate event are not run. The Exclude Business Rules check box on the Bulk Execution panel is checked.

If unchecked, business rules registered to the OnValidate event run by default, and the Exclude Business Rules check box on the Bulk Execution panel is unchecked.

If checked, the Exclude Business Rules check box on the Bulk Execution panel is checked, and the user cannot update it.

If unchecked, the user can update the Exclude Business Rules check box on the Bulk Execution panel.