Statuses and Transitions
A Status is a Resource that represents the state of an issue at a particular point in a specific workflow. An issue can be in only one Status at a given point in time.
When defining a Status, you can optionally specify properties. Read more about them in the status administration page.
Transitions¶
A Transition is a link between two Statuses that enables an issue to move from one Status to another. In order for an issue to move between two Statuses, a Transition must exist.
A Transition is a one-way link, therefore if an issue needs to move back and forth between two Statuses, two Transitions need to be created. The available workflow Transitions for an issue are listed on the View issue screen.
Status Types¶
There are five Status types:
- New - Indicates that a Topic has just been created and has not been picked up by the team.
- Cancelled - Indicates an aborted status.
- Closed - Indicates that the Status is probably the last one in the flow. By setting a Status to Closed, we are preventing the Topics in this state from being shown in most views, such as Topic lists / grids and Kanbans.
- Deployable - Means that, as part of a Transition into this Status (promote), Changeset Topics need to be deployed to one of the associated Environments. As part of the Transition out (demote), Changeset topics need to be backed-out from the environment.
- Generic -s Any other Statuses fall into this category.
Promote¶
Promote Transitions in Clarive are meant to represent Transitions to Deployable states.
Demote¶
Demote Transitions, on the other hand, generate backout Transitions, with a Rollback Job.
Changing a Topic's Status¶
Click Change Status to open a dropdown menu containing all the Lifecycle Statuses available to the current Topic.
These are listed in a logical order of progession through the Topic Lifecycle. After changing the Topic's Status, close
and re-enter the Topic in order to view the new Status in any of the Lifecycle modes.
The status menu separates transitions into two groups:
- Valid transitions appear at the top of the menu, enabled and ready to use.
- Invalid transitions appear below a separator line, grayed out. These are transitions defined in the workflow but not currently available due to permission or workflow constraints.
This separation helps users quickly identify which status changes are available without needing to click through each option.
Transition History¶
The status transitions column in topic reports and grids displays the full history of status changes for each topic. Each transition entry shows the status name, the username of the person who performed the transition, and the date.
The format is: Status Name [username - date]
For the initial creation entry, the format is: Created in Status [username - date]
This provides a complete audit trail of who moved a topic through its workflow, directly visible in the topic grid without needing to open the topic activity tab.