跳转到内容

自定义查询

queries 命令(别名 q)用于列出在 Redmine Web UI 中保存的自定义查询,并允许在 CLI 中直接复用这些过滤条件。

Terminal window
redmine queries list [flags]
标志描述
--limit最大结果数(0 表示全部)
--offset分页偏移量
-o, --output输出格式:tablejsoncsv

每一行包含查询 ID、名称、可见性(publicprivate)以及作用域(globalproject <id>)。

Terminal window
redmine queries list
redmine queries list -o json
Terminal window
redmine queries get <id-or-name> [flags]

别名:showview。接受数字 ID 或查询名称。

标志描述
--project项目标识符或数字 ID - 用于区分与全局查询同名的项目级查询
-o, --output输出格式

获得查询 ID(或名称)后,通过工单接口直接运行:

Terminal window
# 按 ID - 无需额外查询
redmine issues list --query-id 12
# 按名称 - CLI 会先解析为 ID
redmine issues list --query "我的未关闭工单"
# 与 --project 配合,避免项目级查询与全局查询同名时的歧义
redmine issues list --project myproject --query "迭代待办"

自定义查询中的过滤条件由服务端应用。--query-id 仍可与 --sort--limit--offset--include 等参数组合使用,以进一步控制返回结果。