使用OfficeQuery快速搭建企业内部信息查询系统
OfficeQuery是新锐科技新推出的一款软件产品，主要用于企业的报表、EPR流程、订单等各种信息的查询，能够快速满足企业运营中的各种信息查询需求。
与EasySQLMAIL不同，OfficeQuery侧重于信息的主动查询功能，力求使用最少的配置实现交互式查询，为员工提供主动获取信息的渠道。下表是OfficeQuery与EasySQLMAIL两款产品的功能比较：
| EasySQLMAIL | OfficeQuery | |
| 主要功能 | 用于信息推送 | 用于信息查询 |
| 解决的问题 | 由系统定时或在发生某些事件时主动向员工推送信息。 | 由员工自主在系统中查询需要的信息。 |
| 系统功能特点 | 自动化程度高，定时任务由系统自动处理。员工被动接收信息，不能选择要获得的信息内容。 | 员工可以根据需要自主设置查询条件，查询条件可以灵活配置和组合。能够快速满足企业活动中的紧急和阶段性的信息查询需求。 |
在这篇文章中我们将向您介绍OfficeQuery的系统情况以及基本功能的使用。
OfficeQuery是新锐企业数字化套件系列产品的其中一员，主要部署在企业内部为员工提供报表、订单等各种信息的查询功能。
在OfficeQuery中，管理员通过简单配置就能够为员工提供多种功能的信息查询界面，让员工随时了解需要的信息。例如，管理员编写好SQL语句后，在OfficeQuery中可以快速配置实现如下的查询功能：
OfficeQuery的信息查询界面
OfficeQuery的优点：
（1） 不需要编写复杂的程序代码。管理员只需要编写查询语句并在系统中配置查询任务，就可以实现数据和报表的WEB查询功能。通过使用低代码的开发方法，能够在企业环境下快速响应前端的信息查询需求。
（2） 学习成本低。如果您使用过新锐科技的EasySQLMAIL数据发布系统，那么不需要额外的学习就能够快速上手进行OfficeQuery系统的配置。OfficeQuery还能够把管理员设计好的Excel表格在后台自动填写好后转换为网页展示给员工。
查询任务配置界面
OfficeQuery可以自动填写Excel表格并通过网页展示
（3） 配置、部署简便。管理员可以在控制台界面中通过完全界面化的操作完成查询任务的配置，并可以很简便地将SQL查询结果转换为正文表格、Excel表格或PDF文档显示在查询界面上。
把查询结果转换为PDF文档显示在页面上
（4） 使用范围可以灵活设置。管理员可以使用企业微信、钉钉通信录的数据来设置查询功能的使用范围。例如，管理员可以设置某个查询功能只允许某一部门或是某个标签下的员工使用。
灵活设置查询功能的使用范围
（5） 安全性高。系统集成了验证码登录、查询限额、防SQL注入、防XSS攻击等多项安全功能。同时系统对每一次查询操作都有详细的日志记录，能够为管理员的日常管理提供帮助。
员工需要输入数字验证码才能进入查询系统
设置查询限额
通过检查参数内容防止SQL注入攻击
详细的日志记录可以帮助管理员进行系统管理
OfficeQuery系统分为控制台和查询平台两个部份。
控制台是系统的核心部份，安装在服务器上，主要用于完成系统管理、任务配置、执行查询任务等工作。
查询平台主要用于为员工提供查询服务。员工在浏览器中登录查询平台后，可以使用管理员配置的查询功能查询自己需要的信息。查询平台可以与控制台安装在同一个服务器上，也可以安装在其它服务器上。系统管理员可以为系统配置多个查询平台节点。
下图是OfficeQuery的系统拓扑图：
OfficeQuery系统拓扑图
下图是OfficeQuery中查询任务的处理过程：
查询请求的处理过程
OfficeQuery软件下载地址：https://www.newnet123.com/download.html?type=2
下载完成后请使用MD5校验工具对下载的文件进行校验，确认文件的MD5值与下载页面中给出的MD 5值一致后再运行安装。
对下载的文件进行MD5校验
OfficeQuery安装程序下载完成后，在要安装OfficeQuery的服务器上以系统管理员身份运行安装程序即可。
OfficeQuery安装程序
安装过程完成后，安装程序会在浏览器中打开OfficeQuery的WEB控制台。管理员登录WEB控制台后即可对系统进行基本配置。
OfficeQuery的WEB控制台
系统安装完成后，OfficeQuery控制台的默认登录地址是 http://127.0.0.1:9115/webconsole。
系统安装后，管理员需要在系统中进行基本配置后才能投入使用。OfficeQuery的基本配置主要包含以下方面的内容：
（1） 配置OfficeQuery企业查询平台。企业查询平台主要用于为员工提供查询服务。员工登录到查询平台后，可以进行各种查询操作。
查询平台的配置方法参见：https://www.newnet123.com/manual/officequery.pdf#nameddest=queryservermanage。
（2） 配置发信邮件账号。发信邮件账号主要用于系统向员工发送登录验证码、系统通知邮件时使用。
发信邮件账号的配置方法参见：https://www.newnet123.com/manual/officequery.pdf#nameddest=addmailacct。
（3） 配置企业微信、钉钉信息。企业微信、钉钉信息主要用于系统读取企业微信、钉钉通信录，以及向员工发送登录验证码时使用。
企业微信的配置方法参见：https://www.newnet123.com/manual/officequery.pdf#nameddest=wxacctmanage，
钉钉的配置方法参见：https://www.newnet123.com/manual/officequery.pdf#nameddest=dingacctmanage。
（4） 配置数据源。管理员通过配置数据源信息来告诉OfficeQuery应该如何访问企业数据库。
数据源的配置方法参见：https://www.newnet123.com/manual/officequery.pdf#nameddest=datasourcemgr。
基本配置完成后，就可以开始配置具体的信息查询任务了。
信息查询任务也称为“交互式查询任务”。管理员可以在信息查询任务中配置查询的参数、要执行的SQL语句，以及设置查询结果如何展示。配置完成并测试通过后，管理员可以把查询任务赋权给指定范围的员工进行使用。
下图是OfficeQuery查询任务的配置流程：
查询任务配置流程
本文档中以一个销售统计表为例向您演示信息查询任务的配置方法。
业务需求：公司销售部门领导可以随时在系统中查询每月的销售统计报表。查询时可以选择要查询的地区和查询的起止月份。
DBA编写的SQL语句如下：
SELECT *
FROM t_sale_stat
WHERE area_id = 1001 /*1001表示成都，对应编码可以在t_area中查询到*/
AND date BETWEEN '202101' AND '202103'
ORDER BY date
配置过程:
（1） 创建任务。任务类型选择“交互式查询”。
创建“交互式查询”任务
（2） 为任务添加查询参数。
第一个参数的名称为“地区”，参数类型为“选项列表”:
添加“地区”参数
为参数设置选项列表。选项列表可以是一个固定列表，也可以使用SQL语句动态从数据库中查询。这里使用SQL语句动态从数据库中查询：
设置生成“地区”选项的SQL语句
设置选项值字段和选项文本字段：
设置选项值字段和选项文本字段
使用相同方式创建查询参数“起始月份”和“结束月份”。创建完成后的查询参数列表如下：
查询参数列表
（3） 设置查询结果正文，把查询结果显示在正文的表格中。注意需要将SQL语句修改为如下格式：
SELECT *
FROM t_sale_stat
WHERE area_id = #[地区]#::int8
AND date BETWEEN #[起始月份]# AND #[结束月份]#
ORDER BY date
语句中的红色部份表示使用员工输入的查询参数作为SQL语句的查询条件。
在正文中插入表格
配置完成后的正文内容
任务配置完成后，需要进行一系列测试保证配置正确后才能投入使用。任务测试分为功能测试和压力测试两方面。
功能测试主要用于验证任务的配置和查询结果的正确性。
功能测试的方法是由管理员在控制台WEB页中输入各种可能的查询参数值进行查询，检查任务是否能正常运行，以及查询结果是否与预期的一致。
功能测试的具体操作方式：在任务配置界面上要测试的任务上点击右键，在弹出的菜单中选择“运行任务”菜单项。系统将会打开任务执行界面。
在右键菜单中执行任务
管理员在查询界面中输入一些用于测试的查询参数，点击“查询”按钮执行查询。然后观察任务是否正常运行，查询结果是否正确，查询语句的效率是否符合要求等。如果在测试中发现问题，则需要对任务配置进行修改或对SQL语句进行优化，并反复测试直到查询功能符合要求为止。
执行查询并检查执行结果
压力测试主要检查多个员工同时发起查询请求时任务是否能够正常运行，并测试多人同时查询时的等待和执行时间。
压力测试可以在控制台上进行，也可以在查询平台上进行。
在控制台上进行测试时，主要测试的是任务配置本身的并发执行（多人同时发起查询）情况和数据库的抗压性能。
在查询平台上进行测试时，是对整个查询的流程（包括查询平台应用服务、网络情况、查询接口服务、任务配置、数据库）的抗压性能进行测试。
注意：进行压力测试时系统会在短时间内模拟多人同时执行查询的情景，可能会对OfficeQuery服务和您的数据库性能有一定影响(根据您的配置情况而定）。请在进行测试前与数据库管理员沟通协商测试时间和测试方法（例如测试参数、并行数量等）。
在控制台上打开查询任务的执行界面，输入查询参数，点击“压力测试”按钮。
在界面上输入查询参数点击“压力测试”
然后在“压力测试”对话框中输入模拟调用数量。模拟调用数量可以是一个1-100之间的数字。模拟调用数量越高，系统生成的调用请求就越多。
输入模拟调用数量
点击“确定”后，系统将同时发起多个执行请求，调用被测试的任务。并在界面上显示测试的结果。
压力测试结果
在这个对话框中：
|
等待时长 |
指系统从收到查询请求到开始执行任务的这段时间。 |
|
执行时长 |
指任务从开始执行到执行完成的这段时间。 |
|
平均等待时间 |
计算公式为“SUM(等待时长) / 测试任务数量” |
|
平均运行时间 |
计算公式为“SUM(执行时长) / 测试任务数量” |
（1） 系统管理员在系统地址簿中为用于测试的员工账号勾选“允许此联系人在查询平台上对交互式查询任务进行压力测试”权限。
为测试账号添加“压力测试”权限
（2） 在查询任务配置界面的“可使用此查询的员工”中选择刚刚设置的测试账号，以便能够在查询平台的菜单中看到要测试的任务。
为测试账号添加查询任务的使用权限
（3） 使用测试账号登录查询平台，打开任务查询界面，并输入查询参数，点击“压力测试”按钮。
在查询平台上打开任务的查询界面
（4） 输入模拟调用数量，点击“确定”按钮启动测试。
输入模拟调用数量
（5） 测试完成后，系统将显示测试结果。
压力测试结果
管理员可以根据压力测试结果对系统和任务的配置进行优化。具体优化方法请参考本系统的其它相关文档。
任务测试通过后，您可以在任务配置中设置哪些员工可以使用此查询功能。使用范围设置好后，对应范围内的员工即可在查询平台的菜单中看到并使用此查询任务。
在任务配置界面中选择可以使用此查询的员工
系统支持按以下方式确定任务的使用范围：
|
指定联系人 |
被选择的联系人可以使用此查询功能 |
|
联系人组 |
被选择的联系人组下的联系人可以使用此查询功能 |
|
企业微信或钉钉的指定员工 |
企业微信或钉钉的指定员工可以使用此查询功能 |
|
*企业微信中某个应用可见范围内的所有用户 |
企业微信的一个应用可见的所有员工可以使用此查询功能 |
|
*企业微信标签下的所有用户 |
企业微信的一个标签下的所有员工可以使用此查询功能 |
|
*企业微信或钉钉的部门及其下的所有部门的全部用户 |
企业微信或钉钉的一个部门及其下的所有部门的全部员工可以使用此查询功能 |
|
*部门的直属员工(不包含下级部门员工) |
企业微信或钉钉的一个部门下的直属员工(不包含子部门的员工）可以使用此查询功能 |
注意：表中红色带“*”号的项目表示需要依赖企业微信或钉钉的通信录数据。系统在使用这些选项进行权限验证时，将使用缓存在本地的企业微信和钉钉通信录数据作为判断依据。如果您的企业微信或钉钉通信录发生了变化（例如修改了员工所在部门，或是增加、删除了员工），请一定在“消息通道管理”中及时把通信录同步到本地，以便系统能够正确地判断员工是否有使用查询功能的权限。
同步通信录数据到本地
员工在查询平台中使用查询任务
OfficeQuery软件下载地址：https://www.newnet123.com/download.html?type=2
OfficeQuery软件手册：https://www.newnet123.com/manual/officequery.pdf
使用自定义Excel模板：http://www.newnet123.com/docreader.html?id=346
如何把Excel表格显示到邮件正文里：http://www.newnet123.com/faqview.html?id=480
