Automatic Trigger pattern

The svc_expr service can act as a client service on notifications, providing a simple pattern for one-shot or periodically triggered events.

In the example in Table 1, the notify operation is triggered 4 times with an interval of 5 seconds between each invocation.

Table 1. Automatic Trigger - Automatic fire
Example Description
<notify name="myNotify"  
  service="Sequencer"  
  clients="Expr"  
  fields="PING">  
  <prop name="expr.auto"    
    interval="5s"    
    count="4"/>    
</notify>
The myNotify operation specifies Expr as a client service.

The expr.auto property specifies that the notify operation is triggered once on service startup, and then 3 more times for a total count of 4, with a 5 second interval between each trigger.

myNotify has no expr.src content, which means a notify event is fired every time myNotify is triggered.

If the expr.auto property or either of its attributes were missing, default values would apply:
count ="-1"
The notify is triggered an unlimited number of times.
interval = "30s"
The time between two triggers is 30 seconds.

By default, a notify operation that has Expr as a client is triggered every 30 seconds.

In the example in Table 2, the state variable Value is checked once every hour while the Expr service is up. If Value is greater than 100, then a notify is fired outputting a field mapped to the Value variable.

Table 2. Automatic Trigger - Conditional fire
Example Description
<service name="Expr"  
  provision="expr">  
  <prop name="expr.state"    
    Value="NewValue"/>
</service>  

<notify name="myNotify"  
  service="Sequencer"  
  clients="Expr"  
  fields="BIG value_field">  
  <prop name="expr.auto"    
    interval="1h"/>  
  <prop name="expr.bind.out"    
    Value="value_field"/>  
  <prop name="expr.src"
    content-type="text/x-erlang"><![CDATA[
Value > 100.  
  ]]></prop>
</notify>
The Expr service specifies that Value is a state variable.

This variable has no initial value.

The myNotify operation is triggered once per hour as long as the Expr service is up.

The expr.bind.out property is used to map the Value state variable to the field value_field output by myNotify.

The expr.src expressions list consists of a single expression. This evaluates to true if the Value variable is greater than 100.

This means that myNotify, which gets triggered every hour, only gets fired if Value exceeds 100 when the operation is triggered.
Note: Do not manually type the <![CDATA...]]> delimiters. The Editor automatically renders text content as XML CDATA sections.