The <simpleCondition> element defines a simple condition to trigger actions in a causal relationship.
The <simpleCondition> element has a role attribute, whose value shall be unique in the connector's role set. The role is a connector interface point, which is associated to node interfaces by a link that refers to the connector.
A <simpleCondition> also defines an event type (eventType attribute) and to which transition in the event state machine it refers (transition attribute). The eventType and transition may be inferred by the role value, if reserved words are used. Otherwise, the eventType and transition attributes are required.
Reserved condition role values associated to event state machines:
| Role Value | Transition Value | Event Type |
|---|---|---|
| onBegin | starts | presentation |
| onEnd | stops | presentation |
| onAbort | aborts | presentation |
| onPause | pauses | presentation |
| onResume | resumes | presentation |
| onSelection | stops | selection |
| onBeginSelection | starts | selection |
| onEndSelection | stops | selection |
| onAbortSelection | paborts | selection |
| onPauseSelection | pauses | selection |
| onResumeSelection | resumes | selection |
| onBeginAttribution | starts | attribution |
| onEndAttribution | stops | attribution |
| onPauseAttribution | pauses | attribution |
| onResumeAttribution | resumes | attribution |
| onAbortAttribution | aborts | attribution |
If an eventType value is “selection”, the role can also define to which selection apparatus (for example, keyboard keys or remote control keys) it refers, through its key attribute. If this attribute is not specified, the selection via a pointer device (mouse, touch screen, navigational keys) is assumed.
The role cardinality specifies the minimal (min attribute) and maximal (max attribute) number of participants that may play the role (that is, the number of binds) when the <causalConnector> is used to create a <link>. If the max value is greater than one, a qualifier attributeshould be specified informing the logical relationship among the simple condition binds: “or” or “and”. If the qualifier establishes the “or” logical operator, the link action will be fired whenever any condition occurs. If the qualifier establishes the “and” logical operator, the link action will be fired after all the simple conditions occurrences.
A delay attribute may also be defined for a <simpleCondition>, specifying that the condition is true after a time delay from the time the transition occurs.
| Element | Attributes | Content | Parent |
|---|---|---|---|
| <simpleCondition> | role, delay, eventType, key, transition, min, max, qualifier | – | <causalConnector> or <compoundCondition> |
| Name | Value | Description |
|---|---|---|
| role | String. | The role attribute defines a connector interface point, which is associated to node interfaces by a link that refers to the connector. The role value must be unique within the set of roles of the connector. |
| delay | The delay attribute is be specified according with one of the following syntax:
The default value is “0s”. | The delay attribute defines a time delay, from the time the transition occurs, from which the <simpleCondition> must be considered satisfied. |
| eventType | “presentation”, “selection”, or “attribution”. | The eventType attribute identifies the type of event for the action or condition. |
| key | At least the following values (case sensitive) must be accepted for the key attribute: “0”, “1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “A”, “B”, “C”, “D”, “E”, “F”, “G”, “H”, “I”, “J”, “K”, “L”, “M”, “N”, “O”, “P”, “Q”, “R”, “S”, “T”, “U”, “V”, “W”, “X”, “Y”, “Z”, “*”, ”#”, “MENU”, “INFO”, “GUIDE”, “CURSOR_DOWN”, “CURSOR_LEFT”, “CURSOR_RIGHT”, “CURSOR_UP”, “CHANNEL_DOWN”, “CHANNEL_UP”, “VOLUME_DOWN”, “VOLUME_UP”, “ENTER”, “RED”, “GREEN”, “YELLOW”, “BLUE”, “BACK”, “EXIT”, “POWER”, “REWIND”, “STOP”, “EJECT”, “PLAY”, “RECORD”, and “PAUSE”. | The key attribute identifies the selection key used for the selection. |
| transition | “starts”, “stops”, “aborts”, “pauses”, or “resumes”. | The transition attribute specifies a transition in the event state-machine used to define the condition. |
| min | Positive integer lesser than or equal to the max value. The default value is 1. | The min attribute defines the minimum number of participants that may play the role. |
| max | Positive integer greater than or equal to the min value, or the “unbounded” value. The default value is 1. | The max attribute defines the maximum number of participants that may play the role. |
| qualifier | “and” or “or”. | The qualifier attribute defines the logical relationship among the condition binds. |