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.
- In synchronous execution, the call to execute the event action blocks
further processing by the subscription processor until the action completes
and returns. The action runs in the same transaction as the originating
activity on the target object. If the action fails, the transaction rolls
back.
- In asynchronous execution, the action occurs on a separate execution
thread, allowing the subscription processor to continue without waiting
for the action results. The action cannot be in the same transaction
as the originating activity.
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:
Type_CVLStr='Confidential'
where Type_CVLStr
is the symbolic name of the DocumentSensitivity
document class property, which expects a value of the String data type,
in this case Confidential.
SVCPDateTime=20040611T000000Z
where SVCPDateTime
is a property of the TimeFormat
document class, which expects a value in the DateTime data type, in this
case 20040611T000000Z
.
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:
- File/Unfile event on Folder class instance(s).
- For File/Unfile Event, the RCR is the source object, the Head property represents the containee, and the Tail property represents the container (or Folder). To apply the filter expression on the Folder class/object, set "Tail" as the filter property. Similarly, use "Head" to filter events on certain containees only.
- Publish Request Event on Document class instance(s).
- For Publish Request Event, the Publish Request is the source object of the event, and the "InputDocument" is the property of Publish Request class that represents the source document to be published. To apply a filtering condition against the source document, set the "InputDocument" for the filter property.