1. 概述
1.1 版本
報表伺服器版本 | JAR 包版本 | 插件版本 | ElasticSearch 版本 | JDK 版本 |
|---|---|---|---|---|
| 10.0 | 2019-10-25 | V1.5 | V7.6.1 | JDK 1.8 且小版本需在 JDK8u102 以上 |
注1：需要提前下載並安裝好 JDK 和 ElasticSearch，下載和安裝方法請自行查閱相關資料。
注2：以上版本資訊只是範例的環境配置，使用者可根據自己的實際應用場景選擇不同的版本。
1.2 應用場景
ElasticSearch 是一個基於 Lucene 的搜尋伺服器。它提供了一個分佈式多使用者能力的全文搜尋引擎，基於 RESTful web API。
Elasticsearch 是用 Java 開發的，並作為 Apache 允許條款下的開放原始碼發佈，是當前流行的企業級搜尋引擎。
設計用於雲端計算中，能夠達到實時搜尋，穩定，可靠，快速，安裝使用方便。
為了把搜尋結果更好的展示出來，我們提供了基於 ElasticSearch RestClient API的插件，可以方便快速的將 ElasticSearch 的查詢結果透過 FineReport 展示。
1.3 原始碼
| 開源協定 | 原始碼位址 |
|---|---|
| Apache License 2.0 | https://code.fanruan.com/fanruan/demo-tabledata-es |
2. 範例
2.1 安裝插件
點選下載插件：Elasticsearch資料集
設計器插件安裝方法參照：設計器插件管理
伺服器安裝插件方法參照：伺服器插件管理
2.2 定義 Elasticsearch 資料連結
設計器菜單欄點選伺服器>定義資料連結，建立一個 Elasticseach 資料連結，如下圖所示：
當需要使用 https 連結 Elasticsearch 時，將「使用SSL」協定勾上，並選擇 jks 憑證在伺服器上的路徑，同時輸入 jks 憑證的密碼即可。
注：支援連結 Elasticsearch 叢集，叢集主機位址和和埠之間，用英文逗號分隔，且必須保持主機位址和埠數量相等，如下圖所示：
2.3 建立 Elasticsearch 資料集
插件安裝後，資料集管理面板會新增Elasticseach資料集，點選建立資料集，如下圖所示：
2.4 資料查詢
Elasticseach 資料集查詢介面如下圖所示：
上圖中序號對應模組功能介紹如下：
| 序號 | 說明 |
|---|---|
| 1 | 執行 Elasticseach 命令按鈕 |
| 2 | 用於測試的命令 |
| 3 | 測試命令後執行的匯出 |
| 4 | 實際用於查詢的端點 |
| 5 | 實際用於查詢的查詢語句 |
| 6 | 選擇用JSON或者JS規整傳回結果 |
| 7 | 三個正文框輸入區域都可以帶參數 |
介面說明：
左側均為測試區域，可以執行各種 Elasticseach 命令。
右側為實際的資料集查詢語句，其中端點、查詢語句和規整腳本，均支援透過使用${參數名}格式的正文類引用參數。
2.5 規整腳本
規整腳本分為兩種型別：
可分別參考 JSON資料集 中 JsonPath 和 JSON 過程資料集中 JavaScript 語句的用法。
自動：採用 JsonPath 語言
自訂：採用 JavaScript 語言
點選預覽按鈕，Elasticseach 資料集查詢結果如下圖所示：
