历史版本20 :报表对接简道云插件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 描述编辑

简道云:简道云是领先的SaaS提供商,借助其强大易用的功能,为用户提供极其方便的在线数据管理、协作服务,几乎不需要任何技术基础就可以快速构建数据应用。

FineReport和简道云在使用场景下各有优劣,简道云在支撑业务部门的新增的数据采集场景有其灵活方便的优势,而FineReport在展现上的灵活和丰富上又是无与伦比的,通过报表对接简道云插件,强强结合,能提供给客户更好的解决方案。

支持将简道云的数据通过FineReport抽取到用户的私有库中,并基于FineReport制作展现形式更为丰富的报表。并且当简道云开启推送后,FineReport会随着简道云的数据更新而更新。


2. 版本编辑

  报表服务器版本插件版本   jar包 
  9.0  V1.0  2017-12-08

3. 功能介绍编辑

可将简道云中的数据通过FR抽取到私有库中。并且当简道云开启推送后,FR会随着简道云的数据更新而更新。

注:如果报表工程内存在%FR_HOME%/WebReport/WEB-INF/lib/commons-codec-1.6.jar,则需要删除

4. 操作步骤编辑

4.1 安装插件

设计器插件安装方法参照设计器插件管理 

服务器安装插件方法参照服务器插件管理

安装完成后,默认插件启用,管理员登录决策系统,管理系统里新增标签简道云对接,如下图:
222

4.2 简道云账户中心创建API Key
在登录简道云且购买的情况下,API Key即简道云密钥(若没有看到API Key,点击创建API Key即可)如下图:
222
4.3简道云表单开启数据推送(webhook)

数据推送(webhook)可将表单数据推送到FR服务器,功能介绍及使用说明请查看帮助文档

注:这里报表服务器需要外网可以访问

登录简道云,选择一个表单,点击表单设置>数据推送,点击新建数据推送,选择模板服务器:FineReport服务器,填写服务器地址,例如:http://www.finereporthelp.com:8181/xxx/ReportServer?op=fs_jdy,点击“服务器连接测试”,若连接失败提示失败的原因,点击保存,如下图:

222
设置完成,如下图:


222

注:这一步必须成功才可以,如果推送失败,简道云会重试最多5次。如果连续重试5次均失败,该表单的数据推送功能将被关闭,管理员将会获得消息通知。管理员需要在数据推送设置中重新启动数据推送,数据推送才会继续。

这样这一张表单开启webhook就完成了,需要同步的表单,都需要开启webhook


4.4 FR插件同步表单数据
1)配置关联第一次同步数据

点击管理系统>简道云对接>数据同步,点击配置关联,填写简道云密钥,还有私有库的信息:包含驱动/地址/用户名/密码,如下图:


222

注:私有库暂时只支持mysql数据库 

点击开始连接,连接成功后,点击同步数据,弹出“同步成功”,如下图:

222

同步成功后可以看到,关联成功,同时简道云里的表单也同步到私有库里,如下图:
222

2)修改私有库表名

第一次配置私有库时,可以重命名,如下图:

222

配置成功后,可以实时拉取到需要同步的表,并给双击私有库表名,重命名,点击同步表单即可,如下图:


222

3)同步表单/表单数据

同步表单:同步表结构的变化,包含数据库表的增删改和表字段的增删

同步表单数据:同步表内容的变化,包含表内容的增删改

勾选需要同步的简道云表单名,然后点击同步表单/同步表单数据,如下图:

222

4.5 运行监控

切换到运行监控标签页,只监控表结构的变化包含数据库表的增删改和表字段的增删,不需要记录具体表数据的变化,如下图:

222

5. 注意事项编辑

1)暂时只支持mysql;

2)如果简道云传过来的是数组,fr转化成字符串,用","分隔;

3)配置存储

a.私有库相关的配置信息存储到jdyconfig.xml中,xml在插件所处文件夹下,例如/WEB-INF/plugins/plugin-com.fr.plugin.third.integrate.jdy-1.0/jdyconfig.xml

b.表单和表名的对应关系存储到数据库里(同步的那个mysql数据库里

在私有库配置成功后,立即创建表JDY_CONFIG(如果已存在则加数字编号,从0开始),表结构如下

字段
含义
id主键
jdyformid简道云表单id
jdyformname简道云表单名称
frtablenamefr私有库表名称

c.表字段的id和实际名称的对应关系存储到数据库里

表JDY_FIELD_CONFIG(如果已存在则加数字编号,从0开始),表结构如下

字段
含义
id主键
jdyformid简道云表单id
jdyfieldid简道云字段id
jdyfieldname简道云字段名称