Jira Cloud のワークフローに関してご案内します

※2024 年 5 月時点の情報です

1 ワークフローとは
2 ステータスとは
3 トランジションとは
4 ワークフロー設定
5 ワークフロースキーム
- 5.1 ワークフロースキームを設定しプロジェクトと紐づける
- 5.2 ワークフロースキームを切り替える
6 チーム管理対象プロジェクト向けの情報

ワークフローとは

Jira Cloud では、課題の作成から完了までの一連の流れをワークフローと呼びます。作業のステップを「ステータス」として可視化し、ステータス間の導線を「トランジション」と呼びます。

トランジションには、作業の差し戻しや特定のユーザーの承認が必要なステップ、特定のユーザーのみに作業権限を与えるなどのさまざまな条件を設定できます。

全ての作業ステップが終了してステータスが「クローズ」になると、作業（課題）の完了を意味します。

ステータスとは

ステータスとは、プロジェクト内で管理している作業のステップ（現在の位置）のことを表します。プロジェクト作成時に既定のステータスを持つデフォルトワークフローが作成されます ^※1。
ステータスはチームの要件ごとに自由にカスタマイズできます。
また、ステータスのカテゴリは以下の 3 種類に分類されます。このカテゴリに沿って、必要なステータスを作成してください。

カテゴリ

カテゴリ
着手前 TODO
進行中 IN PROGRESS
完了 DONE

※1：各 Jira シリーズやプロジェクトテンプレートによって既定のステータスは異なります。

ステータスを作成する際は汎用的なネーミングにして重複を避けてください。ダッシュボードやレポートで集計する際の材料として使用します。

トランジションとは

「トランジション」とはステータス間を遷移する際の導線のことで、実行条件や処理を設定することが可能です。この機能には複数カテゴリが存在し、用途が異なります。これらの背景を理解すると設定時の理解がぐっと深まりますので是非ご確認ください。

カテゴリ	用途	例

カテゴリ	用途	例
トリガー	開発ツール^※2を連携し、開発ツール側でのアクションをきっかけに Jira 課題を動作させる ※2：Bitbucket Cloud、GitHub など https://support.atlassian.com/ja/jira-cloud-administration/docs/configure-workflow-triggers/	連携開発ツールでソースコードのコミット / ブランチ作成後などに Jira 課題のワークフローを自動で更新する
条件	トランジション実行前の値が正しいか確認する（トランジション実行ユーザを制御する）	課題起票は” ロール A ”のみ許可する（マネージャーのみ許可、営業のみ許可など）
検証（バリデーター）	トランジション実行後に値が正しいか確認する（トランジション実行条件を制御する）	特定フィールドの値が期待値通り（入力有無 / 特定の値など）の場合のみトランジションを実行する
事後操作	トランジション実行後に必要な内部処理を行う	課題フィールドを特定の値に更新する特定の課題に担当者を割り当てる特定の課題にコメントを付与する課題の変更履歴を更新し、データベース（クラウド）に登録する

ワークフロー設定

抑えておきたいポイントと設定方法をご案内します。

アクティブワークフロー or 非アクティブワークフロー

Jira Cloud のワークフローは ” アクティブ状態 ” と ” 非アクティブ状態 ” の 2 種類存在します。
まずは ” 非アクティブワークフロー ” を用意して編集するところから始めましょう。

カテゴリ	概要

カテゴリ

概要

非アクティブワークフロー

まずはここから

どのプロジェクトでも使用されていないワークフロー
ワークフローを自由に編集できる

アクティブワークフロー

1 つ以上のプロジェクトで使用されているワークフロー
※編集を誤ると運用中のプロジェクトに支障をきたす可能性があります。
編集範囲に制限がある
- https://support.atlassian.com/ja/jira-cloud-administration/docs/work-with-issue-workflows/#Active-and-inactive-workflows:~:text=%E3%81%95%E3%82%8C%E3%81%BE%E3%81%99%E3%80%82-,%E3%82%A2%E3%82%AF%E3%83%86%E3%82%A3%E3%83%96%E3%81%8A%E3%82%88%E3%81%B3%E9%9D%9E%E3%82%A2%E3%82%AF%E3%83%86%E3%82%A3%E3%83%96%E3%81%AA%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC,-%E9%9D%9E%E3%82%A2%E3%82%AF%E3%83%86%E3%82%A3%E3%83%96/ ^{※「アクティブおよび非アクティブワークフロー」をご参照ください}

ワークフローを設定する

ワークフローの設定～運用までに必要な工程は以下となります。本ドキュメントでは、以下の流れに沿ってご案内します。

カテゴリ	設定

カテゴリ	設定
ワークフローを設定する	編集用ワークフローを用意する
	ステータスを設定する使用しないステータスを削除する使用するステータスを追加するステータスを編集する
	トランジションを設定するトランジションを追加・編集する必要に応じてトランジションに追加条件を設定する　高度な設定トリガー条件検証（バリデーター）事後操作
ワークフロースキームを設定する	課題タイプとワークフローを関連付けてまとめ、プロジェクトと紐づける

1：編集用ワークフローを用意する

デフォルトワークフローを複製して「ダイアグラム」^※3 で編集する例をご案内します。

^{※3：ワークフローの表示形式を図 or テキストで選択できます。図で表している形式を「ダイアグラム」と呼びます。}

https://support.atlassian.com/ja/jira-cloud-administration/docs/add-and-delete-an-issue-workflow/

2：ステータスを設定する

デフォルトワークフローを編集して、以下のステータスを準備する設定例をご案内します。

必要なステータス	ステータスの状況と要件

必要なステータス	ステータスの状況と要件
BACKLOG	課題起票後かつ作業前の課題全てのステータスから遷移できる課題
IN PROGRESS	作業中の課題
IN REVIEW	作業が完了し、レビュー中の課題
DONE	レビューが完了し、クローズした課題

既定のステータスが設定された初期状態のワークフロー（Jira Cloud のカンバンテンプレートの場合）は以下構成です。ここからカスタマイズしていきます。

2-1：使用しないステータスを削除する

初期状態のワークフローを確認し、チームの運用では使用しないステータスを削除しましょう。

2-2：使用するステータスを追加する

初期状態のワークフローには含まれていないが、チームで運用したいステータスを追加しましょう。

2-3：ステータスを編集する

ステータス設定を編集することができます。編集可能項目は、全てのステータスから遷移するか否か / ステータス名 / ステータスカテゴリなどです。

3：トランジションを設定する

3-1：使用するトランジションを追加・編集する

初期状態のワークフローには含まれていないが、チームで運用したいトランジションを追加・編集しましょう。また、作成したトランジションは再利用することも可能です。是非ご確認ください。

3-1-1：新しいトランジションを作成する

新しいトランジションを作成しましょう。

3-1-2：作成済のトランジションを再利用する

終点のステータスが同じトランジションは再利用することが可能です。
例えば、BACKLOG / IN PROGRESS / IN REVIEW / DONE の 4 つのステータスが存在するワークフローが存在したとします。この時、” BACKLOG ” から ”IN PROGRESS” に遷移するトランジションを ” 作業開始 ” にして作成しておくと、 ” IN PROGRESS ” より先の ” IN REVIEW ” で作業の差し戻しがあった際に、
” IN REVIEW ” → ” IN PROGRESS ” も ” 作業開始トランジション ” が流用できます。設定時間を短縮できる機能ですので、是非ご確認ください。

3-2：必要に応じてトランジションに追加条件を設定する　高度な設定

トランジションの「条件」を ”Developer ロール” のみに設定にする例をご案内します。

https://support.atlassian.com/ja/jira-cloud-administration/docs/edit-an-issue-workflow/
https://support.atlassian.com/ja/jira-cloud-administration/docs/configure-advanced-issue-workflows/ ^{※各カテゴリのトランジション追加条件が記載されています}
https://www.ricksoft.jp/blog/articles/001458.html

https://www.youtube.com/watch?v=P3kFYnFqXK8

ワークフロースキーム

Jira Cloud には「ワークフロースキーム」という概念があり、任意の課題タイプと特定のワークフローを関連付けてセットにします。課題タイプごとにそれぞれ異なるワークフローを紐付けることも可能です。課題タイプとワークフローのセットは他のプロジェクトで流用できます。

ワークフロースキームを設定しプロジェクトと紐づける

プロジェクト作成時に該当プロジェクト用のワークフロースキームが自動で作成されます。このワークフロースキームを編集した設定例をご案内します。

ワークフロースキームを切り替える

ワークフロースキームを切り替える方法をご案内します。

＜補足情報＞

作成したワークフロー設定は他のサイトでも使用できます。以下をご参照ください。

https://support.atlassian.com/ja/jira-cloud-administration/docs/import-and-export-issue-workflows/

チーム管理対象プロジェクト向けの情報

チーム管理対象プロジェクトをご利用の方は以下をご参考ください。

カスタマーサクセス

Jira Cloud｜ワークフロー