関連する課題の操作
独立した課題は稀です。多くの場合サブタスクが含まれていたり、大きなエピックのストーリーであったり、特定の関係性を使用して他の課題に単にリンクされていたりします。つまり、自動化を使用する際は、ルールをトリガーしたソースの課題だけではなく、ソースの課題に関連するすべての課題に対してアクションを適用する必要があることよくあります。
課題の複雑な関係に対応できる強力なルールを作成するための、特別な条件やアクションがあります。たとえば、親課題のサブタスクがすべて解決されたことを確認するなどです。
The Related issues condition checks the state of related issues, for example, if all linked issues are closed.
Branch rule applies actions to related issues, for example, transitions all sub-tasks.
In order for a rule to work with an issue in another project, it must be able to execute in the projects the issue is in, either being a multi-project or global rule.
関連課題の条件
The Related issues condition checks the state of related issues before progressing a rule.
この条件は幅広いユース ケースで使用可能であり、たとえば次の内容の確認に使用されます。
課題に特定タイプのリンク済み課題があるかどうか
課題に親またはエピックがあるかどうか
スプリント/バージョンの課題の中に割り当てされていないものがあるかどうか
エピック内のすべてのストーリーが解決済みの場合。
特定タイプの解決済みサブタスクに特定の値セットがあるかどうか
関連課題の条件をセットアップする
関連の課題タイプを選択します。
サブタスク
親
ストーリー (または、このエピックのその他の課題)
エピック
作成した課題
紐づく課題
関連課題が次の状態かどうかを確認する条件を選択します。
存在する
存在しない
すべて指定 JQL と一致する
いずれも指定 JQL と一致しない
一部が指定 JQL と一致する
[保存] を選択します。
関連課題のブランチを作成する
自動化ルールの設定時に、関連課題に対してアクションを実行することができます。これを、「ブランチの作成」と言います。これは、直線的には実行されていないが、複数のパスに拡張して実行されるルールを指します。
When a rule is branched on an issue or list of issues, the sub-branch of the rule is executed against each issue. All actions and references to {{issue}} will point to the related issue, not the trigger issue.
You can still reference the trigger issue in branched rules using the smart value {{triggerIssue}}.
Branching is useful for a number of use cases, such as:
Synching all sub-tasks by copying a value from the parent to a specific field.
Moving an Epic into In progress when a Story is moved to In progress.
Commenting on is blocked by linked issues when an issue is resolved.
ブランチ実行の順番を付ける
複数の課題 (4 件のサブタスクなど) に対するブランチは同時に実行されますが、必ずしも次のブランチの開始前に前のブランチが完了するわけではありません。そのため、ブランチ間の変更には注意が必要です。
複数の課題上のブランチは新規プロセスとして実行され、メインブランチはサブブランチが開始するまで実行を続けます。
作成済み課題にアクセスする
Rules can create issues using the Create issue and Clone issue actions. Performing further actions, such as adding a comment or creating sub-tasks, on these newly created issues within the same rule requires a related issue branch.
This is because the main branch of a rule always applies to the trigger issue, not the created issue. For example, adding a Comment on issue action after a Create issue action adds a comment to the trigger issue, not the created issue.
これに対応するには、作成されたすべての課題に対するブランチを新しく作成し、新しく作成した課題に対してアクションを実行できるようにします。
Alternatively, you can use the Related issues condition (Most recently created) if you the only need to action a single issue.
分岐の制限
- Nesting: Branches cannot be nested in one another, and do not support the use of the If/else block condition.
- Isolation: Branches are isolated. Any changes that occur in a branch will not be visible to the main branch, or any others. For example, if a branch has a Create variable action, the created smart value can be used in that same branch, but can't be used in the main branch, nor in any other the other branches.
詳細
Check out how we use related issues in our Jira automation template library.