...
- On the 'View Workflows' page, click the 'Design' link next to the workflow you wish to add a transition to. The 'Workflow Designer' page is displayed, showing your workflow's existing steps as well as the lines and labels of transitions between these steps (as shown under Using the Workflow Designer above).
- Click the appropriate 'Create Transition' button in the Workflow Designer's Main Toolbar (above), according to the type of transition line you wish to create.
- In the Workflow Design Area, click the step that will be the Originating Step of the transition.
- Click the step that will be the Destination Step of the transition. The 'Add Transition' dialog box opens.
- Choose between creating a new transition ('New Transition'), copying an existing transition ('Clone Transition') or using a 'common transition' ('Use Common Transition').
- If you choose either 'New Transition' or 'Clone Transition':
- In the 'Transition Name' field, type a short name for the transition.
This name will be shown to users as the transition link in the list of 'Available Workflow Actions' on the 'View Issue' page. - (Optional) In the 'Description' field, type a short description of the purpose of the transition.
- If you chose:
- 'New Transition', then in the 'Transition View' field, select either:
- 'No view for transition' — choose this if you do not need to prompt the user for input before the transition is executed (i.e. the transition will occur instantly when the user clicks the transition).
- The name of a screen that will be shown to users, asking for input before the transition is executed. You can choose one of JIRA's default screens or any other screen you have created. If no existing screen is suitable, you may want to create a new screen.
Many of JIRA's default screens are used in the default workflow (above) and named after the transitions they are used in (e.g. 'Start Progress' and 'Resolve Issue').
- 'Clone Transition', then in the 'Transition To Clone' field, select the transition you wish to copy.
Copying an existing transition creates a new independent copy of a transition, which does not result in a 'common transition'.
- If you choose 'Use Common Transition', select the 'common transition' from 'Transition To Reuse' and click the 'OK' button to complete the addition of your transitionan existing transition (currently used in your workflow which also leads to your Destination Step) from the Transition To Reuse dropdown list. See Using 'Common Transitionscommon transitions' (below) for details.
Please Note:
- Existing transitions in your workflow which do not lead to your Destination Step will not be available from the Transition To Reuse dropdown list.
- You can select either an existing 'common transition' or an ordinary transition (i.e. a transition that has only been used once on the workflow). If you select an ordinary transition, it will be converted to a 'common transition'.
- Click the 'OK' button to complete the addition of your transition.
...
- For common transitions, the destination step of the transition has only a subset of the remaining steps in the workflow as incoming steps.
- For global transitions, the destination step of the transition has all remaining steps in the workflow as incoming steps. Be aware that global transitions can only be deleted through the Workflow Designer (above).
You can create common transitions using the Workflow Designer by following these steps:
- Create a transition to a destination step as described in Adding a transition (above).
- Create another transition from another step to the same destination step, but in
...
- the 'Add Transition' dialog box, choose the 'Use Common Transition' option.
- In the 'Transition To Reuse' dropdown menu, select the transition you created in step 1 above.
You can edit existing common transitions in JIRA, but they cannot be created by the method via the 'View Workflow Steps' page, but as described in Adding a Transitiontransition (above). Instead, to create common transitions, they cannot be created.
If you are only able to use the 'View Workflow Steps' page to create or edit workflows, you can do either of the following to edit common transitions in a JIRA workflow:
- Copy the default workflow — the default workflow (above) contains common transitions (e.g. 'Start Progress', 'Resolve Issue', 'Close Issue'). Although you cannot edit the default workflow, you can copy it and then edit its steps and transitions (via XML) to suit your requirements.
- Create your workflow in XML — see Using XML to create a workflow (below).
...