Workflow Events
Workflow
Events are a new concept introduced in CB-8.0, and allow to associate Workflow Actions with these types of events:
Events are a new concept introduced in CB-8.0, and allow to associate Workflow Actions with these types of events:• State Entry
• State Exit
• Field Updates
You can configure actions for specific events when customizing the State Transitions of a tracker.
State Entry
A state entry event occurs at the time of a State Transition.
To configure actions to perform in a specific status, select State Entry from the Workflow or State Transitions More... menu:
Select the State and the Actions:
Or, you can click the appropriate state in the Work flow diagram:
You can define the actions to perform On Entry.
If multiple state transitions lead to one target status and the same action should be performed for each transition, it is recommended to perform that action upon entry into the target status.
If an action should only be performed upon entering a new status from certain previous states, note the following:
• If it applies to only one status, associate the action with the transition from previous status to the new status.
• If it applies to multiple previous statuses, define a condition for the action, such as: "(Old) Status was [not] ...".
Workflow Actions associated with a state entry will be performed after the actions associated with theState Transition that leads into the status.
For example, see Start a new review.
State Exit
Workflow Actions associated with a state exit will be performed before actions associated with the State Transition that triggers the status change.
For actions that should be performed only upon assignment to certain target statuses, you can use a condition like "(New) Status is [not] ..."
Field Updates
Field updates are changes to item field values and can occur in the context of State Transitions or when an item is edited. The following are not considered field updates or workflow events:
• Comments and Attachments
• Associations
• Children
• SCM commits
To update fields in a certain item status, select Change Handler from the Workflow or State Transitions More... menu. The Change Handler screen appears.
On this screen, select the state, changes, and actions.
You can use State: *** to react to changes in any item status.
The changes are defined using a change filter, which is an extended condition that allows you to check the following:
• Whether a field value has changed: Field changed
• The old field value before the change: Field was
• The new field value after the change: Field is
A change filter must contain at least one
 | You can also use was and iswithin the condition of actions associated with a workflow event, but changed will not work within the condition. |
If the Changes dropdown list does not contain an appropriate change filter, you can define one by clicking the Add option next to it.
For example, the business value of a requirement changed to Must have:
Therefore, you can define actions to perform On Update of fields in this status.
To define the same action for the same changes in multiple statuses, you can define the action in the Change Handler for any (***) status and use an action condition such as: "Status is [not] in ...".