セットアップ

対象: Jira Data Center

Universal Plugin Manager (UPM) を介して Sort by Any Field をインストールした後、以下の前提条件が満たされていることを確認してください。

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

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

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

     1. 対象の Jira ボードを開きます。
     2. ボード → 設定 を選択します。
     3. 一般とフィルター にある フィルタークエリ フィールドを確認します。
     4. フィルタークエリが ORDER BY Rank ASC で終わっていることを確認します (screenshot)。この句が欠落している場合は、現在のクエリの末尾に追加してください (例: project = FOO ORDER BY Rank ASC)。

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

2. ユーザーに「課題のスケジュール」権限を付与する

   並べ替えは課題のランクを再設定することによって実行されます。ユーザーには、ボード上で課題をランク付けする権限が必要です。

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

3. インストールされたアプリのライセンスを確認する

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

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