南方飛豬

 

OfficeQuery安裝程序

安裝過程完成后，安裝程序會在瀏覽器中打開OfficeQuery的WEB控制臺。管理員登錄WEB控制臺后即可對系統進行基本配置。

OfficeQuery的WEB控制臺

系統安裝完成后，OfficeQuery控制臺的默認登錄地址是 http://127.0.0.1:9115/webconsole。

2.4 OfficeQuery系統的基本配置

系統安裝后，管理員需要在系統中進行基本配置后才能投入使用。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。

基本配置完成后，就可以開始配置具體的信息查詢任務了。

3. 配置信息查詢任務

信息查詢任務也稱為“交互式查詢任務”。管理員可以在信息查詢任務中配置查詢的參數、要執行的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語句的查詢條件。

在正文中插入表格

配置完成后的正文內容

4. 任務測試

任務配置完成后，需要進行一系列測試保證配置正確后才能投入使用。任務測試分為功能測試和壓力測試兩方面。

4.1 功能測試

功能測試主要用于驗證任務的配置和查詢結果的正確性。

功能測試的方法是由管理員在控制臺WEB頁中輸入各種可能的查詢參數值進行查詢，檢查任務是否能正常運行，以及查詢結果是否與預期的一致。

功能測試的具體操作方式：在任務配置界面上要測試的任務上點擊右鍵，在彈出的菜單中選擇“運行任務”菜單項。系統將會打開任務執行界面。

在右鍵菜單中執行任務

管理員在查詢界面中輸入一些用于測試的查詢參數，點擊“查詢”按鈕執行查詢。然后觀察任務是否正常運行，查詢結果是否正確，查詢語句的效率是否符合要求等。如果在測試中發現問題，則需要對任務配置進行修改或對SQL語句進行優化，并反復測試直到查詢功能符合要求為止。

執行查詢并檢查執行結果

4.2 壓力測試

壓力測試主要檢查多個員工同時發起查詢請求時任務是否能夠正常運行，并測試多人同時查詢時的等待和執行時間。

壓力測試可以在控制臺上進行，也可以在查詢平臺上進行。

在控制臺上進行測試時，主要測試的是任務配置本身的并發執行（多人同時發起查詢）情況和數據庫的抗壓性能。

在查詢平臺上進行測試時，是對整個查詢的流程（包括查詢平臺應用服務、網絡情況、查詢接口服務、任務配置、數據庫）的抗壓性能進行測試。

注意：進行壓力測試時系統會在短時間內模擬多人同時執行查詢的情景，可能會對OfficeQuery服務和您的數據庫性能有一定影響(根據您的配置情況而定）。請在進行測試前與數據庫管理員溝通協商測試時間和測試方法（例如測試參數、并行數量等）。

4.2.1 在控制臺上進行壓力測試

在控制臺上打開查詢任務的執行界面，輸入查詢參數，點擊“壓力測試”按鈕。

在界面上輸入查詢參數點擊“壓力測試”

然后在“壓力測試”對話框中輸入模擬調用數量。模擬調用數量可以是一個1-100之間的數字。模擬調用數量越高，系統生成的調用請求就越多。

輸入模擬調用數量

點擊“確定”后，系統將同時發起多個執行請求，調用被測試的任務。并在界面上顯示測試的結果。

壓力測試結果

在這個對話框中：