需注意以下几点:
1)如果报表工程显存在%FR_HOME%/webapps/webroot/WEB-INF/lib/commons-codec-1.6.jar,则须要删掉。
2)若只是同步数据,不需要推送,需要满足:FineReport 工程所在的服务器可以 ping 通云中心的地址:cloud.fanruan.com。如下图所示:
3)若须要数据推送,FineReport 报表服务器地址须要配置内网。
如果服务器在外网,需要配置一层转发,在转发服务器配置简道云网路白名单,具体简道云 ip 和域名可以联系简道云技术人员。
4)该插件目前只支持 MySQL 数据库。
2.1 安装插件
点击下载插件:报表对接简道云插件
设计器插件安装方式参照 设计器插件管理
服务器安装插件方式参照 服务器插件管理
插件安装完成后,默认启用,管理员登陆决策系统,点击「管理系统>简道云对接」,可以步入配置页面。如下图所示:
2.2简道云创建 API Key
在登陆简道云且已订购的情况下,如下图查看简道云的 API Key,即简道云秘钥,若没有见到 API Key,点击创建 API Key 即可。如下图所示:
2.3 简道云表单开启数据推送
数据推送(Webhook)可将表单数据推送到 FineReport 服务器,功能介绍及使用说明参见简道云帮助文档:数据推送
注:若须要数据推送,FineReport 报表服务器地址须要配置内网。
1)在设计完表单以后,进入「扩展功能」,点击「数据推送>新建数据推送」,如下图所示:
2)在「目标服务器」位置选择「FineReport 服务器」,填写服务器地址,地址格式:主机名:端口/工程名/decision/view/report?op=fs_jdy
注1:地址中的主机名表示可以被内网访问的因特网主机域名或则 IP 地址,后面「/工程名/decision/view/report?op=fs_jdy」固定。
如果服务器在外网,需要配置一层转发,在转发服务器配置简道云网路白名单,具体简道云 ip 和域名可以联系简道云技术人员。
注2:请严格依照文档提供的地址格式填写服务器地址,「/view/report?op=fs_jdy」后缀不能省略。
示例:
:8080/webroot/decision/view/report?op=fs_jdy
,其中端口为80,默认省略。
点击测试联接成功后,保存即可。
3)设置完成,如下图所示:
注:这一步必须成功才可以,如果推送失败,简道云会重试最多 5 次。如果连续重试 5 次均失败,该表单的数据推送功能将被关掉,管理员将会获得消息通知。管理员须要在数据推送设置中重新启动数据推送,数据推送就会继续。
至此一张表单开启 Webhook 的工作已经完成,需要手动同步的表单,需要开启 Webhook 。
2.4 FineReport 插件同步表单数据2.4.1 配置关联第一次同步数据
1)管理员登陆决策系统,点击「管理系统>简道云对接>数据同步>配置关联」,填写简道云秘钥,填写私有数据库的信息:包含驱动、地址、用户名、密码,示例使用的是 MySQL 数据库,如下图所示:
需要注意以下几点:
2)点击「开始联接」,连接成功后,点击「开始同步」,弹出「同步成功」,如下图所示:
3)同步成功后可以看见状态变为「关联成功」,同时简道云里的表单也同步到私有库里,如下图所示:
注:同步到 MySQL 数据库中的表中,有些表包含 _childid 字段,该数组表示当前子表单的 id ;_id 代表父表单的 id 。
2.4.2 修改私有库表名
配置成功后,可以双击私有库表名,进行重命名,勾选对应表单名,然后点击「同步表单数据」即可,如下图所示:
注:修改私有库表名后,在简道云中关掉数据推送时,会删除数据库中同步表的记录,再次开启推送时会重新根据规则生成新的表名。
2.4.3 同步表单或表单数据
表单和表单数据支持「自动同步」和「手动同步」两种形式:
1)自动同步
管理员必须在简道云端设置数据推送,表单方可进行实时同步。
如未设置推送,仅在数据决策平台设置了关联库,则似乎显示同步成功,但无相关数据。
2)手动同步
管理员可在数据决策系统端自动点击「同步表单」/「同步表单数据」按钮,实现自动同步简道云数据到数据决策系统。
同步设置如下图所示:
2.5 运行监控
切换到「运行监控」标签页,只监控表结构的变化,包含数据库表的增删改和表数组的增删,不需要记录具体表数据的变化,如下图所示: