Configuring a Task Event Type

Edit online

About this task

You can specify one or more event types for a task and associate an action that occur when the event type is triggered in the run-time environment. You can create two or more task events, and place them in different control sets; this enables you to select different event behavior for different task implementations in the run-time environment.

To configure a task event type

Procedure

  1. Open the task in the task editor by double-clicking the task in the Solutions view.
  2. Click the Events tab of the task editor and click the event you want to work with in the Events list, or double-click the event in the Events area on the Overview tab.
  3. Expand the Event Type area if it is not already visible.
  4. In the Event Type box, select the type of event you want to use. The following selections are available:
    • Select Advanced to create an expression to define a custom event type (for more information, see Configuring Advanced Task Expressions). You cannot create advanced expressions for filtering or scheduling event types.
    • The following event types define a simple change in the task: Accepted, Assigned, Canceled, Comment Added, Comment Deleted, Comment Updated, Completed, Delegated, Description Updated, Name Updated, On Error, Priority Updated, Queued, Reassigned, Resumed, Suspended, Task Deleted, and Task Updated. A matching occurrence of any of these event types triggers the event.
    • Business Data Updated — Specify a business data field from the task's business data. The event is triggered when the specified field is modified.
    • Custom ID Updated — This event triggers when the custom ID value (part of the Task Info) is updated.
    • Date/Time Event — Specify parameters to define the date/time event. The event is triggered when the specified date and time is matched. For more information about the date and time settings, see Configuring a Date/Time Event.
    • Expiration Date Reached — The event is triggered when the task's specified expiration date (part of Task Info) has occurred.
    • Expiration Date Updated — The event is triggered when the task's specified expiration date (part of Task Info) is updated.
    • Filter Inbox - Accepted Tasks — This filter shows only tasks that are accepted by this user or not yet accepted by any other user. No additional configuration or extra conditions are needed, although you can define them optionally. No actions are associated with this event type.
    • Filter Inbox - Custom Filter — Specify extra conditions to define the Inbox Filter conditions you want to apply. The condition should return true to show the task in the user inbox. No actions are associated with this event type. For more information, see Filtering a Custom Inbox with a Task Event.
    • FIlter Inbox - User Activity — This filter shows only tasks the user has not yet worked on. This filter requires the selection of a custom business data field or a service to provide a list of users who have worked on the task. You must also configure this field or service to be updated manually by the Task Details portlet or another event action. No actions are associated with this event type.
  5. If you want to define additional conditions for the selected event type, add them to the Extra conditions list as described in Configuring Simple Task Conditions.
  6. You must now define an action that will occur when the task event type is matched, as described in Configuring a Task Event Action.