1. 概述
数知鸟支持与帆软决策系统集成，实现数据需求的规范管理、企业指标资产的沉淀——
规范需求处理流程，统一反馈入口；
透明需求处理进度，降低沟通成本；
明确指标计算口径与报表制作思路，提升交接效率；
同步报表浏览量，便捷监控报表上线效果；
【具体效果】：https://bbs.fanruan.com/thread-133535-1-1.html
1.1 配置基础
| 数知鸟能否和FR或BI集成，是由决策平台使用的jar包版本决定的。简单来说： |
|---|
| 1）FR11.0：无jar包版本的限制 |
| 2）FR10.0：jar包版本是2019-11-08及之后版本可以正常使用，之前版本无法正常使用 |
| 3）FR9.0：不支持和数知鸟集成 |
| 4）FR8.0：不支持和数知鸟集成 |
5）FineBI：根据使用的 FRjar版本时间（注册管理-版本信息-报表模块） 判断支持情况 注：FineBI数据集集成功能仅支持2021.11.08（5.1.17）及之后的版本 |
数知鸟插件版本：升级数知鸟插件至10.0.32及以上后，报表目录和数据集可实现自动同步，无需手动点击同步
集成使用允许环境：不论外网还是内网环境，仅支持https地址
1.2 PC端
1）功能相关：支持需求反馈与关联内容
2）参照基础配置要求
1.3 移动端
1）功能相关：支持需求反馈，暂不支持关联内容
2）展示形式：支持H5，暂不支持APP等
3）模版类型：BI、FR（cpt、frm）
4）版本要求：
jar包：2019-12-05及之后
插件：HTML5移动端展现版本为10.4.982及以上，数知鸟插件版本为10.0.48及以上
| 视频教程（建议观看）
2. 配置步骤
第一步：数知鸟平台设置通讯录、集成卡片
1.1 选择用户体系，设置通讯录
数知鸟的通讯录支持四种用户体系：企业微信用户体系、钉钉用户体系、飞书用户体系、自建用户体系。
任意用户体系均可集成帆软数据决策系统，在集成前，需要先选择用户体系。点击跳转查看通讯录设置
注意：必须先选择体系，不然无法在FR/BI中正常使用
1.2 新建空间，将相关成员拉入其中
新建空间具体操作可点击帮助文档查看。
想象即将建一个群，点击左边工具栏的「空间」，点击「创建空间」，围绕数据项目、业务部门、工作目标等进行空间新建和命名。
拉入新成员，具体操作可点击帮助文档查看。
进入「空间设置」>「权限设置」，在默认的空间成员权限组中点击成员框，添加新成员。
1.3 设置集成卡片
「设置」>「集成配置」，进入集成卡片的设置。点击左上角可修改集成系统的名称，为确保正常集成请开启集成按钮。
第二步：帆软决策平台安装插件、填写配置字段
以FineReport/FineBI超级管理员【admin】的身份，登录决策平台，在插件商城找到并安装“数知鸟”插件。
注意：请同时在浏览器中打开数知鸟平台
2.1 安装/更新插件
「管理系统」>「插件管理」>搜索“数知鸟”>「安装」。
注：因插件界面升级，若已安装插件，请在【我的插件】中更新最新数知鸟插件
「管理系统」>「插件管理」>「我的插件」>选中“数知鸟”进行更新。
2.2 填写配置字段
「管理系统」>「数知鸟」>填写「数知鸟单点登录配置」
从数知鸟的页面：https://shuzhiniao.com/web/#/settings/system/sso , 复制API KEY和公司ID到决策系统中。
填写完毕后，点击“保存”
第三步：数知鸟平台填写服务器地址、补充集成卡片设置
3.1 填写服务器地址
回到数知鸟平台安全配置界面，请填写【服务器地址】，只有在填写服务器地址后，才可以自动同步报表目录，也可在数知鸟中看到报表的访问量。具体效果可查看文档：查看报表访问量
3.2 选择成员匹配方式
成员匹配方式有两种，一种是“手机号匹配”，另一种是“用户ID匹配”
选择“手机号匹配”：需要通讯录里同一个用户的手机号和的手机号一致
选择“用户ID匹配”：需要通讯录里同一个用户的用户ID和的用户名一致
（帆软决策系统中，“用户名”和“手机号”的位置）
（数知鸟中，“用户ID"和“手机号”的位置）
3.3 选择默认归属空间
在数知鸟集成配置中选择默认归属的空间。
3.4 可见范围
在数知鸟集成配置中设置该集成配置的作用范围
3.5 集成检测
点击「集成检测」，检验集成是否成功，若不成功则可根据帮助文档排查失败原因并解决。
第四步：确定使用权限
4.1 确保同事在企业及默认归属空间内
设置成功后，如果您需要让您的同事使用该功能，请先确保您的同事在数知鸟的“通讯录”及默认归属空间内中。
4.2 确保同事具有帆软决策系统权限
检查确保同事在集成卡片【可见范围】之内
第五步：测试
确定以上步骤操作无误，即可开始使用，请确保能实现以下环节（以非admin账号测试）：
注：admin账号只做集成操作，如果想让admin账号看到AI小助手和侧边栏，可以进行如下操作：
①用户ID匹配：在数知鸟通讯录内添加一个用户ID为admin账号的用户
②电话号码匹配：给admin账号添加某一个企业内人员的电话即可
3. 可能遇见的问题
决策系统使用了Nginx和HTTPS协议，并且在检测提示无法连通的用户，那么在FineReport的Nginx配置中，如果之前的配置中存在如下配置，则最后一行加上proxy_hide_header Access-Control-Allow-Origin;解决跨域重复配置的冲突问题。
add_header Access-Control-Allow-Origin *;
add_header Access-Control-Allow-Headers X-Requested-With,content-type,authorization;
add_header Access-Control-Allow-Methods GET,POST,OPTIONS;
3.1 寻求帮助
若您无法实现上图中的4个环节，或者想体验下demo，请微信联系我们，我们将协助您顺利使用。
