--- title: "Construct Events" slug: "construct-events" status: "update" updated: 2026-04-20T07:22:18Z published: 2026-04-28T13:28:35Z canonical: "skthelp.syniti.com/construct-events" --- > ## Documentation Index > Fetch the complete documentation index at: https://skthelp.syniti.com/llms.txt > Use this file to discover all available pages before exploring further. # Construct Events Construct Events are actions that contain validation rules, business rules, or both. Validation rules run first and validate data before executing any rules. Business rules run after validation rules complete and perform an action. They can be incorporated into each page or for a specific field triggering an action or event. Events can be created to run: - **OnSave**: Also known as the OnValidate event; validates records against their data definitions when you save them after adding, updating, or deleting a record. - **OnLoad:** Executes before the page container displays, allowing for dynamic data population. - **BeforeDelete:** Executes pre-delete validation or business rules and constraints when you delete and save records. - **Custom Events in a Column**: Executes at the record level from clicking a specific field using a button or based on the value. - **Custom Events in a Toolbar Button:** Executes at the container level and supports multi-row event execution. Cloud Construct uses the Workflows feature in the Orchestrate module to run Events in the background. To view Cloud Construct-generated events (workflows), filter the Workflows by setting the Type column to Construct. These workflows are named according to the following convention: __. You can also create custom workflows in Orchestrate and include them as Events in Cloud Construct, enabling you to create various customized validation and business rules. Orchestrate workflows allows you to use features from other modules in the Syniti Knowledge Platform to create a wide range of possibilities for resolving data enrichment and construction issues in Data Migration and Data Governance use cases. Refer to [Workflow: Tasks](/v1/docs/tasks) for more information on how to create various Orchestrate tasks in a custom workflow. ## Register an Event 1. On the Cloud Construct’s home page, edit the required WebApp. The WebApp configuration page is displayed. 2. Access **Pages >** **Your Page > Grid or Form > Events** in the Tree Navigation panel and select **Add Event**. A new event is displayed as the child node for Events. 3. Click the event child node. The Details Pane is updated with the Event fields. 4. Enter the fields/properties listed in the following table as required using either form-based UI or Advanced mode: | Field/Property (Name: Type) | Description | Supported Values/Notes | | --- | --- | --- | | Event Name | Name of the event. Select the required event or double-click the newly created event to modify its name. | Enter a name that matches the button field where this event will be linked. Enter a different name for events executed via toolbar buttons. maxLength: 128 | | Event Description | Description or purpose of the event | Enter a description. maxLength: 2000 | | Pre Message | Confirmation message before running | Enter a pre-message text. maxLength: 2000 | | Post Message | Message after event completion | Enter a post-message text. maxLength: 2000 | | Active | Enable/disable event triggering | default: true | | Row Level Event | Whether event is tied to a single record | default: true | | Background Event | Whether event runs asynchronously | default: false | 5. You can register following tasks as part of an event: - [Validation Rules](/v1/docs/validation-rules-construct-preview) via SQL views or stored procedures - [Business Rules](/v1/docs/business-rules-construct-preview) via SQL stored procedures - Custom Business Rules via [Orchestrate Workflows](/v1/docs/custom-orchestrate-workflows) 6. Click **Save**. ## Event Status If a Grid or Form is tied to one or more events, the Status column/field displays the status of the last event run. When executing an event on a particular record, this column allows you to track the event's progress in real-time. Clicking a record's status value in the Status column/field displays any validation or error messages from the last event run. However, this only allows you to rerun the OnSave event. The following statuses are displayed in the Status column based on the state of the event: - **None**: Denotes that an event has not run even once. - **Preparing**: Denotes that an event is performing initial analysis to execute any dependent event tasks. - **In Progress**: Denotes that an event for the selected record is running. - **Success**: Denotes that an event for the selected record has completed successfully without errors. - **Completed with Errors**: Denotes that an event for the selected record has run successfully; however, one or more validation checks have failed. Review the validation error message, resolve the issue, and then click the status value or the event**-**configured field to rerun the event. ## Event Design Process When creating an event, a key column property must be set if the page is based on a view or if the page doesn't have a primary key. For example, a user creates an event that runs on a *Form*, but the parameter, the primary key, only displays in the *Grid*. The user must either: - Include the primary key as one of the arguments in the stored procedure (since it should be in both the *Grid* and *Form*) and then, in the stored procedure, run a select statement to get another column's value from the *Form* using the primary key. - Include the column in the *Grid* and hide it via a the Control Status column property with the Grid type. Below is a list of questions to ask to ensure that an event is fully implemented with all available and relevant features. - **Should the user be warned before executing the event?** If so, include a Pre Message, which prompts the user with an OK or Cancel option for continuing the execution of the event. Most actions that are not easily reversible should include a warning message to ensure the user does not accidentally disrupt a process when executing an event. Enter the message in the Pre Message field in the Grid’s event configuration. - **Should a Post Message be included?** Events display their message after execution. The Post Message ensures that the user always receives a confirmation that their action has completed. Enter the Post Message in the Post Message field on the Form’s event configuration. ## Related Articles - [Build Assist](/v1/docs/build-assist) - [Business Rules](/v1/docs/business-rules-construct-preview) - [OnSave Events](/v1/docs/onvalidate-events-construct-preview) - [OnLoad Events](https://skthelp.syniti.com/docs/onloadevents) - [BeforeDelete Events](/v1/docs/beforedelete-events) - [Custom Orchestrate Workflows](/v1/docs/custom-orchestrate-workflows) - [Orchestrate: Workflows](/v1/docs/workflows) - [Orchestrate: Tasks](/v1/docs/tasks) - [Validation Rules](/v1/docs/validation-rules-construct-preview) - [Working with the JSON Editor](/v1/docs/working-with-the-json-editor-1)