This allows fine grained control over the tracker item lifecycle (business processes) and associated work flow.
A customer or a test engineer can directly enter bugs into a tracker, and developers (one developer, or all belonging to a role) are automatically notified about the bug. A developer can fix the bug, associate the source code changes with the bug, and set the bug status to fixed. The source code change association with the bug is typically performed by associating a commit with the issue. Team members' project roles determine which notifications they receive in this corrective process.
The two basic elements are:
This is equivalent with the concept of a node in a graph.
This is equivalent with the concept of a directed edge in a graph.
Basically State comprises of all field/attribute values of a Tracker Item, but in this context:
the current state of a tracker item is defined by the (value of the) choice field Status,
and a State transition is really a Status transition (A value change of the Status field).
Consequently, the possible States of a Tracker Item are the defined values (choice options) of the Status field:
For example: The default Status Options for trackers of type Task:
The order of status options should reflect the position of this status in the lifecycle of the tracker items.
A value change of the Status field is called a State Transition from the old status to the new status.
If Workflow is enabled for a Tracker, then only those Status changes are allowed,
where an appropriate state transition (from old to new status) is defined
and the current user is permitted to execute that state transition.
If Workflow is not enabled for a Tracker, then the tracker items still have a Status, but there is no control
which status changes are allowed
and who can make them.
The (allowed) state transitions for items of a specific Tracker are defined on the State Transitions tab of the tracker's configuration screen. E.g.:
Check the "Show obsolete states" to see all states.
If a state is obsolete then the name contains the "(Obsolete)" suffix.
State transitions can be Hidden, which means they will not occur in the Next Steps/Transitions menu, but are still valid status changes.
The names of hidden transitions will be shown in gray instead of blue (see Approve and Reject in the screenshot below).
To Edit an existing state transition, either click on the transition name, or choose Edit from the context menu:
To Delete a defined state transition, choose Delete from the context menu.
The optional Condition defines, in which context/for which tracker items the transition is applicable at all.
The only available default Condition is:
which allows to define a formula/expression (see Calculated Issue Fields), that will be evaluated against a tracker item, and that must yield true or false, whether or not this transition is applicable for this item.
For example: Only allow this transition, if the Story Points field of the item has a value less than 7:
storyPoints < 7
Since CB-7.9.2, there is an additional default condition: Leads back to previous item status
that will only allow this transition, if it leads back to the previous status of the subject item.
The typical use for this condition is for transitions out of special parking states, where multiple transitions lead into this state and there are also multiple transitions out of this state, and you want to restrict an outgoing transition to only be applicable, if the state was entered via a transition in the opposite direction.
If you need conditions, that exceed the expression language capabilities or need to consider other context information like
the HttpServletRequest (to check region, locale or user agent)
or the current user (to check other user attributes, than the transition permissions, which have already been checked before checking the condition)
then you can implement a custom condition. See instructions here.
Each transition can be associated with a Guard, that will only let pass the transition, if the subject tracker item matches specific criteria.
A transition guard is a tracker view, whose Condition will be evaluated against the tracker item, which is the subject of the state transition.
The Guard selector shows all available tracker views in the current context.
If no suitable guard/view exists yet, you can create a new one, by right-clicking on the guard selector and choosing New from the context menu:
The new guard will be stored as a tracker view of type Table with the configured Condition and DefaultColumns and Sorting.
You can edit the currently selected guard, by right-clicking on the guard selector and choosing Edit from the context menu.
Guards evaluate stored field values which may differ from what is rendered on the user interface. For example, wiki content is stored as its markup code potentially containing formatting and escape characters. That has to be taken in account when defining guard conditions.
Since CB-7.8, multiple Workflow Actions can be associated with a state transition.
The Fields to Update from older CodeBeamer releases are now also actions: