ワークフローの設定
A JIRA workflow is the set of statuses and transitions that an issue goes through during its lifecycle.
Workflows typically represent business processes.
On this page we'll learn about:
JIRA ships with a built-in workflow called jira, which is the default system workflow. It cannot be edited, however you can copy this workflow to quickly start creating your own workflow. You can also create your own workflows from scratch, or import workflows from Atlassian Marketplace. You can associate each workflow with particular projects and, optionally, specific issue types, by using a workflow scheme.
This is JIRA's default workflow:
ステータスとトランジション
A status 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.
トランジションは、課題をあるステータスから別のステータスへ移動できるようにする、2 つのステータス間のリンクです。課題が 2 つのステータス間を移動するためには、トランジションが存在する必要があります。
A transition is a one-way link, so 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.
アクティブおよび非アクティブなワークフロー
There are slight differences between editing an inactive and an active workflow. We place restrictions on the modifications you can make to an active workflow, due to the impact the changes will have on projects and/or issue types that use this workflow.
Inactive
非アクティブなワークフローとは、現在どのプロジェクトでも使用されていないワークフローを指します。非アクティブなワークフローではトランジション中の課題は存在しないため、ワークフローのステップやトランジションを直接編集できます。詳細は、「テキスト モードで作業する」を参照してください。
Note that by default, inactive workflows are hidden at the bottom of your Workflow page. Expand the link to view them.
アクティブ
An active workflow is a workflow that is currently being used by one or more projects.
When you edit an active workflow, JIRA first creates a draft of it, that you can then modify as you see fit. When you've finished, you can publish your draft and, optionally, save your original workflow as an inactive backup.
アクティブなワークフローの下書きを編集する場合、以下の制限事項が適用されます。
- ワークフローがアクティブな場合、ワークフローの名前を変更することはできません (説明は変更可能)。
- ワークフローのステータスは削除することができません。
- ステータスが送信トランジション (グローバル トランジションは考慮されません) を持たない場合、新しい送信トランジション (通常またはグローバル) を追加することはできません。
- The step ID cannot be changed. See (Archived) Cannot Add Transitions or Delete Steps in Draft Workflows.
To make any of the modifications listed above, you need to copy the workflow (see Creating a workflow), modify the copy and then activate it.
ワークフローデザイナー
Workflow designer is a graphical tool that allows you to see the layout of your workflow and to create and edit a workflow's steps and transitions.
The JIRA workflow designer looks like this:
The workflow designer allows you to:
- Add a status or transition.
- Click and drag a status or transition to reposition it.
- Select a status or transition to edit its properties, rename it, or to delete it (from the workflow but not JIRA), from the properties panel. As status names are stored on the global level, renaming one would affect all of JIRA immediately, even if the workflow draft is not published.
- ワークフロー内のすべてのステータスが対象のステータスに遷移する、グローバル トランジションの追加。トランジションのプロパティ パネルの「すべてのステータスがこのステータスに遷移することを許可する」を選択します。
- トランジションが使用する画面の変更。詳細は、「テキスト モードで作業する」を参照してください。
- Configure advanced transition options, such as triggers, conditions, validators and post functions. See the Advanced transition configuration page.
- Set properties for a status or transition. Please see Workflow properties for details.
Workflow designer tips
- Statuses are global objects in JIRA. Changing the name of a status on one workflow also changes the name of the status on all workflows that use that status.
- トランジションまたはステータスにカーソルを合わせ、該当するトランジション ラベルを参照します。
- Zoom the diagram with your mouse wheel. Pan the diagram by clicking and holding the mouse while on white space, then moving your mouse across the diagram.
- ワークフロー デザイナーでトランジションを複製することはできません。
- ワークフロー デザイナーで注釈を作成することはできません。
- You cannot directly set the
issue.editableproperty. To do this, simply add theissue.editableproperty to the status properties.
Creating a new workflow
There are a few ways you can start a new workflow to work on:
既存のワークフローを複製する
- Log in as a user with the JIRA Administrators global permission.
- Choose
> Issues. Select Workflows to open the Workflows page, which displays all of the workflows in your system.
- Copy an existing workflow using the Copy link in the Operations column (shown above).
- Enter a name and description for your workflow.
- Click the Copy button. The workflow opens in edit mode.
Once you have created your new workflow, you may customize it by adding or editing steps and transitions.
When you have finished customizing your workflow, see Activating workflow for details on how to use it with a JIRA project.
新しいワークフローの作成
高度な管理を行う場合
- 左側のナビゲーション パネルから [ワークフロー] をクリックし、画面上部の [ワークフローの追加] を選択します。
- Enter a name and description for your workflow. Click Add.
The workflow opens in edit mode and contains a step called Open and an incoming transition called Create. - ステップやトランジションを追加および編集して、ワークフローをカスタマイズします。
ワークフローのインポート
Please see the documentation on Importing from Atlassian Marketplace.
ワークフローの設定
プロジェクトのワークフローを編集する
Whenever you create a new JIRA project, your project automatically uses the default workflow scheme. The scheme associates all available issue types in the project with the JIRA system workflow. Since neither the JIRA system workflow nor the default workflow scheme are editable, JIRA creates an editable copy of the system workflow and workflow scheme for your project.
To begin editing your project's workflow for the first time:
- Log in as a user with the JIRA Administrators global permission.
- Choose
> Projects, and click the name of a project. - On the Administration page for the project, click Workflows.
- Click the 'edit' icon at the top-right of the box.
JIRA automatically does the following:
- "プロジェクト名 ワークフロー (ドラフト)" という名前で、システム ワークフローのコピーを下書きとして作成します。
- "プロジェクト名 ワークフロー スキーム" という名前で、ワークフロー用にワークフロー スキームを作成します。
- プロジェクト内の既存の課題を新しいワークフローに関連付けます。
これで下書きワークフローを編集できます。ステータスまたはトランジションをクリックして、表示されたパネルで編集オプションを確認します。
完了したら、[ドラフトの公開] をクリックします。このダイアログで下書きを公開し、任意で元のワークフローを非アクティブなバックアップとして保存できます。
Usage notes:
- If you have only a small number of existing issues in your JIRA project, this process is relatively quick.
- If you have many (e.g. thousands of) existing issues in your JIRA project, this process may take some time.
- Once this process begins, it cannot be paused or cancelled. Please avoid editing or transitioning any issues within your project while this process is taking place.
Setting the Resolution field
In JIRA, an issue is either Open or Closed, based on the value of its Resolution field — not its Status field!
- An issue is Open if its Resolution field has not been set.
- An issue is Closed if its Resolution field has a value (e.g. Fixed, Cannot Reproduce).
This is true regardless of the current value of the issue's Status field (Open, In Progress, etc).
Therefore, if you need your workflow to force an issue to be Open or Closed, you will need to set the issue's Resolution field during a transition. There are two ways to do this:
- Set the Resolution field automatically via a post function.
- Prompt the user to choose a Resolution via a screen. See Working in text mode for details on this.
ワークフロー トランジション ボタンの名前の変更
If you copied the system workflow and you wish to rename the workflow transition buttons on the View issue page, you must delete the following properties from all transitions in the copied workflow:
jira.i18n.titlejira.i18n.description
削除しない場合、既定の名前 (これらのプロパティの値) が引き続き使用されます。トランジション プロパティについての詳細をお読みください。
テキストモードで作業する
テキスト モードはワークフローを操作する高度な方法です。また、ステップおよびステータス間の相違を確認することができます。テキスト モードでは、ステップを直接操作します。詳細は、「テキスト モードで作業する」を参照してください。
Jira を使いこなす
Atlassian Marketplace の人気のあるワークフロー アプリを使用することで、さらに多くのワークフロー構成方法を利用できるようになります。