Page and Action Triggers
Page triggers allow you to use C/AL code to control the behavior of the system as a result of an event on the page, such as a page opening or a field changing its value. You typically use page triggers for advanced validation and logic.
Page triggers can be divided into three categories:
General page triggers that apply to the entire page
Field page triggers that apply to a field control on a page
Action triggers that apply to an action on a page.
Important
If you define two functions that have the same name, one defined in a page and the other in a table that is referenced by the page, you cannot invoke the function defined in the page directly. By default, a call to the function invokes the function that is defined in the table. This behavior occurs when the function is called from a source expression or a trigger.
General Triggers
The following table lists triggers that apply to the entire page.
| Page trigger name | Executed |
|---|---|
| OnInit Trigger | When the page is loaded, but before the controls are available. |
| OnOpenPage Trigger | When the page is initialized and the controls are available. |
| OnClosePage Trigger | When the page about to close and after OnQueryClosePage Trigger trigger. |
| OnFindRecord Trigger | When the page is opened and a record is retrieved from a table. |
| OnNextRecord Trigger | When the page changes from displaying one record to another record in a table. For example, on a Customer card page, this happens when a user selects Next (Ctrl+Page Down) or Previous (Ctrl+Page Up). |
| OnAfterGetCurrRecord Trigger | After the current record is retrieved from the table. |
| OnAfterGetRecord Trigger | When a record has been retrieved but not yet displayed. |
| OnNewRecord Trigger | When a new record has been initialized but not yet displayed. |
| OnInsertRecord Trigger | When a new record is about to be inserted in the table. |
| OnModifyRecord Trigger | When a record is about to be modified in the table. |
| OnDeleteRecord Trigger | When a record is about to be deleted from the table. |
| OnQueryClosePage Trigger | When the page is about to close, but before the OnClosePage Trigger. |
Field Triggers
The following table describes the triggers that are available on field controls.
| Control trigger | Executed |
|---|---|
| OnValidate (Page fields) Trigger | When the user changes the value in a field and then selects away from the field so that the field loses focus. |
| OnLookup (Page fields) Trigger | When the user requests a lookup by clicking a field's lookup button or pressing F4. |
| OnDrillDown Trigger | When the user requests a drill-down by choosing the field's drill-down button or pressing Shift+F8. |
| OnAssistEdit Trigger | When the user requests assist-edit by choosing an AssistEdit button or by pressing Shift+F4. |
| OnControlAddin Trigger | When a control add-in is initiated on a page. |
Action Triggers
The following table lists triggers that apply to actions on a page.
| Triggers | Executed |
|---|---|
| OnAction Trigger | When an action is initiated on a page. |