1. 概述
1.1 版本
报表服务器版本 | JAR 包版本 | 插件版本 | 云之家 App 版本 |
|---|---|---|---|
| 11.0 | 2019-03-10 | V1.8.4 | V1.0 |
| 11.0 | 2021-05-25 | V2.1.0.9 | V1.0 |
1.2 应用场景
有些用户将云之家作为移动端办公平台，希望直接将报表集成到云之家中，以轻应用作为统一入口来查看报表。
1.3 功能介绍
在云之家管理中配置基本参数，就可以读取到云之家平台通讯录，将报表用户与云之家用户绑定，就可以实现单点登录。
在定时调度的输出设置中，可以配置并推送云之家消息。
支持扫码登录。
注：云之家插件推送的消息类型不支持文件消息和图片消息。
注意：由于帆软生态要求对于所有应用秘钥类型进行加密存储，请更新到最新版本后将所有的配置都重新配置一次，避免单点和用户同步失败！！！
注意：从老版本升级到2.1.0.8以上版本时可能会丢失配置，请手动重新配置一次即可。
1.4 插件安装
平台-插件管理搜索「云之家插件」
设计器插件安装方法参照：设计器插件管理
服务器安装插件方法参照：服务器插件管理
2. 操作方法
2.1 配置用户同步
注意：这里配置的同步并不能同步到帆软报表系统的用户管理里面，只能同步到云之家成员管理。需要同步到用户管理请参考注意事项中的说明。
用户同步配置是云之家插件最基础的功能，按下图步骤配置相应的参数。
参数配置时，有两个配置项需要注意：
报表服务器地址：需要使用外网地址加上报表工程路径。
只读密钥：按下图所示步骤获取。
团队EID
帆软应用ID和密钥
使用云之家管理员访问：https://www.yunzhijia.com/developers/#/app-list
点击新建应用
通讯录同步token(如果启用）
将上面的Token复制到帆软的通讯录同步Token处即可（2021-12-22新增）云之家插件2.1.0.0版本才支持
上图URL填写：http://xxx.com:8075/webroot/decision/url/yzj/sync
启用了通讯录回调可以实时同步云之家的用户到帆软的用户系统中。
如果点击保存失败，请检查这个url是否能被云之家调用到，需要url暴露在公网。
2.2 配置单点登录
在云之家 App 的轻应用管理中把移动端访问地址，PC 端访问地址填上。需要注意用户关联关系，可以配置为 手工配置，通过工号关联，通过手机号关联。
1）配置移动端单点登录
在云之家 App 创建 FineReport 轻应用，对应地址为配置移动端单点登录。（需要先安装h5插件）
FineReport：外网地址/decision/plugin/public/com.fr.plugin.sln3063/zch/login?isApp=1
例如： http://ngrok.wiwy.us:8080/webroot/decision/plugin/public/com.fr.plugin.sln3063/zch/login?isApp=1
2）配置 PC 端单点登录
新增 PC 端自动登录接口地址，在「云之家」>「管理中心」>「轻应用管理」，选择对应的轻应用配置其 Web 端访问地址，桌面端访问地址。
FineReport：外网地址/decision/plugin/public/com.fr.plugin.sln3063/zch/login
例如： http://ngrok.wiwy.us:8080/webroot/decision/plugin/public/com.fr.plugin.sln3063/zch/login
3）单点到某一个页面（1.8.5的云之家插件才支持）
在最新的云之家插件中通过云之家管理界面的报表单点链接生成按钮，点击之后输入要回调的地址，这里要输入以http开头的地址，并且如果是报表的话，需要和前面配置的报表服务器地址是同一个域名，这样单点登录才会成功。
点击生成按钮会生成一个类似于：http://xxx.com/webroot/decision/url/yzj/login?token=1aabac6d068eef6a7bad3fdf50a05cc8 的url，将这个url复制到云之家的轻应用的移动端或pc端地址即可。
2.3 配置消息推送
创建推送之前需要创建一个公共号。
创建公众号的方法请参见：云之家公众号
2.4 配置扫码登录
1）再创建一个扫码登录的轻应用，将移动端地址指向：https://yunzhijia.com/opencloud/openthird/qrlogin
2）然后配置扫码登录的应用 ID 和密钥。
3）最后去登录页面点击摄像头即可实现扫码登录。
3. 集成问题
1）如果集成配置后无法同步到用户或部门。
首先检查云之家插件的配置是否正确，然后尝试重启tomcat再次点击全量同步。
2）如果按照上文配置了，在云之家中单点登录报404检查云之家应用配置的路径是否正确，结尾是否多了空格之类的。
3）成员同步功能同步之后会将用户存储到finedb的fine_zch_user表中，部门存储在fine_zch_dep表中。可以自行通过sql组装成树数据集来进行用户同步。
4）报表服务器需要通外网，如果有网络限制请至少开通访问api.yunzhijia.com 和www.yunzhijia.com的外网访。
5）如果同步失败请检查服务器的时间是否为北京时间 无误差。
