1. 概述编辑
1.1 版本
| 报表服务器版本 | 数知鸟插件版本 | 版本要求 |
|---|---|---|
| 11.0 | - | - |
| 11.0 | V10.0.17 | 1）「数知鸟单点登录配置」位置优化 2）新增新手引导 |
| 11.0 | V10.0.32 | 1）新增支持自动同步报表目录 2）集成配置界面交互优化 3）新增小助手权限分配 |
注：在工程可连接帆软市场、自动获取插件的情况下，数知鸟插件会自动更新到最新适配版本。
1.2 视频教程
1.3 应用场景
为什么要把数知鸟集成到帆软数据决策系统：
1）业务统一报表需求反馈入口，数据人员快速响应。
2）集中管理需求，便于排期和统计工作量。
3）需求处理过程自动记录，方便追溯迭代过程。
4）关注「反馈数量多」的报表，找到数据价值切入口。
具体效果请参见：https://bbs.fanruan.com/thread-133535-1-1.html
1.4 使用前提
帆软数据决策系统工程为外网环境，或内网环境且为HTTPS协议情况下，可直接参考本文使用数知鸟。
帆软数据决策系统工程为内网环境且为HTTP协议情况下，如需使用数知鸟：
1）必须要有对应的公网IP
2）需将以下域名加入白名单中：
eliteapp.fanruan.com
eliteres.fanruan.com
eliteres.obs.cn-north-4.myhuaweicloud.com
www.shuzhiniao.com
shuzhiniao.com
2. 集成准备编辑
2.1 注册数知鸟
用户点击此链接注册并登录数知鸟平台：数知鸟
2.2 设置用户体系和用户
数知鸟的通讯录支持多种用户体系：企业微信用户体系、钉钉用户体系、飞书优化体系、自建用户体系。
任一用户体系均可集成帆软数据决策系统。在集成前，管理员必须需要先选择用户体系。
点击查看通讯录相关设置：通讯录设置
注：必须先选择体系，不然无法在FR/BI中正常使用。
选择用户体系后，在通讯录中添加成员，如下图所示：
2.3 设置空间和空间成员
管理员必须先创建一个空间，用于存放集成工程后的需求反馈信息。
点击「空间>创建空间」，输入空间相关信息，点击「创建」即可。
若选择关闭「公开空间」，则管理员需要为该空间设置可见成员。
在空间页面点击「空间设置>成员管理」，点击「添加成员」，将协作的同事拉进空间内。
注：如果同事不在空间内，将无法正常反馈需求。
2.4 FineReport 安装插件
如需使用数知鸟集成功能，必须确保在工程上安装数知鸟插件。
点击下载插件：数知鸟插件
设计器插件安装方法参照：设计器插件管理
服务器安装插件方法参照：服务器插件管理
注1：插件安装完成后，需要重启报表工程，插件方可生效。
注2：11.0版本的报表工程，内置了数知鸟插件。
注3：工程安装了 V10.0.32 之前版本的数知鸟插件，且从未进行过数知鸟与工程集成的用户，请先将插件升级至 V10.0.32 及之后版本再进行集成配置，否则无法使用数知鸟集成功能。
3. 集成配置编辑
3.1 数据决策系统配置
管理员登录数知鸟平台，点击「设置>集成配置」，打开集成开关，复制 API key 和 公司ID 。
超级管理员登录数据决策系统，点击「系统管理>数知鸟」。
在「数知鸟单点登录配置」处填写获取的 API key 和 公司ID 。填写完毕后点击「保存」，如下图所示：
3.2 数知鸟配置
管理员登录数知鸟平台，点击「设置>集成配置」，填写服务器地址、成员匹配方式、默认归属空间。点击「集成检测」，即可完成集成配置。
1）服务器地址，即为需要与数知鸟集成的帆软数据决策系统工程地址，形如http://ip:port/webroot/decision。
只有在填写服务器地址后，才可以自动同步报表目录，也可在数知鸟中看到报表的访问量。具体效果可查看文档：查看报表访问量
V10.0.32以下版本的数知鸟插件，不支持自动同步报表目录，只能手动点击同步。详情请参见：历史版本
2）成员匹配方式有两种：
选择「手机号匹配」：需要通讯录里同一个用户的手机号和帆软数据决策系统的手机号一致
选择「成员ID匹配」：需要通讯录里同一个用户的成员ID和帆软数据决策系统的用户名一致
3）默认归属空间，即为2.3节创建的空间，用于存放工程反馈的需求，如不设置，则需求会被提交到上一次打开的空间。
4）集成检测，若集成检测结果不正确，则会提示「服务器地址不正确或帆软决策系统插件版本过低，请升级插件」。
4. 设置权限编辑
4.1 分配空间使用权限
1）确保同事在企业内
集成成功后，如果您需要让数据决策系统中的用户使用该功能，请先确保数据决策系统中的用户在数知鸟的「通讯录」和「空间」中。
即为本文2.2节和2.3节相关配置
2）分配空间相关权限
在数知鸟配置界面，点击「空间>空间设置>权限分配」，为空间成员分配「新增需求」权限即可。
该权限默认分配，管理员也可做更细致权限划分。详情可查看帮助文档：空间成员管理
4.2 分配小助手使用权限
1）确保同事在企业内
集成成功后，如果您需要让数据决策系统中的用户使用该功能，请先确保数据决策系统中的用户在数知鸟的「通讯录」中。
详情请参见：通讯录配置文档
2）分配小助手使用权限
在数知鸟配置界面，点击「设置>企业权限」，为指定部门/角色分配「帆软决策系统」权限即可。
5. 效果预览编辑
确定以上步骤操作无误，即可开始使用：
请使用非超管账号登录数据决策系统，确保能实现以下步骤：
注：admin账号只做集成操作，如果想让admin账号看到AI小助手和侧边栏，可以进行如下操作：
1）成员ID匹配：在数知鸟通讯录内添加一个用户ID为admin账号的用户
2）电话号码匹配：给admin账号添加某一个企业内人员的电话即可
6. 注意事项编辑
6.1 跨域重复配置冲突
决策系统使用了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;
6.2 寻求帮助
若您无法实现第六章中的 4 个环节，或者想体验下demo，请微信联系我们，我们将协助您顺利使用。
