1.概述
数知鸟集成FR/BI可能会遇到一些问题，这里提供一些常见问题的排查思路及解决方案
首先检查您的版本及环境是否支持集成数知鸟
2.集成成功必配项
1. 复制两个字段（API Key，公司ID）到FR/BI
2. 在数知鸟平台选择用户匹配方式（用户ID/手机号）
3. 必须配置 服务器地址，因此若旧用户原本未配置服务器地址，现只升级插件，则集成不成功
4. 在数知鸟平台给用户所在部门/角色添加 帆软决策系统 权限（企业成员默认有新增集成的权限）
3.集成现象及问题排查
3.1 集成检测结果为“集成连接正常”
| 问题 | 排查项 | 解决方法 |
|---|---|---|
用户无法单点登录 （即用户在FR/BI端无法看见数知鸟AI小助手及相关集成效果） | 1.确保该FR/BI账号在数知鸟内有对应匹配账号 如，FR/BI内查看账户为admin账户，该账户在数知鸟内没有正确匹配上（手机号匹配/成员ID匹配） | 将该账户做出正确匹配（同下） 切换绑定正确的账户查看 |
| 2.检查匹配方式 |
| |
3.检查用户的ID/手机号 | ||
4.检查数知鸟用户权限 该用户是否有帆软决策系统权限 【设置】->【企业权限】->按…分配->【帆软决策系统】
| 为该用户开启帆软决策系统权限 | |
| 用户显示在FRBI平台有单点入口，但点击后显示登录页面 | 检查下FR/BI所在的服务器时间：FR/BI服务器时间比北京时间慢5分钟以内，可以正常单点，比北京时间慢5分钟以外，会超时无法单点 | FR/BI服务器时间调整正确 |
3.2 集成检测结果提示失败原因
失败原因有：未选择用户匹配方式；服务器地址不正确；API Key、公司ID不匹配,前往帆软决策系统配置；服务器地址不正确或帆软决策系统插件版本过低，请升级插件
| 问题 | 排查项 | 解决方案 |
| 报错“未选择用户匹配方式” | 是否选择用户匹配方式 | 选择用户匹配方式 |
| 用户服务器地址是复制的FRBI工程地址，但集成检测出现提示 “服务器地址不正确或帆软决策系统插件版本过低，请升级插件” | 1.检查服务器地址是否填写正确 | |
2.检查插件版本 | 数知鸟插件更新至最新版本 注意：
| |
3.企业的https证书是否为无效 在浏览器打开此地址，看是否显示“链接不安全”、“证书无效”
| 申请有效证书 | |
4.检查服务器地址是否为完整地址 浏览器打开该服务器地址，右击选中“显示网页源代码”
比如工程地址为https://xxx.com/decision，做了iframe映射，只要访问 https://xxx.com/ 即可，数知鸟服务器地址需要填写 https://xxx.com/decision，填写 https://xxx.com/ 会报错 | 服务器地址填写完整地址 | |
5.用户是否做了CAS单点登录 检查单点登录配置文件（通常是Tomact\webapps\webroot\WEB-INF 路径下的web.xml文件）是否排除了数知鸟相关接口单点 | 增加内容：<url-pattern>/decision/elite/open/*</url-pattern>
| |
| 之前集成检测成功，但现在出现集成提示 “API Key、公司ID不匹配,前往帆软决策系统配置”，但检测配置等都没有问题 | 检查服务器地址是否更改：比如原本的http工程换成了https，但http仍能访问，服务器地址填写了http，API Key、公司ID配置在了https服务器 | 正确填写API Key、公司ID或服务器地址 |
