文档：Redmine Queries Perfect 插件

描述

Queries Perfect 是一个 Redmine 插件，用于扩展筛选与分组功能。

---

主要功能

• 在问题（问题）筛选器中添加 或者 和 和 逻辑
• 在 问题列表 和 工时记录（时间条目） 中添加新的筛选器与列

---

兼容性

Redmine: 5.0 - 6.0

网络 浏览器：Chrome, Firefox, Safari, Edge

数据库：MySQL 5.7, MySQL 8.0, PostgreSQL 14-16, SQLite

插件: advanced_workflow, redmine_kanban, redmine_advanced_checklists, advanced_charts, appearance_custom, periodic_reminder, user_group_editor, queries_perfect, selectbox_autocompiler, cost_calculator.

---

安装

1. 将插件文件夹复制到 Redmine 的 plugins/ 目录中。
2. 重启 Redmine 服务。

---

术语表

• 根问题（root 问题） — 子任务层级结构中的最顶层父问题。对任意子问题而言，它是整个嵌套链的起始根节点。（若问题无子任务，则其自身即为根问题。）

• 根问题
  • 孩子1
    • 子子1
    • 子子2

---

插件功能

问题（问题s） 模块

扩展功能：

• 新增列

  • 根问题
  • 估算工时与实际工时偏差
  • 父项目
  • 父状态
  • 根状态
  • 根截止日期
  • 父截止日期

• 新增筛选器

  • 根问题：
    • 根问题 ID
    • 根状态
    • 根跟踪器（追踪器）
    • 根项目
    • 根截止日期
    • 根被阻塞
  • 父问题：
    • 父跟踪器
    • 父状态
    • 父项目
  • 子任务：
    • 子任务跟踪器
    • 子任务项目
    • 子任务被阻塞
  • 或者 筛选器：
    • 和 之后所有条件
    • 或者 之后所有条件
    • 或者 之后所有条件（内部为 和）
    • 和 分组：开始 / 结束
    • 或者 分组：开始 / 结束

• 汇总字段：估算工时与实际工时偏差

• 按 根问题 和 父问题 分组

• 指派给 筛选器中新增选项 「自己（不含组）」

• 父项目 筛选器中新增选项 「问题所属项目」

---

使用说明

筛选器：

• 和 之后所有条件： 后续所有筛选条件以 或者 连接，并用括号分组。

• 或者 之后所有条件： 后续所有筛选条件以 或者 连接、括号分组，且整体前加 或者。

• 或者 之后所有条件（内部为 和）： 后续所有筛选条件以 和 连接、括号分组，且整体前加 或者。

• 和 分组：开始 / 结束： 创建一个逻辑组，组内所有条件必须同时满足（和 逻辑）。

• 或者 分组：开始 / 结束： 创建一个逻辑组，只需满足组内任一条件即可（或者 逻辑）。

• 指派给 筛选器中的 「自己（不含组）」 选项仅显示直接指派给当前用户的任务，排除指派给其所属用户组的任务。

• 父项目 筛选器中的 「问题所属项目」 选项仅显示项目与父问题项目不同的问题。

---

分组功能：

按 父问题 或 根问题 分组时，将启用额外选项 「在泳道中显示」。

此选项可在泳道中显示类型为 「列表」 的自定义字段值和/或父问题/根问题的 状态：

---

汇总字段：

汇总字段 「估算工时与实际工时偏差」 计算估算工时与实际记录工时之间的差值。

---

工时记录（时间条目） 模块

扩展功能：

• 列

  • 唯一 ID
  • 主题

• 筛选器

  • 唯一 ID
  • 文本：主题

• 按 根问题 和 父问题 分组

使用说明

在 工时记录 页面中，新增 「唯一 ID」 与 「主题」 列，以及对应的 「唯一 ID」 和 「文本：主题」 筛选器，支持按关联问题的 ID 或主题搜索工时记录。

---

管理配置

自定义字段 模块

Queries Perfect 插件扩展了类型为 「日期」 的自定义字段功能。创建或编辑此类字段时，将显示以下选项：

「作为根问题的筛选条件」

启用后，除标准筛选器外，全局筛选器列表中还会新增一个名为 <字段名>（根问题） 的专用筛选器。