[Jira Automation]エピックの子課題の完了率を自動化で算出しカスタムフィールドに反映する方法

[#1]

エピックの課題ビューにて、エピックに紐づく子課題が表示されその子課題の完了率が以下のように表示されます。

この完了率はフィールドに値として保持されておらず、エピック毎の完了率をダッシュボードやレポートにて利用する事ができません。
本記事では、エピックの子課題の完了率を自動化で計算し、カスタムフィールドにその値を保持する方法をご紹介いたします。

設定手順

1. 子課題の完了率を保持するカスタムフィールドを作成

2. 1.で作成したカスタムフィールドをエピックの課題レイアウト、画面に割り当て

3. 以下の様な2つの自動化ルールを設定
   (ルール1)
   1. トリガー: 複数の課題イベント
      　課題イベント: [課題の作成時]、[課題のトランジション時]

   2. アクション: 課題データを再取得

   3. 条件: JQL条件
      <企業管理対象プロジェクトの場合>
      

      JQL: "Epic Link" is not Empty
      

      <チーム管理対象プロジェクトの場合>

      JQL: parent != empty and issuetype in standardIssueTypes()

   4. アクション: 課題を検索
      <企業管理対象プロジェクトの場合>
      

      JQL: "Epic Link" = {{issue.epic.key}}

      <チーム管理対象プロジェクトの場合>

      JQL: parent = {{issue.parent.key}}

   5. アクション: 変数を作成
      　変数名: varTotalCount
      　スマート値: 

      {{lookupIssues.size|0}}

   6. アクション: 課題を検索
      <企業管理対象プロジェクトの場合>
      

      JQL: "Epic Link" = {{issue.epic.key}} AND status = Done

      <チーム管理対象プロジェクトの場合>

      JQL: parent = {{issue.parent.key}} AND status = Done

   7. アクション: 変数を作成
      　変数名: varDoneCount
      　スマート値: 

      {{lookupIssues.size|0}}

   8. ブランチを作成

      1. 関連課題のタイプ: エピック(親)

      2. アクション: 変数を作成
         　変数名: varEpicCompletion
         　スマート値: 

         {{#=}}{{varDoneCount.asNumber}}/{{varTotalCount.asNumber}}* 100 {{/}}
         

      3. アクション: 課題フィールドを編集
         　設定するフィールド: 1.で作成したカスタムフィールドを指定し、以下のスマート値を指定
         

         {{varEpicCompletion.left(5)}}% 

ルール1設定イメージ:

課題の削除時にも子課題の完了率が反映される様に、以下のルールを設定ください。

(ルール2)

1. トリガー: 課題の削除時
2. ブランチを作成: 

   1. 関連課題のタイプ: エピック(親)

   2. アクション: 課題を検索
      <企業管理対象プロジェクトの場合>
      

      JQL: "Epic Link" = {{issue.key}}

      <チーム管理対象プロジェクトの場合>

      JQL: parent = {{issue.key}}

   3. アクション: 変数を作成
      　変数名: varTotalCount
      　スマート値: 

      {{lookupIssues.size|0}}

   4. アクション: 課題を検索
      <企業管理対象プロジェクトの場合>
      

      JQL: "Epic Link" = {{issue.key}} AND status = Done

      <チーム管理対象プロジェクトの場合>

      JQL: parent = {{issue.key}} AND status = Done

   5. アクション: 変数を作成
      　変数名: varDoneCount
      　スマート値: 

      {{lookupIssues.size|0}}

   6. アクション: 変数を作成
      　変数名: varEpicCompletion
      　スマート値: 

      {{#=}}{{varDoneCount.asNumber}}/{{varTotalCount.asNumber}}* 100 {{/}}
      

   7. アクション: 課題フィールドを編集
      　設定するフィールド: 1.で作成したカスタムフィールドを指定し、以下のスマート値を指定
      

      {{varEpicCompletion.left(5)}}% 

ルール2設定イメージ:

 

動作イメージ:

関連機能リクエスト:

「〇〇%完了」の値をフィールドとして利用できるようにする機能リクエストが以下にて起票されております、VoteやWatchをご検討いただけますと幸いです。

• JRACLOUD-80273 - Turn the percent done information on child issue panel to a custom field
• JSWCLOUD-18100 - Make % epic percent completion available for reporting

リンク先にて Vote for this issue(この課題に投票) していただくと機能が実現する可能性が高くなります。よろしければご検討ください。また、Start watching this issue(この課題をウォッチ) で購読していただくと、進捗があった場合にお客様に通知が送信されるようになります。

なお、機能開発の優先順位は、投票数のほかに製品戦略やフィードバックなども考慮して決定しております。詳しくは 新機能の実装ポリシー をご覧ください。