Use work item workflows

A Jira workflow is a set of statuses and transitions that a work item moves through during its lifecycle, and typically represents a process within your organization. Workflows can be associated with particular projects and, optionally, specific work types by using a workflow scheme.

Jira にはそのまま使用できる組み込みのワークフローがありますが、独自のワークフローを作成することもできます。組み込みのワークフローを編集することはできませんが、それをコピーし、コピーしたものを基に独自ワークフローを作成することはできます。

もう 1 つのオプションは、Atlassian Marketplace からワークフローをインポートする方法です。

 既定のワークフローの例:

ステータスとトランジション

ワークフローは次の 2 つのコンセプトで定義されます。

1. ステータス: タスクのステータスを表す、チームの作業プロセスにおけるステップ。ステータスの詳細をご確認ください。

2. Transitions: usually, how a piece of work can move between statuses. In order for a work item to move between two statuses, a transition must exist. A transition is a one-way link, so if a work item needs to move back and forth between two statuses, two transitions need to be created. The available workflow transitions for a work item are listed on the View work item screen. Transitions can also be "looped," meaning the status remains the same. These transitions are used to open transition screens so users can perform actions without setting a new status or for workflow triggers.

アクティブおよび非アクティブなワークフロー

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 work types that use this workflow.

ワークフローをアクティブ化する

すべてのワークフローは、ワークフロー スキームと関連付けられるまでは非アクティブです。ワークフロー スキームはプロジェクトと関連付けることができます。ワークフローをアクティブ化する方法は次のとおりです。 

1. Select Settings () > Work items.

2. [ワークフロー スキーム] をクリックします。

3. [ワークフロー スキームの追加] をクリックするか、アクティブなワークフロー スキームを編集します。 

4. スキームにワークフローを追加します (詳細は、「ワークフロー スキームの設定」を参照してください)。

To finish activating your workflow, associate the workflow scheme it's in with a project (if a work type is not defined in the project's work type scheme, that specific workflow is not used):

1. In the sidebar, click Work type schemes.

2. [関連付け] をクリックし、移行プロセスを開始します。

Each work item needs to have a valid status, so you may need to assign statuses to a select number of work items after you switch workflow schemes. 

A Jira project must always be associated with a workflow scheme, since all work items must move through a workflow. To disassociate a custom workflow scheme from a project, simply associate that project to the default workflow scheme instead.

ワークフローへのトランジションの追加

トランジションを追加するには、ワークフローをテキスト モードで開きます。

1. Select Settings (), then Work items.

2. [ワークフロー] を選択し、更新するワークフローで [その他] () を選択し、次に [編集] を選択します。

3. [テキスト] タブを選択し、[トランジションを追加] を選択します。

4. 詳細を入力して、[追加] を選択します。

   • あるいは、同じステータスに移行する必要のあるステータスが複数ある場合は、[トランジションを再利用] を選択します。たとえば、「未着手」、「バックログ」、「トリアージ」のステータスをすべて「進行中」に移行する必要がある場合は、3 つの異なるトランジションを作成する代わりに [トランジションを再利用] を選択できます。トランジションは複数のワークフローにまたがって使用できないことに注意してください。

トランジション ビュー フィールドで、次のどちらかを選択します。

• トランジションの画面表示なし - トランジションの実行前にユーザーに入力を促すプロンプ​​トを表示する必要がない場合（つまり、ユーザーが移行をクリックすると、瞬時にトランジションが行われる場合）、こちらを選択します。

• トランジションの実行前に表示され、ユーザーに入力を求める画面の名前 (ドロップダウン メニューから)。Jira の既定の画面、または作成した他の画面のいずれかを選択できます。既存の画面に適切なものがない場合、トランジション用の新しい画面を作成することもできます。

上記の最初の 2 つの手順に従って、ワークフローへのトランジションを編集できます。次に、

1. [テキスト] タブを選択し、[トランジション (ID)] 列で、更新するトランジションの名前を選択します。

2. [編集] を選択します。

3. トランジションの詳細を編集して、[更新] を選択します。

完了ステータスへのトランジションについては、解決状況が自動的に設定されるように事後操作を追加することもお勧めします。

ワークフローへのステータスの追加

既存のワークフローにステータスを追加する方法については、「Jira ワークフローにステータスを追加する」をご参照ください。

Add a work item action

Transitioning a work item can mean moving it to another status, or performing a "looped" transition where the transition allows you to perform an action but keep the work item in its current status. We refer to these looped transitions as work item actions. Sometimes you may just want to perform an action to a work item without moving its status through the workflow.

To add a work item action:

1. Select Settings () > Work items.

2. [ワークフロー] > 選択したワークフローの [編集] の順にクリックします。

3. [トランジションを追加] をクリックします。

4. Select a From status. If you choose Any status, your work item action will be able to be performed from anywhere in the workflow. Otherwise, it can only be from the status you choose.

5. [次のステータス] では、[Itself (それ自体)] を選択します。

6. 名前を選択し、残りの詳細についても入力します。入力完了後に [追加] を選択します。

Actions show on the work item next to the status like this:

ワークフローデザイナー

視覚的なツールであるワークフロー デザイナーによって、ワークフローのレイアウトを参照して、ワークフローのステップやトランジションを作成して編集できます。後述の機能にアクセスするには、「Jira 管理者」グローバル権限を持つユーザーとしてログインする必要があります。

ワークフロー デザイナーでは以下のことが可能です。

• ステータスとトランジションの管理: 追加、クリック＆ドラッグ、プロパティ (ワークフロー プロパティ) を選択して編集し、名前を変更または (Jira ではなくワークフローから) 削除

• グローバル トランジションを追加すると、ワークフローにある他のすべてのステータスを選択したステータスにトランジションできます。トランジションのプロパティ パネルで [すべてのステータスをこのステータスにトランジションできるようにする] を選択します。

• トランジションが使用する画面の変更。詳細は、「テキスト モードで作業する」を参照してください。

• トリガー、条件、バリデーター、事後操作などの詳細なトランジション オプションを設定します。「詳細なワークフローの設定」ページをご参照ください。

ワークフローの作成

Check out Adding and deleting a work item workflow for more information on the ways to import and create workflows. 

ワークフローの設定

Check out Editing a work item workflow for more information about editing workflow triggers, transitions, validators, and post functions.  

解決状況フィールドの設定

In Jira, a work item is either open or closed, based on the value of its resolution field (not its status).

• A work item is open if its resolution field isn't set.

• A work item is closed if its resolution field has a value (fixed or can't reproduce, for example).

This is true regardless of the work item’s current status (open or in progress, for example). If you need your workflow to force a work item to be open or closed, you will need to set the resolution field of the work item during a transition.

ワークフロー トランジション ボタンの名前の変更

If you copied the system workflow and you wish to rename the workflow transition buttons on the View work item page, you must delete the following properties from all transitions in the copied workflow:

• jira.i18n.title

• jira.i18n.description

そうではない場合は、既定の名前 (これらのプロパティの値) が引き続き使用されます。トランジション プロパティの詳細をお読みください。

テキストモードで作業する

テキスト モードはワークフローを操作する高度な方法です。また、ステップおよびステータス間の相違を確認することができます。テキスト モードでは、ステップを直接操作します。詳細は、「テキスト モードで作業する」を参照してください。

高度なワークフローの設定

「高度なワークフローの設定」ドキュメントを参照してください。