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 接口。
Elasticsearch 是用 Java 开发的，并作为 Apache 许可条款下的开放源码发布，是当前流行的企业级搜索引擎。
设计用于云计算中，能够达到实时搜索，稳定，可靠，快速，安装使用方便。
为了把搜索结果更好的展示出来，我们提供了基于 ElasticSearch RestClient 接口的插件，可以方便快速的将 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 数据集查询结果如下图所示：
