查询手册

查询手册存储一个准备运行的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][/url]

使用“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][/url]

字段“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][/url]

可以在列表上创建快捷方式，甚至可以在电子邮件中共享列表。在这种情况下，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][/url]

执行查询

存储查询的执行是通过调用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][/url]

有关所有可能选项的详细信息，请参阅 [ ttps://www.itophub.io/wiki/page?id=2_6_0%3Aadvancedtopics%3Aexportdata]export.php[/url] 文档。

有关将结果集成到Excel的帮助，请参阅章节 [ ttps://www.itophub.io/wiki/page?id=2_6_0%3Auser%3Aexcel_report]如何使用iTop查询创建Excel报表[/url]

查询手册

查询手册存储一个准备运行的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][/url]

使用“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][/url]

字段“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][/url]

可以在列表上创建快捷方式，甚至可以在电子邮件中共享列表。在这种情况下，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][/url]

执行查询

存储查询的执行是通过调用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][/url]

有关所有可能选项的详细信息，请参阅 [ ttps://www.itophub.io/wiki/page?id=2_6_0%3Aadvancedtopics%3Aexportdata]export.php[/url] 文档。

有关将结果集成到Excel的帮助，请参阅章节 [ ttps://www.itophub.io/wiki/page?id=2_6_0%3Auser%3Aexcel_report]如何使用iTop查询创建Excel报表[/url]