Specify Additional Properties

The screen specifies the priority, initial state, and whether to include subclasses. You must also define whether the corresponding event action executes in synchronous or asynchronous mode.

 
Enabled Initial state
The subscription is enabled by default. To change the default, clear the check box . After clearing the check box, you must enable the subscription through the object's property sheet before the subscription will function.
Include subclasses
Select if you want the subscription to apply to the target object subclasses. Applies to class subscriptions only.
Synchronous
Select for the event action to run in synchronous mode. Clear to run the event action asynchronously.

CAUTION  Do not select this option for workflow subscriptions. Launching a workflow takes more time than a synchronous event can handle. A Workflow subscription must run in asynchronous mode to prevent the action from timing out before launching the workflow successfully.


Filter Expression (optional)
Optionally holds an expression evaluated against the source object, or an object referenced by an event source object, to determine whether the subscription should "fire." The expression uses the same format as the WHERE clause of a query; however, only a subset of the operators are supported. Filter expression examples:

Filter Property Name (optional)
Optionally specifies the symbolic property name, which must be a singleton object-valued property of the source object. If set, the filter expression applies to the object that property references, rather than the source itself. (For example, when adding a subscription for a "Creation Event" on an RCR object, you can specify property name "Tail" as the Filter Property. The Tail property represents the RCR relationship container. By specifying the filter property, the filter expression is evaluated against the object referenced by the filter property, i.e. the container rather than the RCR. For instance, you can specify the event to fire only when the container has a title = "accounting".)

If an invalid symbolic name is provided, the filter expression is ignored and has no effect on event firing.

There are two situations where using the Filter Property is desirable: