The <sequenceRule> element defines a rule according to the sequence pattern. The sequence rule is the only rule that allows multiple event selectors. It also requires a minimum of two event selectors.
<sequenceRule> has the following attributes:
Name | Description | Data type | Required? |
---|---|---|---|
name | Identifies the rule. This identifier must be unique within the rule block that contains this rule. It cannot contain a period. | xsd:NMTOKEN | Yes |
processOnlyForwardedEvents | Determines whether the rule receives all events or only events that are forwarded from other rules. The default value is false, which indicates that the rule receives all events, including those that are forwarded from other rules. | xsd:boolean | No |
arrivalOrder | Defines whether the events must arrive in the order in which the <eventSelector>
elements are coded for the rule. The valid values are:
|
xsd:string | No |
If the value of the arrivalOrder attribute is randomOrder, the order in which the <eventSelector> elements are coded is important. The <eventSelector> elements with the most specific event selection criteria should be coded before the <eventSelector> elements with less specific event selection criteria. Otherwise, the sequence is not detected when it should be.
<sequenceRule> contains the following elements.
The elements must be coded in the order that is shown. If an element is optional, it does not need to be coded, but all elements that are coded must follow the correct order.
Element | Required or optional? |
---|---|
<comment> | Optional. 0 or 1 occurrence is allowed. |
<variable> | Optional. 0 or more occurrences are allowed. |
<activationInterval> | Optional. 0 or 1 occurrence is allowed. |
<lifeCycleActions> | Optional. 0 or 1 occurrence is allowed. |
<eventSelector> | 2 occurrences of this element are required for the sequence rule. Additional occurrences are allowed. |
<groupingKey> | Optional. 0 or 1 occurrence is allowed. |
<timeWindow> | Required. Only 1 occurrence is allowed. |
<onDetection> | Optional. 0 or 1 occurrence is allowed. |
<onTimeOut> | Optional. 0 or 1 occurrence is allowed. |