Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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. |