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。

安装和更新

如果存在，请从 Redmine 中删除旧版本的插件。
```
cd redmine/plugins
rm -r queries_perfect
```
将新的插件文件夹 queries_perfect 复制到 redmine/plugins/。

在 Redmine 根文件夹中运行迁移。

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

停止并启动 Redmine。（在某些 Redmine 安装中（例如 Docker），重要的是停止并启动服务器，而不仅仅是重新启动。）

卸载

在 Redmine 根文件夹中执行卸载命令。

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

从 redmine/plugins/ 中删除插件文件夹 queries_perfect。

rm -r queries_perfect

停止并启动 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 运算符连接并放入括号中。

状态 AND (跟踪标签 OR 项目)

OR any following： 所有后续筛选器将使用 OR 运算符连接并放入括号中。括号前将放置 OR 运算符。

状态 OR (跟踪标签 OR 优先级)

OR all following： 所有后续筛选器将使用 AND 运算符连接并放入括号中。括号前将放置 OR 运算符。

状态 OR (跟踪标签 AND 优先级)

AND 块开始和结束： 创建一个由 AND 运算符连接的逻辑条件组。位于块开始和结束之间的所有筛选器必须同时满足。

状态 OR (项目 OR (跟踪标签 AND 作者))

OR 块开始和结束： 创建一个由 OR 运算符连接的逻辑条件组。块中的任何一个筛选器满足即可。

状态 AND 项目 AND (跟踪标签 OR 优先级)

在筛选器"指派给"中，添加了 「给我，无组」 选项，它显示直接分配给当前用户的任务，排除分配给用户所属组的任务。

在筛选器"父任务的项目"中，添加了 「任务的项目」 选项，允许只显示其项目与父任务项目不同的任务。

分组

插件添加了按 父任务 和 顶层任务 分组。

按 父任务 或 顶层任务 分组任务时，会有一个额外的选项 「在泳道上显示」 可用。

此选项允许在泳道上显示父任务/顶层任务的类型为"列表"和/或"任务状态"的自定义字段的值：

总计字段

总计字段 「工时偏差」 计算估算时间与实际工时之间的差异。

"工时" 部分

功能扩展

列
- 唯一 ID
- 主题
筛选器
- 唯一 ID
- 文本：主题
按 顶层任务和父任务 分组。

使用方法

在"工时"页面上，添加了 「唯一 ID」 和 「主题」 列，以及相应的筛选器 「唯一 ID」 和 「文本：主题」，允许通过工时记录所属任务的标识符或主题来搜索工时记录。

管理

"自定义字段"部分

Queries Perfect 插件扩展了类型为"日期"的自定义字段的功能。在创建或编辑此类字段时，会出现一个选项：

「用作顶层任务的筛选器」

如果激活此选项，除了该字段的标准筛选器外，常规筛选器列表中将添加一个名为 <字段名>（顶层任务） 的特殊筛选器。