チーム管理対象プロジェクトで利用できるワークフローのルール

This page describes each of the workflow rules you can add to your team-managed projects and gives an example of why you might want to use one. How to add a rule to your team-managed project's workflow.

ユーザーに作業項目を割り当てる

This rule helps ensure that the right people address the right work items at the right time. It takes the manual work out of assigning a team member after a stage in the workflow is complete.  

Jira では、作業項目の列間での移動またはステータスの変更時に、作業項目の担当者を自動的に変更できます。

1. Use the For transition dropdown to tell Jira the column or status that updates the work item's assignee field.

2. [担当者] ドロップダウンで、作業項目を割り当てる担当者を指定します。

作業項目は以下の担当者に割り当てることができます。

• 報告者。通常は、課題の作成者。

• 現在のユーザーまたは作業項目のステータスの更新者。

• なし。作業項目は割り当てられない。

• プロジェクト内の特定のユーザー。

例

幅広い領域にわたるチームでは通常、プロセスのさまざまな段階でタスクを割り当てます。たとえば、小規模な機能チームでは、ボードに次のような列が配置されている場合があります。

To do  In design  In development  In review  Done

ユーザーはボードの各領域に対して、作業項目を割り当てるためのルールを作成することができます。

• [設計中] に移動する作業項目は、チームの設計者に割り当てます。設計者は、実装の詳細、仕様、および要件を指定します。

• [開発中] に移動する作業項目は、チームの機能開発リードに割り当てます。リードはコードを記述したり、チーム内の他の開発者に作業を任せます。

• [レビュー中] に移動する作業項目は、チームの品質保証担当者に割り当てます。品質保証担当者はテスト記録を作成したり、自動品質テストをビルドしたりします。

• [完了] に移動する作業項目は、割り当てを解除します。

作業項目が特定の値になっている場合にのみトランジションを許可するように制限する

このルールでは、特定のトランジションの使用をユーザーに許可する前に、作業項目のフィールドの値を確認します。この仮想チェックによって、ワークフローで利用できるパスを、作業項目で提示される情報に基づいて絞り込むことで、チームが作業項目を解決しやすくなります。この機能を使用することで、新しい作業タイプやワークフローを作成することなく、類似した作業項目のベスト プラクティスを適用できます。

特定のトランジションの使用をユーザーに許可する前に作業項目のフィールドの値を確認するには、次の手順を実行します。

1. Use the For transition dropdown to tell Jira the transition that checks for the field’s value.

2. Select the field whose value you want to check in the For this field dropdown.

3. Optionally, adjust the Review its value as dropdown to change how you want to evaluate the field (see below for details).

4. Use the Check if it dropdown to select how Jira should compare the field’s value (see below for details).

5. Add the value you want to compare against to the This value field.

6. [追加] を選択します。

以下として値を確認

この機能は、古い構成の Jira や、このワークフロー ルールの高度な使い方をサポートするために含まれています。このオプションの初期設定を変更することはお勧めしません。

Jira allows you to evaluate the value entered in a field in a number of different ways. This can be useful when comparing numerals entered as text in a short text field to see if they are equal to an integer, for example.

確認するフィールドの種類に応じて、内容を次のように評価できます。

• a number - any positive or negative number, including decimal values, between -1 trillion and 1 trillion (100000000000000). Keep in mind:

  • このフィールドでは、分数は使用できません。

  • The field only accepts one separator, the decimal. Other notations (for example, commas to denote places) will break the rule.

  • Jira は小数点以下 1 桁以降を四捨五入します。たとえば、5.555555 は四捨五入されて 5.6 となります。 

  • You can enter large numbers using scientific notation. For example, the number 5000 can be entered as 5e3.

• a selection - including the available options configured in the field for dropdown and checkbox fields, or user IDs in people fields.

• a time stamp - including a date and, for time stamp fields, a time. We provide a calendar and clock to accurately select the date and time, so you don’t need to know specific formatting.

• text - evaluated as a string, including special and non-Latin characters.

以下の場合はチェック

The selection you make here tells Jira how it should evaluate the contents of the field you’re checking. For example, you can check if the value of a number field is greater than or less than a desired value.

確認するフィールドの種類に応じて、以下の演算子を使用してフィールドの値を比較できます。

• contains - for evaluating fields as either a selection or text, this operator looks to see if the desired string or selection is present in the field

• doesn’t contain - for evaluating fields as either a selection or text, this operator looks to see that the desired string or selection is absent from the field

• doesn’t equal - this operator looks to see if the field being evaluated doesn’t exactly match a specific pattern

• equals - this operator looks to see if the field being evaluated does exactly match a specific pattern. For text, the evaluation is case sensitive and considers exact formatting.

• is after - for date and time stamp fields, this operator looks for time stamps that occur after the desired value chronologically

• is before - for date and time stamp fields, this operator looks for time stamps that occur before the desired value chronologically

• is or is after - for date and time stamp fields, this operator looks for time stamps that occur at exactly the same time or after the desired value chronologically

• is or is before - for date and time stamp fields, this operator looks for time stamps that occur at exactly the same time or before the desired value chronologically

• is greater than - for number fields, this operator looks for values that are larger than what’s specified in the rule

• is greater than or equal to - for number fields, this operator looks for values that are either exactly equal to or larger than what’s specified in the rule

• is less than - for number fields, this operator looks for values that are smaller than what’s specified in the rule

• is less than or equal to - for number fields, this operator looks for values that are either exactly equal to or smaller than what’s specified in the rule

作業項目がステータスを経ている場合にのみトランジションを許可するように制限する

This rule helps ensure that work items go through one or more required stages in your team’s workflow. It lets you enforce automated checks in your workflow, and prevents work items from skipping steps in your process. Or, the rule can be set up to do the exact opposite – check that a work item hasn’t been through a particular status.

特定のトランジションを許可する前に、作業項目が特定のステータスにあったことを確認するには、次の手順を実行します。

1. Use the For transition dropdown to tell Jira the transition that checks previous statuses.

2. Select the status you want to check for in the Check that the work item has been through dropdown.

次のオプションを選択することもできます。

作業項目の現在のステータスを含める

By default, this workflow rule only looks at prior statuses when evaluating whether to allow a transition. If you want to also evaluate the current status, select the Include the work item’s current status checkbox. This can help prevent looping transitions, where a transition resets the status and it appears unchanged. It keep work items moving down your workflow. Read more about looped transitions below.

このルールを取り消す

You can change the behavior of this workflow rule to check that a work item hasn’t been through a particular status before allowing the transition. This can enforce that bugs or feature requests that have been in a “rejected” status don’t make their way back onto your board.

作業項目の最新のステータスのみを考慮する

By default, this workflow rule checks the entire history of a work item from its creation in the project. Selecting this option forces the rule to only evaluate the status set just prior to the work item’s current status. In some cases, this may be the same as the current status. We recommend also selecting the Ignore status updates from looped transitions option to ensure the rule evaluates the most recent different status from the work item’s current status.

ループが設定されたトランジションのステータス更新を無視する

Some projects use transitions to trigger notifications, automations in connected apps, or other actions. These transitions usually reset the work item’s status to the current work item status. If you’ve selected to Only consider the work item’s most recent status, the most recent status may be the same as the current status. Selecting the Ignore status updates from looped transitions option forces the rule to evaluate the most recent status that’s different from the work item’s current status.

例

品質保証の例

ここでの目的は、作業が完了する前に品質管理を確実に通過させることです。このような場合、ワークフロー ステータスを使用して、顧客へのデプロイ前に品質保証エンジニアがチームの仕事を検討するよう、チームに実行させるようにします。

たとえば、小規模な機能チームでは、ボードに次のような列が配置されている場合があります。

To do  In development  In review  Done

You can use a workflow status as a quality gate before allowing work to be completed in your project. Add the Check that a work item has been through a status rule to the final transition in your workflow, and you can ensure that work has been reviewed properly by your quality assurance engineer before marking the task as complete:

1. Add a Check that a work item has been through a status rule to the “Any status” transition leading to your “Done” status.

2. In the Check that the work item has been through dropdown, select the “In review” status.

3. Select the Include the work item’s current status option.

4. Select the Only consider the work item’s most recent status option.

5. Select the Ignore status updates from looped transitions option.

これで、作業はどのステータスでも自由に流れることができます。ただし、最新のステータスが「レビュー中」の場合にのみ「完了」にトランジションできます。

To add extra assurance, you may also add the Restrict who can move a work item rule to this transition, and restrict it to a “Quality assurance engineer” custom role. This way, only people in your “Quality assurance engineer” role can move the work item to done. Read more about custom roles.

中断されたステータスの例

ソフトウェア チームは、定期的にプロジェクトに参加しているわけではない同僚と相談する必要がある場合があります。たとえば、フロントエンド タスクでは、ユーザー インターフェイスを構築する際に、設計者からのインプットが必要な場合があります。

この種類のインプットはワークフローで定期的に必要ではありませんが、設計者のインプットを待っている作業項目を表示して確認できるようにする必要があります。

この場合、「設計待ち」と呼ばれるこのような中断のステータスを作成できます。ワークフローは次のようになります。

You can use the Check that a work item has been through a status rule to ensure the work item goes back to where it came from before the interruption in your normal workflow:

1. 中断された状態用のステータスを作成し、すべてのステータスが新しいステータスに移行できるようにします。上の例では、中断状態を「設計待ち」と呼びます。

2. Create transitions from the interrupted status back to your main workflow. In the diagram above, the “Restart task” and “Back to in progress” transitions direct work items from our “Awaiting design” interrupted status back into the main workflow (TO DO IN PROGRESS DONE).

3. Add a Check that a work item has been through a status rule to allow the transition that puts the work item back where it came from. For example, if work items were interrupted while they were “In progress”:

   1. In the For transition dropdown, select “Back to in progress” transition.

   2. In the Check that the work item has been through dropdown, select the “In progress” status.

4. Add a Check that a work item has been through a status rule to prevent the work item moving backward in your workflow. For example, if work items were interrupted while they were “In progress”, you can prevent them from moving back to “To do”:

   1. In the For transition dropdown, select “Restart task” transition.

   2. In the Check that the work item has been through dropdown, select the “In progress” status.

   3. Select the Reverse this rule option.

これで、メインフローから中断され [設計待ち] に設定されている作業項目は、次の方法でしか移動できません。

• [未着手] から [設計待ち] に移動する作業項目は、[未着手] に戻ることしかできません。

• [進行中] から [設計待ち] に移動する作業項目は、[進行中] に戻ることしかできません。

作業項目を移動できるユーザーを制限する

このルールによって、チームのプロセスにおける特定の時点で適切なユーザーのみが作業項目を移動できるようになります。ワークフローで見逃すステップを減らして、作業にかかわるすべてのユーザーが確実にチームの作業に取り組めるようにします。

作業項目を移動できるユーザーを次のように制限できます。

• 作業項目の担当者。

• 作業項目の報告者。

• 自分が選択したユーザー

• 特定のロールを持つユーザー

• 特定のグループに所属するユーザー

• 特定の権限を持つユーザー

例

通常、幅広い領域にわたるチームには、プロセスのさまざまなステージでタスクに取り組んでいるユーザーがいます。たとえば、小規模なチームでは、次のようなステップを踏んでプロセスを進める場合があります。

To do  In design  In development  In review  Done

チームの領域は次のようなロールにマッピングされます。

• デザイナー

• ソフトウェア エンジニア

• 品質保証

How to manage project roles

ルールを使用して次のような制限を追加することで、適切なロールが作業項目を移動できるようにします。

• For work items moving from In design, restrict who can move the work item to the role Designer.

• For work items moving from In development, restrict who can move the work item to the role Software engineer.

• For work items moving from In review, restrict who can move the work item to the role Quality assurance.

ユーザーが特定の権限を持っていることを確認する

このルールでは、特定のトランジションの使用をユーザーに許可する前に、ユーザーが持つ権限を確認します。この確認は、チームにとって適切なユーザーだけが適切なタイミングで作業項目を移動できるようにするのに役立ちます。このルールを使用すると、ユーザーの Jira 権限に基づいてワークフローを保護できます。

例

基本的なワークフローを使用するチームでは、ワークフローに以下のステータスがあります。

Start  To do  In progress  Done

このルールを使用すると、ユーザーが特定の権限を持っていることを次の方法で確認できます。

• Only allowing people with the Create work items permission to move a work item from Start  To do. This ensures that only the right people can create work for your team.

• Only allowing people with the Assign work items permission to move a work item from To do  In progress. This ensures that whoever starts working on a work item can assign it to someone.

• Only allowing people with the Close work items permission to move a work item from In progress  Done. This ensures that people aren’t able to resolve a work item without being allowed to.

あるフィールドの値を別のフィールドにコピーする

Just like the Update a work item field rule, this one also helps ensure your work is updated in the right places at the right time by reducing data entry errors. The key difference is that this rule updates a field based on another field.

フィールドの値は次の場所からコピーできます。

• within the work item itself, which copies a field from a work item to another field on the same work item.

• the parent work item, which copies from the work item’s parent to itself. This option only works if the work item is the child of another work item e.g. copying a work item from an epic (parent) to a story (child), or from a story (parent) to a subtask (child).

このルールがスキップされる場合

このルールを設定した情報は、ワークフローを共有するすべての作業タイプには適用されない場合があります。そのため、次の場合はこのルールがスキップされます。

• it’s on a work item that doesn’t have both your selected fields (in Copy from this field and To this field).

• it’s configured to copy from the parent work item and the work item doesn’t have a parent.

このルールがスキップされたからといって、何か間違ったことをしたわけでも、バグがあるということでもないため心配は無用です。そのまま作業を続けても問題ありません。ルールがスキップされても、どのフィールドもコピーも更新もされないだけです。

フィールドのコピー方法

次の 3 通りの方法でフィールドを別のフィールドにコピーできます。

• 追加: フィールドの値がコピー先フィールドの値に追加されます。

• 先頭に追加: フィールドの値がコピー先フィールドの値の先頭に追加されます。

• 置換: フィールドの値でコピー先フィールドの値が置換されます。

コピーに対応しているフィールド タイプとそのコピー方法のリストは次のとおりです。

作業項目フィールドを更新する

このルールを設定すると、作業項目に適切なタイミングで適切な情報を取り込むようにすることができます。これにより、データの入力エラーを減らし、一貫性を向上させることができます。

Jira では、作業項目の列間での移動またはステータスの変更時に、特定のフィールドを自動で変更できます。

1. Use the For transition dropdown to tell Jira the column or status that updates a certain field. 

2. 自動更新するフィールドを選択します。

You can update any text, number, label, date, or time fields you’ve added to your project, including custom fields. More about custom fields

参考情報

• ルールを使用してテキスト フィールドを更新すると、 Jira は目的のテキストをフィールド内の既存のテキストに追加します。フィールド内の既存のテキストの置き換えは行いません。

• 期間または日付フィールドを更新すると、Jira はボード上のカードの移動時の日付とタイムスタンプ (またはこのいずれか) でフィールド内のすべての要素を置き換えます。静的な時間または日付を指定することはできません。

例

幅広い領域にわたるチームでは通常、プロセスのさまざまな段階でタスクを割り当てます。たとえば、小規模な機能チームでは、ボードに次のような列が配置されている場合があります。

To do  In design  In development  In review  Done

トレーサビリティやレポート作成のために、チームは作業タイプに以下のカスタム日付フィールドを追加して、引き継ぎ日を追跡できます。

• 設計部門による確認

• 開発への引き継ぎ

• QA 担当者への引き継ぎ

作業項目が特定の列またはステータスに移動した時点でこれらの引き継ぎ日フィールドを最新の日付に更新する以下のようなシンプルなルールを作成できます。

• 作業項目が [設計中] に移動した場合は、[設計部門による確認] フィールドを最新の日付/時間に更新します。

• For work items moving to In development, update the Handed to development field to the current date/time.

• 作業項目が [レビュー中] に移動した場合は、[QA 担当者への引き継ぎ] フィールドを最新の日付/時間に更新します。

不明なカスタム フィールド タイプ

不明なタイプのカスタム フィールドをワークフロー エディターに更新するときは、必ずカスタム フィールドのタイプと一致する値をご入力ください。そうしないとルールが機能しない場合があります。

次を使用できます。

• %%CURRENT_USER%%、作業項目をトランジションしたユーザーに置き換えられます。

• %%CURRENT_DATETIME%%、トランジションの日時に置き換えられます。

• For Select List (cascading) fields, you can either use the value or the id of the option to be selected.

カスタムの日時形式

カスタムの日時形式をセットアップして、日時のフィールドを更新するようにこのルールを設定する場合は、正しい形式で入力する必要があります。その場合は、日付ピッカー フィールドの代わりに、入力方法の説明が記載されたテキスト フィールドが表示されます。

For example, you might see a text field that says to enter a date in the “dd/MMMM/yyyy h:mm a” format. One date you could enter would be “15/July/1968 9:30 PM”. To learn more about these formats, check out Java SimpleDateFormat.

To change your date and time formats, you can configure the look and feel of Jira. More about configuring the look and feel of Jira