工单查询 Wiki 宏
工单查询宏允许您在任何接受Wiki格式化的地方显示工单信息。[[TicketQuery]]宏使用的查询语言在TracQuery页面中有描述。
用法
[[TicketQuery]]
列出符合特定条件的工单的 Wiki 宏。
此宏接受一个逗号分隔的带键参数列表，形式为“键=值”。
如果键是字段名称，则值必须使用TracQuery#QueryLanguage中定义的筛选器说明符语法。请注意，这与用于以?字符开头的query:链接的简化 URL 语法不同。逗号 (,) 可以通过使用反斜杠 (\) 进行转义来包含在字段值中。
需要进行逻辑或组合的字段约束组可以通过字面量or参数进行分隔。
除了筛选器，还可以使用其他几个命名参数来控制结果的呈现方式。所有参数都是可选的。
format参数决定工单列表的呈现方式
- list（列表）—— 默认呈现方式是将工单 ID 列在摘要旁边，每个工单占一行。
- compact（紧凑）—— 工单以逗号分隔的工单 ID 列表形式呈现。
- count（计数）—— 仅显示匹配工单的数量。
- rawcount（原始计数）—— 仅显示匹配工单的数量，甚至不包含指向对应查询的链接（自 1.1.1 版起）。
- table（表格）—— 类似于自定义查询视图（但没有控件）的视图。
- progress（进度）—— 类似于里程碑进度条的视图。
max参数可用于限制显示的工单数量（默认为0，即无最大限制）。
order参数设置用于工单排序的字段（默认为id）。
desc参数指示是否应反转工单的顺序（默认为false）。
group参数设置用于工单分组的字段（默认为未设置）。
groupdesc参数指示是否应反转组的自然显示顺序（默认为false）。
verbose参数可以设置为真值，以获取列出工单的描述。仅适用于table（表格）格式。已弃用，请改用rows参数。
rows参数可用于指定哪些字段应作为行显示，例如rows=description|summary。
col参数可用于指定哪些字段应作为列显示。仅适用于table（表格）格式。
为了与 Trac 0.10 兼容，如果宏提供了最后一个位置参数，它将用于指定format。此外，使用“&”作为字段分隔符仍然有效（order除外），但已弃用。
示例
| 示例 | 结果 | 宏 |
|---|---|---|
| 分类工单的数量 | 5291 | [[TicketQuery(status=new&milestone=,count)]]
|
| 新建工单的数量 | 5291 | [[TicketQuery(status=new,count)]]
|
| 重新打开工单的数量 | 207 | [[TicketQuery(status=reopened,count)]]
|
| 已分配工单的数量 | 68 | [[TicketQuery(status=assigned,count)]]
|
| 无效工单的数量 | 1480 | [[TicketQuery(status=closed,resolution=invalid,count)]]
|
| “对我有效”工单的数量 | 1159 | [[TicketQuery(status=closed,resolution=worksforme,count)]]
|
| 重复工单的数量 | 3035 | [[TicketQuery(status=closed,resolution=duplicate,count)]]
|
| “不予修复”工单的数量 | 574 | [[TicketQuery(status=closed,resolution=wontfix,count)]]
|
| 已修复工单的数量 | 6641 | [[TicketQuery(status=closed,resolution=fixed,count)]]
|
| 未分类工单的数量（未设置里程碑） | 5662 | [[TicketQuery(status!=closed,milestone=,count)]]
|
| 工单总数 | 22368 | [[TicketQuery(count)]]
|
| 当前用户报告或拥有的工单数量 | 0 | [[TicketQuery(reporter=$USER,or,owner=$USER,count)]]
|
| 本月创建的工单数量 | 0 | [[TicketQuery(created=thismonth..,count)]]
|
| 已关闭的 Firefox 工单数量 | 8 | [[TicketQuery(status=closed,keywords~=firefox,count)]]
|
| 已关闭的 Opera 工单数量 | 1 | [[TicketQuery(status=closed,keywords~=opera,count)]]
|
| 影响 Firefox 和 Opera 的已关闭工单数量 | 0 | [[TicketQuery(status=closed,keywords~=firefox opera,count)]]
|
| 影响 Firefox 或 Opera 的已关闭工单数量 | 9 | [[TicketQuery(status=closed,keywords~=firefox|opera,count)]]
|
| 影响 Firefox 或已关闭并影响 Opera 的工单数量 | 13 | [[TicketQuery(status=closed,keywords~=opera,or,keywords~=firefox,count)]]
|
| 已关闭且不影响 Opera 的 Firefox 工单数量 | 0 | [[TicketQuery(status=closed,keywords~=firefox -opera,count)]]
|
| 最近修改的 3 个工单 | #12050, #13572, #15967 | [[TicketQuery(max=3,order=modified,desc=1,compact)]]
|
工单 #1 的详细信息 |
| |
| ||
格式：列表
[[TicketQuery(version=0.6|0.7&resolution=duplicate)]]
显示为
无结果
[[TicketQuery(id=123)]]
显示为
- #123
- 在 Windows XP 上安装失败
格式：紧凑
[[TicketQuery(version=0.6|0.7&resolution=duplicate, compact)]]
显示为
无结果
格式：计数
[[TicketQuery(version=0.6|0.7&resolution=duplicate, count)]]
显示为
格式：进度
[[TicketQuery(milestone=0.12.8&group=type,format=progress)]]
显示为
格式：表格
您可以使用col=<field>选择在表格格式 (format=table) 中显示的列。您可以通过在列之间放置竖线 (|) 来指定多个字段及其显示顺序。
[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter)]]
显示为
结果 (1 - 3 共 16706)
| 工单 | 解决方案 | 摘要 | 所有者 | 报告人 |
|---|---|---|---|---|
| #22420 | 已修复 | 模块编译在 Linux 内核 6.15.0 上失败 | ||
| #22419 | 对我有效 | Vbox 模块无法在内核 6.15 上编译 | ||
| #22418 | 无效 | 在 Windows 98 中启动增强功能时出错 |
完整行
在table（表格）格式中，您可以使用rows=<field>指定完整行。
[[TicketQuery(max=3,status=closed,order=id,desc=1,format=table,col=resolution|summary|owner|reporter,rows=description)]]
显示为
结果 (1 - 3 共 16706)
| 工单 | 解决方案 | 摘要 | 所有者 | 报告人 |
|---|---|---|---|---|
| #22420 | 已修复 | 模块编译在 Linux 内核 6.15.0 上失败 | ||
| 描述 |
/sbin/vboxconfig 失败，并附有以下日志。 摘要：GCC 未找到 /usr/share/virtualbox/src/vboxhost/*/include 中提供的包含文件。 完整的内核识别信息 # ./VBoxSysInfo.sh 发行版：Neon | 版本：24.04 | 内核：Linux version 6.15.0-amd64 (gcc (GCC) 15.1.0, GNU ld (GNU Binutils for Ubuntu) 2.42) #1 SMP PREEMPT_DYNAMIC Mon May 26 07:16:41 CEST 2025 |
|||
| #22419 | 对我有效 | Vbox 模块无法在内核 6.15 上编译 | ||
| 描述 |
Vbox 模块无法在内核 6.15 上编译 已测试最新的 7.1.x 测试版本和开发快照（均为 2025-05-23） 日志文件已附加 === 请在标题行将“woth”替换为“with”！ |
|||
| #22418 | 无效 | 在 Windows 98 中启动增强功能时出错 | ||
| 描述 |
我尝试在 Windows 98 SE 虚拟机（宿主机为 Linux Mint Cinnamon 21.2）中安装增强功能。当我启动 VBoxWindowsAdditions.exe 时，我收到一个错误消息 (NTDLL.DLL...)。当我启动 VBoxWindowsAdditions-x86.exe 时，我收到另一个错误消息（程序将停止...）。 |
|||
另请参阅：TracQuery, TracTickets, TracReports
