Automation for Jira - 「課題リンクを削除」アクションでリンクが削除されない

プラットフォームについて: Data Center のみ。 - この記事は、 Data Center プラットフォーム

この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。 Server* 製品のサポートは 2024 年 2 月 15 日に終了しました。Server 製品を実行している場合は、 アトラシアン Server サポート終了 のお知らせにアクセスして、移行オプションを確認してください。

*Fisheye および Crucible は除く

要約

「課題リンク」パネルのようにその他の課題へのリンクがあったとしても、「課題リンクを削除」アクションでは Jira 課題からリンクは削除されません。

自動化ルールの監査ログを確認すると、アクションは何も実行されていないことがわかります。

監査ログ エントリ

このナレッジ ベースの記事の目的は、「課題リンクを削除」アクションが期待どおりに機能しない可能性がある 1 つのシナリオと、その特定方法と修正方法を説明することです。

診断

  • ルールをトリガーした課題を開いて、別の課題へのリンクが少なくとも 1 つあることを確認します

Issuelinks_blocks
  • 手動トリガーを使用して新しい自動化ルールを作成し、以下のメッセージで「アクションを記録」アクションを追加します。

1 Inward: {{issue.issuelinks.inwardissue.key}} Outward: {{issue.issuelinks.outwardissue.key}}
  • 課題からルールをトリガーし、ルール監査ログで、ルールによって内向きと外向き両方の課題リンクが見つけられないことを確認します。

ルールによって内向き/外向きの課題リンクが見つけられない
  • <JIRA_BASE_URL> を Jira のベース URL に、<issue_key> を課題キーに置き換えた後、新しいブラウザー タブで以下の URL を開き、出力を確認します。

1 <JIRA_BASE_URL>/rest/api/2/issue/<issue_key>
  • API レスポンスで、「issuelinks」という文字列 ([リンクされた課題] フィールドの JSON キー名) を検索して、この文字列が API レスポンスに含まれていないことを確認します。

API レスポンス
  • [⚙] > [課題] > [フィールド設定] の順に選択します。

    • 課題が属するプロジェクトによって使用されている [フィールド設定] の横の [Config] ボタンをクリックします

    • 下方の [リンクされた課題] までスクロールして、このフィールドの横にある [表示] リンクが [非表示] に設定されていることを確認します。

      Field_hidden

    • このフィールドの横に [表示] リンクが表示されている場合は、このナレッジ ベース記事が該当するため、「ソリューション」セクションに進みます。

原因

[リンクされた課題] フィールドが [非表示] に設定されている場合は、次のようになります。

  • [issuelinks ] フィールドは Jira の次の REST API で使用できなくなります

    /rest/api/2/issue/<issue_key>

  • 自動化ルールは、この API からの応答に依存して課題データにアクセスするため、「課題リンク」パネルのデータはこれらのルールでは利用できなくなります

  • その結果、「課題リンクを削除」アクションでは課題リンクを表示して削除できなくなり、「アクションは実行されませんでした」というメッセージが監査ログに表示されます

注意:

  • このフィールドが「非表示」に設定されていても、課題をリンクすることは可能で、「課題リンク」パネルは引き続き [課題を表示] 画面から表示されます。

  • 課題リンクが [課題を表示] 画面には表示されているが、REST API の応答には表示されないという事実は、バグとして https://jira.atlassian.com/browse/JRASERVER-76720 チケットで追跡されます。このバグ チケットの目的は、Jira UI と REST API の不一致をレポートすることです。

ソリューション

ソリューションは、課題が属するプロジェクトに関連付けられた [フィールド設定] に [リンクされた課題] フィールドを表示することです。

  • [⚙] > [課題] > [フィールド設定] の順に選択します。

  • 課題が属するプロジェクトによって使用されている [フィールド設定] の横の [Config] ボタンをクリックします

  • 下方の [リンクされた課題] までスクロールします

  • [表示] リンクをクリックします

ソリューションが機能したことを確認するには、次の方法があります。

  • API リンク <JIRA_BASE_URL>/rest/api/2/issue/<issue_key> にアクセスして、レスポンスに [issuelinks] フィールドが表示されるようになったことを確認します。

課題リンク フィールドを確認する
  • または、この記事の「診断」セクションで説明されている自動化ルールをもう一度実行して、ログ アクションに何らかのデータ (内向きリンクまたは外向きリンク) が表示されるようになったことをご確認ください。

ログ アクションを使用して検証する

更新日時: 2024年05月31日)

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。