セットアップ

対象: Jira Cloud (Forgeアプリ)

ForgeベースのSort by Any Fieldアプリをインストールして有効化した後、以下の前提条件が満たされていることを確認してください。

Jiraでは、プロジェクト (projects) → スペース (spaces)、および課題 (issues) → ワークアイテム (work items) への名称変更が進められています。本ガイドでは新しい用語を使用し、権限名など、従来の表記が残っている一部のJira画面についてはその旨を明記しています。

1. ボードのフィルタークエリが ORDER BY Rank ASC で終わっていることを確認する

   本アプリはJiraのネイティブなランキング機能に依存しています。Forgeソーターがバックグラウンドキューで既存のランクを調整できるように、ボードのフィルターは必ず ORDER BY Rank ASC で終了している必要があります。

   • ボードのフィルタークエリの確認方法

     1. 対象のJiraボードを開きます。
     2. ボード → 設定 を選択します。
     3. 一般とフィルター にある フィルタークエリ フィールドを確認します。
     4. フィルタークエリが ORDER BY Rank ASC で終わっていることを確認します (screenshot)。この句が欠落している場合は、現在のクエリの末尾に追加してください（例: project = FOO ORDER BY Rank ASC — Atlassianが space エイリアスを展開するまで、JQLでは引き続き従来の project キーワードが使用されます）。

   • 重要な理由: ランクによる並べ替えがない場合、ソーターはワークアイテムを確実に昇格させることができず、バックグラウンドジョブが完了したように見えても、期待される順序が適用されない可能性があります。

2. ユーザーに「課題のスケジュール」権限を付与する — 権限スキームでは、Jiraは引き続きこの従来のラベルを表示します。

   並べ替えは、ワークアイテムのランクを再設定することによって実行されます。ユーザーには、ボード上でワークアイテムをランク付けする権限が許可されている必要があります。

   • 権限の付与方法
     1. スペース設定 → 権限 に移動します。
     2. スペースの権限スキームを編集します。
     3. 並べ替えを実行するグループまたはロールに、課題のスケジュール 権限を追加します (screenshot)。

3. インストールされたアプリのライセンスが有効であることを確認する

   アプリのライセンスがない場合、Forge UIに警告バナーが表示されます。このメッセージが表示された場合は、並べ替えを実行する前にJira管理者に連絡してライセンスを有効化してください。

これらの前提条件が満たされたら、Sort Board / Sort Backlog / Sort Sprint アクションを開き、「Order by」句を設定して並べ替えを実行します。ジョブはForgeキューを介して非同期に実行され、完了するまでモーダルにステータスの更新が表示されます。