Trigger

This section covers how trigger can be created and customized on the platform to trigger for operations in an application.

Overview

Trigger is a mechanism that initiates an action when an event occurs such as reaching a certain time or date or upon receiving some type of input. A trigger generally causes a workflow to be executed.

For instance, your application could execute a workflow at a specific time.

Getting started

Navigate to your Workspace > Apps and click on the gear icon to activate the configuration mode of your applications. Next, click on the gear icon of the application you wish to configure. In the Execution section you click on Trigger to access the Trigger Designer. When you open the designer, as in other designers, the management window opens with the list of all created triggers.

Trigger Designer

Using the trigger management window, you can clone or delete existing trigger or create new trigger for your application.

Trigger configuration

The trigger configuration window is divided in two sections, the trigger property fields and a section to configure the trigger.

Trigger configuration

General

General configuration define the basic properties of your trigger with some descriptive information such as name and description.

Trigger

In the trigger section, the kind of trigger is defined and the class assigned to the trigger is selected. The available trigger kinds are:

• Hook

• Time

The class selection is compulsory when creating a trigger.

Building your trigger

As mentioned before, there are two types of triggers that differ in the configuration settings.

Hook

With a hook as a trigger, an insertion method, or specifically a workflow is executed (triggered) on a particular action.

Trigger hooks

Multiple hooks can be added to each trigger. A hook consists of the properties hook kind and a list of conditions. The kind of the hook is the action that will trigger this trigger when executed. Possible actions are create, update and delete. In the list of conditions, the conditions are entered that must be fulfilled when the action is executed. If the conditions are not fulfilled, the configured workflow will not be executed either.

Time

If Time is selected as the type of hook, the start time for execution of a workflow can be selected. Also several times can be added.

Trigger time

Workflow

In the workflow tab, a workflow of the previously configured class can be selected. This workflow will be executed whenever this trigger is released. From the context menu on the right side of the selection field you can create a new workflow, edit the selected workflow and reload the list.

Trigger workflow

Validate and save

You can also check the validity of your trigger configuration by selecting the Validate option or save your current configuration by selecting Save from the bottom menu.

Validation error

Validation errors are displayed as toast notification at the top of the platform interface.

In case your trigger is invalid, the system will not allow it to be saved.