Queries Perfect

説明

Queries Perfect は、Redmineのフィルタリングとグループ化の機能を拡張するプラグインです。

主な機能

• タスクフィルターに OR と AND を追加
• 親タスク と 最上位タスク によるグループ化を追加
• タスク一覧 と 工数管理 に新しい フィルターと列 を追加

---

互換性

Redmine：5.0 - 6.0

Webブラウザ：Chrome, Firefox, Safari, Edge

データベース：MySQL 5.7, MySQL 8.0, PostgreSQL 14-16, SQLite

プラグイン：advanced_workflows, redmine_kanban, redmine_advanced_checklists, advanced_charts, appearance_custom, module_manager, periodic_reminder, user_group_editor, selectbox_autocompiler, cost_calculator。

---

インストールと更新

1. 古いバージョンのプラグインがRedmineに存在する場合は、削除します。

   cd redmine/plugins
   rm -r queries_perfect
   

2. 新しいプラグインフォルダ queries_perfect を redmine/plugins/ にコピーします。

3. Redmineのルートフォルダでマイグレーションを実行します。

   bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=queries_perfect
   

4. Redmineを停止して起動します。（一部のRedmineインストール（Dockerなど）では、再起動するだけでなく、サーバーを停止して起動することが重要です。）

---

アンインストール

1. Redmineのルートフォルダでアンインストールコマンドを実行します。

bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=queries_perfect VERSION=0

2. redmine/plugins/ からプラグインフォルダ queries_perfect を削除します。

rm -r queries_perfect

3. Redmineを停止して起動します。

---

設定

このプラグインに設定はありません。

---

用語集

• 最上位タスク（root issue） — これはサブタスク階層の最上位の親です。子タスクにとって、これはネストされたタスクのチェーン全体が開始されるルート要素です。（タスクにサブタスクがない場合、そのタスク自体が自分自身の最上位タスクとなります。）

  >root_issue
    \_ child1
      \_ subchild1
      \_ subchild2
  

プラグインの機能

「タスク」 セクション

機能拡張

• 新しい列
  • 最上位タスク
  • 工数差異
  • 親タスクのプロジェクト
  • 親タスクのステータス
  • 最上位タスクのステータス
  • 最上位タスクの期日
  • 親タスクの期日
• 新しいフィルター
  • 最上位タスク：
    • 最上位タスクID
    • 最上位タスクのステータス
    • 最上位タスクのトラッカー
    • 最上位タスクのプロジェクト
    • 最上位タスクの期日
    • 最上位タスクのロック
  • 親タスク：
    • 親タスクのトラッカー
    • 親タスクのステータス
    • 親タスクのプロジェクト
  • サブタスク：
    • サブタスクのトラッカー
    • サブタスクのプロジェクト
    • サブタスクのロック
  • ORフィルター：
    • AND any following
    • OR any following
    • OR all following
    • ANDブロックの開始と終了
    • ORブロックの開始と終了
• 集計フィールド「工数差異」
• 最上位タスクと親タスク によるグループ化。
• フィルター「担当者」にオプション 「自分、グループなし」 を追加
• フィルター「親タスクのプロジェクト」にオプション 「タスクのプロジェクト」 を追加

---

フィルター

• AND any following: 後続のすべてのフィルターはOR演算子で結合され、括弧内に入れられます。

• OR any following: 後続のすべてのフィルターはOR演算子で結合され、括弧内に入れられます。括弧の前にはOR演算子が置かれます。

• OR all following: 後続のすべてのフィルターはAND演算子で結合され、括弧内に入れられます。括弧の前にはOR演算子が置かれます。

• ANDブロックの開始と終了： AND演算子で結合された条件の論理グループを作成します。ブロックの開始と終了の間にあるすべてのフィルターが同時に満たされる必要があります。

• ORブロックの開始と終了： OR演算子で結合された条件の論理グループを作成します。ブロック内のいずれかのフィルターが満たされれば十分です。

• フィルター「担当者」に項目 「自分、グループなし」 が追加されました。これは現在のユーザーに直接割り当てられたタスクを表示し、ユーザーが所属するグループに割り当てられたタスクを除外します。

• フィルター「親タスクのプロジェクト」に項目 「タスクのプロジェクト」 が追加されました。これにより、プロジェクトが親タスクのプロジェクトと異なるタスクのみを表示できます。

---

グループ化

プラグインは、親タスク と 最上位タスク によるグループ化を追加します。

タスクを 親タスク または 最上位タスク でグループ化する際に、追加オプション 「レーンに表示」 が利用可能になります。

このオプションを使用すると、親タスク/最上位タスクのタイプ「リスト」および/または「タスクステータス」のカスタムフィールドの値をレーンに表示できます：

---

集計フィールド

集計フィールド 「工数差異」 は、見積もり時間と実際の工数との差を計算します。

---

「工数管理」 セクション

機能拡張

• 列

  • ユニークID
  • 件名

• フィルター

  • ユニークID
  • テキスト：件名

• 最上位タスクと親タスク によるグループ化。

使用方法

「工数管理」ページに、列 「ユニークID」 と 「件名」、および対応するフィルター 「ユニークID」 と 「テキスト：件名」 が追加されます。これにより、工数記録を、それらが属するタスクのIDまたは件名で検索できます。

---

管理

「カスタムフィールド」セクション

Queries Perfect プラグインは、タイプ「日付」のカスタムフィールドの機能を拡張します。このようなフィールドを作成または編集する際に、オプションが表示されます：

「最上位タスクのフィルターとして使用する」

これを有効にすると、一般フィルターリストに、このフィールドの標準フィルターに加えて、**<フィールド名>（最上位タスク）** という名前の特別なフィルターが追加されます。