event Structure: Event containing triggers to observe, conditions to test, and actions to perform.
unique IDunique ID
namestring: length 1..255
notesstring: optional, default, length 0..4048
imagestring: optional, length 1..1024
toolstring: optional, length 3..1024
behavioursarray of behaviour: optional, unique
triggersarray of trigger
actionsarray of action
access rightsarray of access rights
event is the core unit of the engine. events are self contained.
event describes of a set of triggers to observe. When any one of these triggers fires, the criteria is tested. If the criteria is met at the time of triggering, the actions are performed in sequence.
The unique ID of event is the structure's key. When manipulating or tracking individual events, use this value.
We recommend the unique ID is set to a CoreFoundation UUID using its UTF8 string representation. This ensures the event's unique ID is truely unique.
The engine indexes events by unique ID.
Is the event available to be scheduled and performed.
Setting enabled to true allows the engine to enqueue the event's triggers.
Setting enabled to false stops the engine from acting upon the event, even if the appropriate triggers fire.
name need not be unique, but we recommend it is. The name should convay the purpose of the event. Try to suggest or pick names that touch upon the cause or outcome of the event.
Notes about this event's purpose.
notes is provided to hold information about the event's purpose, intent, creator, and any other miscellaneous details that may be useful to other users. No specific format should be expected.
A Universal Image Identifer respresenting the event.
image is a Universal Image Identifer (UII). The image will be used is association with the event throughout the user interface.
Owning tool in reverse domain name format.
tool is the reverse domain named formatted identifier of the tool that created or last manipulated this event. Used to help tools identify which events they claim responsibility for. A tool with limited functionality might restrict itself to attempting to edit or show only events with a tool entry matching their own identifier.
Non-standard event behaviour.
Behaviours affect how the event is performed and allow the event to take on non-standard responses to situations such as requests to idle sleep, and parallel triggers.
Triggers determining when the event performs.
A criteria determining if the event performs.
The criteria is tested after a trigger fires. Only if the criteria is met, will the actions be performed.
Actions performed when the event is successfully triggered.
List of actions performed in sequence after one of the's event triggers has fired, and the criteria has been met.
Caller rights for the event.
Access rights lists what the caller can do to this event. The rights are specific to the caller. access rights is read only. Any access rights passed into the Scheduler will be ignored.
Back to event.