Set up workflow phases and transitions
This topic describes how to set up your development workflow by defining phases and how to transition from phase to phase.
ALM Octane uses phases to represent the status of an item.
For every item, you can create a workflow indicating the phases through which the item advances as the item is being developed.
Workflow is supported for any item which proceeds through development, such as requirements, defects, tests, and so on.
Shared space admin or workspace admin permissions are required.
Workflows and their phases can be defined for entities in shared spaces and individual workspaces .
This section explains how shared workflows can be customized for individual workspaces.
When defined for a specific workspace, a workflow and its phases are available for the item only in that individual workspace.
Only the workspace admin can create, modify, and delete this workflow.
When defined in a shared space, a workflow and its phases are available for the item in all associated workspaces.
In the associated workspaces, the phases are displayed with the icon, indicating that the phase is defined in a shared workflow.
|What can the shared space admin do?||What can the workspace admin do?|
The shared space admin can create, modify, and delete shared workflows, phases, and transitions.
Any changes made to the shared workflow are visible to any workspace associated with the workflow's shared space.
Workspace admins can rename phases and add phases in a shared workflow associated with their workspaces.
The workflow is still shared, but the changes made at the workspace level are available only to the one workspace where the changes are made. Only the workspace admin can see the changes made to the shared workflow.
For examples, see Shared workflows.
Shared spaces enable you to create widgets that report on information across workspaces. The resulting information is called a cross-workspace graph. Any item that meets the widget's filter criteria is included in the graph, regardless of workspace.
Even if a shared workflow has been customized for a workspace, any items whose phases were defined in the customized parts of the shared workflow are included in the graph.
Limitation: If the cross-workspace widget configuration includes phases as the x-axis value, ALM Octane ignores items whose phases were customized in a workspace. They are not included in the graph.
For details on cross-workspace widgets using the dashboard, see Workspace .
The workflow diagram contains the following items.
The phase represents a status of an item.
Different items have different sets of phases. For example, backlog item phases include New, Deferred, Opened, Fixed, Proposed closed, Duplicate, Closed, and Rejected.
Indicated by a rectangle:
If working in a workspace, an icon indicates that the phase is part of a shared workflow and defined in the shared space.
You can customize the phases for each item. For details, see Set up lists.
When you create a workflow, the first phase in the workflow is the Start phase.
Indicated by a green rectangle:
Every workflow has only one Start phase.
Inside each workflow are Metaphases.
Indicated by a label over the relevant phases in the diagram:
A metaphase lets you categorize the phases logically.
Metaphases are provided by default and cannot be modified.
Within the metaphases, you can change the order and flow of the phases or add additional phases.
Metaphases are also used in the dashboard to simplify and categorize charts and graphs.
The metaphases for backlog items and their default phases are:
If you select a phase in a shared workflow from within a workspace, the master phase field displays the original phase in the shared workflow on which changes were based. You can see the master phase field in the PROPERTIES pane on the right.
For examples, see Shared workflows.
Workflow phases are connected by transition arrows.
A primary transition is the main workflow for the item. Most items will pass through the phases of the primary path as the items are being developed.
Indicated by a solid arrow:
Each workflow has one primary transition.
|Secondary, or alternate, transition||
Transitions that are alternate workflow paths. These transitions are not essential to the primary logic of the workflow. Under certain circumstances, an item will follow the alternate path.
Indicated by a dotted arrow:
Example: Most New defects follow the primary path to the Opened phase. However, a New defect may be Deferred if there are not enough resources to handle it.
Here are some sample workflows that demonstrate the use of phases and transitions.
Here we demonstrate how to work with shared workflows. The examples below are based on the following scenario:
Our site has a shared space for a clothing division. This shared space has four workspaces associated with it:
Here is a sample workflow for the task item in the Clothing Division shared space:
The workspace admin modifies the workflow for the Men's Clothing workspace. The workspace admin adds two phases before this phase (Researching and In Design) and two phases after this phase (In Review and Testing). Because the changes are based on the In Progress phase, In Progress is the master phase.
Only workspace users for that workspace can see these changes. To these workspace users, there are now five phases between New and Completed.
Each of these five phases has the same master phase, In Progress. We can see this in the PROPERTIES pane at the right:
The master phase, and any new phases directly or indirectly added to it, are handled as one unit in the shared space and in cross-workspace graphs. In this example, Researching, In Design, In Progress, In Review, and Testing are considered one unit based on the master phase, In Progress. If a shared space graph counts the number of tasks that are In Progress, the total includes the number of tasks in these five phases.
In Settings , click Spaces and select a shared space or workspace.
Click Entities and select the item for which you want to set up the workflow.
Click Workflow. The existing workflow phases display graphically.
Modify the workflow as needed. Select a phase, and then:
Rename a phase
Enter a name in the PROPERTIES pane.
Assign a phase to a different metaphase
Enter a different metaphase in the PROPERTIES pane. In the display, the phase moves to the newly-assigned metaphase.
Describe a phase
View the read-only description in the PROPERTIES pane.
Add a phase
Right-click the phase before which you want to add a new phase. Select Add Phase.
Tip: If you add phases with similar meanings to defect and user story workflows, use the same name for the phase in both workflows. This is because, in the Backlog module, the Backlog Items tab displays defects and user stories together. The phase filter for this tab includes all workflow phases for defects and user stories. Phases with the same name are listed only once in the filter.
Indicate the phase is a start phase
Click the Start Phase check box in the PROPERTIES pane.
Indicate the transition is a primary transition
Click the Primary Transition check box in the PROPERTIES pane.
Add a transition
Right-click the phase before which you want to add a new phase. Select Add Transition. Enter the name of the target phase to which the transition should point.
Delete a phase or a transition
Right-click the phase or transition, and select the delete option.
You cannot delete a phase if it has outgoing transitions, so delete those transitions first.
You cannot delete a transition if it is the only incoming transition to a phase.
If you delete a transition that is the primary transition, it is best to clear the Primary Transition check box before deleting it and to select a different transition as the primary one.
Only shared space admins can delete phases defined on the shared space level.
Workspace admins cannot delete or modify transitions created from the workspace on a shared space workflow.
As you modify the workflow, it is refreshed automatically.
Click Save for the workflow.
You can create rules to customize workflow from the workflow diagram and also from the Rules settings area.
In this section:
You can define workflow rules for the currently-selected phase or the currently-selected transition.
In the RULES pane on the right, click + to add a rule.
The RULES pane on the right displays rules for the currently-selected phase or transition only.
Define the rule.
For details, see Set up rules.
Click Save in the RULES pane.
If you click the Rules tab at the top (not from the Rule panel), you see the rules defined for the currently-selected item, including the rules you just created from workflow.
You can add more workflow rules and modify existing workflow rules.
The Phase column in the grid shows the phases for which you created the rule. These rules do not run for any other phase.
For details, see Set up rules.
This section explains how workflow rules can be shared across workspaces and be customized for individual workspaces.
Workflow rules defined in a workspace are only available to that workspace.
Workflow rules defined for shared workflows are available to associated workspaces.
Workflow rules defined for a shared workflow can be customized for individual workspaces.
Here we demonstrate how ALM Octane handles shared workflow rules and their customization.
A shared space has the following workflow for quality stories.
New > In Progress > Done
The shared space admin defined a Block Transition rule that does not allow team members to advance the phase of a defect from In Progress to Done. Only QA testers are allowed to do this.
A workspace admin wants to customize this shared workflow. After adding the In Testing phase before the Done master phase, the customized shared workflow in the workspace looks like this:
New > In Progress > In Testing > Done
Rules with the Block transition action prevent users from transitioning from one phase to a specific phase, even though the transition is generally permitted in the workflow for the item.
When the Block Transition rule runs for the workspace, it runs only on the first phase in the unit. As a result, team members cannot advance the phase of the defect from In Progress to In Testing.
Added phases and their master phase are handled together by ALM Octane.
When workflow rules, such as Make required or Make read-only, run for the workspace, the actions are applied to each added phase and the master phase.
If the shared space admin makes the Done phase required in the shared workflow, both the In Testing and Done phases become required at the workspace level.
Note: This is not true of Block Transition rules. In this case, actions are applied only to the first phase in the unit. For details, see Block transition workflow rules.