'Changes from old value to new value' operator

This table shows the syntax for rules that use the 'Changes from old value to new value' operator:

Syntax [Attribute] [Old Value] [Operator] [New Value] [Within] [optional Condition]
Attribute One of the document attributes selected for monitoring.

See Monitor rule - value change.

Old Value A constant value for the attribute that is monitored.
Operator Changes from old value to new value
New Value A constant value for the attribute that is monitored.
Within Waiting time the monitor must evaluate value change occurrences since the document with the attribute value [Old Value] has been received by ION.
Condition (optional) A monitor condition from the list of predefined conditions.

See Monitor rule - value change.

Evaluation if Operator = Changes from old value to new value Evaluates to True if one of these conditions is met:
  • An instance of the document has occurred with the attribute value equal to [Old Value] directly followed by an instance of the document with the attribute value equal to [New Value] (without observing a time interval).
  • An instance of the document has occurred, with the attribute value equal to [Old Value], followed by an instance of the document with a different attribute value. The arrival of the second document is the start of the time interval. If an instance of the document with the attribute value [New Value] follows before the timer expires, the rule evaluates to True.

In all other situations, the rule evaluates to False.

This table shows when alerts are generated:

Document instances Alert is generated
Document instance with the attribute value equal to [Old Value], directly followed by an instance of the document with the attribute value equal to [New Value]. Yes
Document instance with the attribute value equal to [Old Value], followed by one or more instances of the document with a different value, and followed by a document instance with [New Value] within the time interval. Yes if the document instance with [New Value] occurs before the timer expires.

No if the document instance with [New Value] occurs after the timer expires.

Note: 
  • The start of the time interval is the moment the first change from [Old Value] to a different value is detected.
  • Occurrence of document instances is evaluated as they enter ION, not based on the document Creation Date Time.
  • A deviation of one minute for the time interval duration might occur based on the internal polling interval of the event management engine.

Example - Changes from old value to new value

You build a rule to verify if a new sales order is canceled within eight hours after its creation. The monitor will trigger if the sales order status changed from Open to any other status, and then the order was canceled within eight hours, or when the order was Open and then Cancelled. In the rule, you use the Status attribute from the SalesOrder document.

This table shows the syntax of the rule:

Attribute Status
Old Value Open
Operator Changes from old value to new value
New Value Canceled
Within 8 hours