KUIML
Blue Cat's User Interface Programming Language
ACTION_TRIGGER

Description

This element connects an event to an action: whenever the event is triggered, the action is executed.

Inherited Attributes

See Attributes Common to All Elements.

Specific Attributes

Name Value Type Default Value Description Comment V. Exp.

event_id

event id

Empty

Identifier of the event that triggers the action.

Mandatory

2.0

No

action_id

action id

Empty

Identifier of the target action to be executed when the event is fired.

2.0

No

script

script

empty

Script to be executed when the event is fired. Replaces action_id if present.


2.0

No

condition_formula

Math Formula

empty

Mathematical formula used as a condition to execute the action (can reference any object defined in the model). The action is executed only if the formula does not return 0.

Be careful with condition formulas when using synchronous execution as the data referenced in the formula may have not been updated yet.

2.0

No

async

boolean

'false'

When true, both the action and conditions are triggered asynchronously. When false, the condition is evaluated and the action is executed synchronously, as soon as the event is triggered.

Using synchronous trigger may cause the action to be executed while parts of the data model depending on the source event has not been entirely updated. On the other hand, asynchronous trigger will happen later, so the condition may have changed (if relying for example on the state of another action).

2.0

No

Examples

See TIMER element examples.