Page Event Parameters
  • 01 Apr 2024
  • 4 Minutes to read
  • Contributors
  • Dark
    Light

Page Event Parameters

  • Dark
    Light

Article Summary

Page Event Parameters H

Page Event Parameters V

Note

Use this page to Set Parameters for a Public WebApp Event.

To access this page:

  1. Select Admin > WebApps from the Navigation pane.

  2. Click Pages for a WEB APP NAME.

  3. Click Events for a page.

  4. Click Vertical View for an event.

  5. Click the Advanced Properties tab.

  6. Click the Parameters icon.

To access this page as part of Import / Export:

  1. Select Admin > WebApps from the Navigation pane.

  2. Select a WebApp and click the Vertical View icon.

  3. Click the Import / Export tab.

  4. Click the Page Event Parameters icon.

Note

The Parameters icon is active if the Public check box is checked on the Page Events page’s Vertical View.

Field

Description

PAGE ID

Displays the page name associated with the business rule.

Note

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

EVENT

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.

Note

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

PRIORITY

Displays the sort order on this page to indicate the parameter’s relative importance or logical grouping. The priority order is used when aligning values from another event to call this event. The framework auto-inserts the table’s key fields in their order from the table, and/or the page’s column properties marked as keys. Commonly, higher priority parameters are specific to other business rules, such as plugins or procedures that expect other row data.

PARAMETER NAME

Displays the name of the parameter passed by a WebApp to run this Public event. The key(s) fields on the table upon which the page is based are included by default if the Public check box on the Page Events page has been checked.

PARAMETER TYPE

Displays whether the parameter is a key field on the table when executing this public event and must be passed or is optional. Options are:

  • Required – A value for this parameter must be passed to the event

  • Key – The value passed for this event must be a key(s) value. This value is also required, but is treated as a key field, not a data field, during event execution.

  • Optional – A value for this parameter could be passed to the event, but it is not required.

Note

The value selected is displayed to a developer, when setting up an event to call this public event from another page.

DESCRIPTION

Displays a description of the parameter.

Page Event Parameters V

Page Event Parameters H

Field

Description

Page ID

Displays the page name associated with the business rule.

Note

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

Event

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.

Note

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

Priority

Displays the sort order on this page to indicate the parameter’s relative importance or logical grouping. The priority order is used when aligning values from another event to call this event. The framework auto-inserts the table’s key fields in their order from the table, and/or the page’s column properties marked as keys. Commonly, higher priority parameters are specific to other business rules, such as plugins or procedures that expect other row data.

Parameter Name

Displays the name of the parameter passed by a WebApp to run this Public event. The key field(s) on the table upon which the page is based are included by default if the Public check box is checked on the Page Events page's Vertical View.

Parameter Type

Displays whether the parameter is a key field on the table when executing this public event and must be passed or is optional. Options are:

  • Required – A value for this parameter must be passed to the event

  • Key – The value passed for this event must be a key(s) value. This value is also required, but is treated as a key field, not a data field, during event execution.

  • Optional – A value for this parameter could be passed to the event, but it is not required.

Note

The value selected is displayed to a developer, when setting up an event to call this public event from another page.

Description

Displays a description of the parameter.

Advanced Properties

Note

Configuring the fields in this section will present the user with a list box with the options entered below on the page's Vertical View. These options are used when they are configuring the page to call this public WebApp event.

List View

Displays the name of the view in SQL that contains the values and displays fields for a list box if the values for a list box must be passed to the event.

List Value Field

Displays the name of the field that stores the value. In most cases, List Value Field is the primary key stored in the table. Refer to Add List Boxes and Combo Boxes for more information.

List Display Field

Displays the option visible in the List Box or Combo Box. Refer to Add List Boxes and Combo Boxes for more information.


Was this article helpful?