/ COGNITIFF

ユーザーガイド

対象: Jira Cloud (Forge アプリ)

Jira では、プロジェクト → スペース、課題 → ワークアイテム への名称変更が進められています。本ガイドでは新しい用語を使用し、画面上に残っている可能性のある従来のラベルについても適宜補足します。

概要

Jira の標準のランキングツールでは、ドラッグ＆ドロップによる順序付けが可能ですが、他のフィールドに基づいてワークアイテムを視覚化することは困難です。ボードフィルターのソート条件を置き換えると、多くの場合ランキング機能が無効になり、**「ランキングは無効になっています… (Ranking is disabled…)」**という警告が表示されます。Sort by Any Field はこの制限を排除します。Atlassian Forge のキューを介してバックグラウンドでワークアイテムを再ランク付けするため、いつでも手動でのドラッグ＆ドロップ操作を維持しながら、任意のフィールド（カスタム列を含む）でソートできるようになります。

Sort by Any Field を使用すると、以下のことが可能になります。

  • 柔軟な優先順位付け: 優先度、ビジネスバリュー、期限、ストーリーポイント、またはその他のカスタム指標でソートできます。
  • 重要な項目のハイライト: ステータス、担当者、またはスタンドアップやプランニングに必要な任意のフィールドで並べ替えることができます。
  • アジャイルの維持: 自動ソートの直後にワークアイテムをドラッグして、順序を微調整できます。
  • ランクエラーの回避: アプリは Jira のボード設定を壊すことなく、既存のランクを変更します。

前提条件

ソートを実行する前に、以下の条件を満たしている必要があります。

  1. ボードフィルターが ORDER BY Rank ASC で終わっていること。 これにより、Jira が安定したランクを公開し、ソーターがそれを調整できるようになります。
  2. ユーザーに「課題のスケジュール」権限があること。 これは現在の Jira の権限スキームで表示されるラベルであり、アプリがサーバー側でワークアイテムを再ランク付けするために必要です。
  3. ライセンスが有効であること。 アプリのライセンスがない場合、Forge ページに警告バナーが表示されます。まず管理者にライセンスの有効化を依頼してください。

アプリの使用方法

1. ソートダイアログを開く

スペースのタイプに応じて、Sort Board、Sort Backlog、または Sort Sprint というラベルのアクションを起動します。

  • ソフトウェア (スクラム/カンバン): ボード、バックログ、またはスプリントビューの右上隅にある その他のアクション メニュー (…) を開き、該当するソートアクションを選択します。
  • ビジネススペース: スペースの水平ナビゲーションバーに Sort Board の項目が直接配置されています。

2. JQL の ORDER 句を入力する

ダイアログ内で ORDER BY … 式を入力し、Save を選択します。例:

  • ORDER BY priority DESC
  • ORDER BY "Story Points" DESC, Rank ASC
  • ORDER BY dueDate ASC, priority DESC

この句はスコープ (ボード、バックログ、スプリント、またはスペース) ごとに保存され、次回以降の実行時に再利用されます。

3. ソートを実行する

Sort を押してジョブをキューに入れます。モーダルがライブステータスパネルに切り替わります。

  • 実行中 (Running): バックグラウンドプロセスがワークアイテムを再ランク付けしています。進捗状況の更新により、処理済み/合計の件数が表示されます。
  • 完了 (Complete): 成功メッセージが表示されます。この通知は少し時間が経つと自動的に消去されます (手動で閉じることも可能です)。
  • エラー (Error): API や権限に関する問題が表示されるため、解決後に再試行できます。

ジョブがキューに入れられた後は、モーダルを閉じて後からステータスを確認することもできます。

4. 必要に応じて Jira を更新する

ほとんどのボードは自動的に更新されますが、新しい順序を反映させるために、ページの更新やビューの切り替えが必要になる場合があります。

ヒント

  • 自動ソート後も、ワークアイテムを手動でドラッグできます。Forge は基盤となるランクのみを変更します。
  • 保存された ORDER BY 句は、現在のボード/バックログ/スプリントまたはスペースにスコープされます。各コンテキストで一度調整すれば、すぐに再利用できます。
  • その他の例については、Atlassian の JQL ドキュメントを参照してください。