系统管理-功能菜单-查询手册
查询手册查询手册存储一个准备运行的OQL查询列表，以便最终用户可以轻松执行由管理员定义的复杂查询。
这对于构建报表特别有用：只需将此类查询的结果集成到电子表格中（例如使用Excel的web查询功能）。
只有管理员可以访问“Query phrasebook”菜单。
创建查询
单击“Admin tools”中的“Query phrasebook”菜单，显示存储的查询列表：
[ ttps://www.itophub.io/wiki/media-detail?id=2_6_0%3Aadmin%3Aphrasebook&media=2_6_0%3Aadmin%3Aquery-phrasebook-menu.png]https://www.itophub.io/wiki/media?media=2_6_0%3Aadmin%3Aquery-phrasebook-menu.png
使用“Create a new Query”链接或“New…”操作显示创建表单：
[ ttps://www.itophub.io/wiki/media-detail?id=2_6_0%3Aadmin%3Aphrasebook&media=2_6_0%3Aadmin%3Aquery-phrasebook-1.png]https://www.itophub.io/wiki/media?w=650&tok=d92be9&media=2_6_0%3Aadmin%3Aquery-phrasebook-1.png
字段“Name”和“Description”用于标识查询。
字段“Expression”包含实际的OQL查询。查询可以包含参数（由:占位符后跟参数名标识）。使用参数可以定义能在不同上下文中使用的泛型查询。
例如，以下OQL查询列出指定客户（由其名称指定）的所有打开的变更：
SELECT Change WHERE status != 'closed' AND status != 'rejected' AND org_name = :customer
默认情况下，选定对象的所有字段都显示为查询的输出。字段“Fields”允许将此输出限制为指定的字段列表（通过以逗号分隔的字段代码列表来传递）。
在输出中，字段的顺序并不取决于字段在“Fields”中列出的顺序。
预览查询
创建查询后，将显示结果预览。[ ttps://www.itophub.io/wiki/media-detail?id=2_6_0%3Aadmin%3Aphrasebook&media=2_6_0%3Aadmin%3Aquery-phrasebook-preview.png]https://www.itophub.io/wiki/media?w=650&tok=8134c7&media=2_6_0%3Aadmin%3Aquery-phrasebook-preview.png可以在列表上创建快捷方式，甚至可以在电子邮件中共享列表。在这种情况下，OQL查询将被共享：如果以后更新了手册条目，则该更改不会影响单击共享链接显示的结果；只有数据中的更改才会影响结果。
如果查询中有任何参数，则无法显示预览。
测试查询
要在编写查询时对其进行测试，请单击编辑框下面的“Test query”链接。然后在浏览器的另一个窗口中打开“Test query”页面。如果查询包含参数，则页面将显示一个表单来输入这些参数。[ ttps://www.itophub.io/wiki/media-detail?id=2_6_0%3Aadmin%3Aphrasebook&media=2_6_0%3Aadmin%3Aquery-phrase-test1.png]https://www.itophub.io/wiki/media?w=650&tok=b99ebb&media=2_6_0%3Aadmin%3Aquery-phrase-test1.png
执行查询
存储查询的执行是通过调用webservices/export.php页面来完成的。默认情况下，在存储查询的详细信息中列出指向此页的链接，其中包含用于集成到Excel的适当选项，但其他选项可以传递到该页以生成不同的输出。
[ ttps://www.itophub.io/wiki/media-detail?id=2_6_0%3Aadmin%3Aphrasebook&media=2_6_0%3Aadmin%3Aquery-phrasebook-excel.png]https://www.itophub.io/wiki/media?w=650&tok=56813d&media=2_6_0%3Aadmin%3Aquery-phrasebook-excel.png
有关所有可能选项的详细信息，请参阅 [ ttps://www.itophub.io/wiki/page?id=2_6_0%3Aadvancedtopics%3Aexportdata]export.php 文档。
有关将结果集成到Excel的帮助，请参阅章节 [ ttps://www.itophub.io/wiki/page?id=2_6_0%3Auser%3Aexcel_report]如何使用iTop查询创建Excel报表
页:
[1]