本文档主要汇总 FineBI For Excel 插件常见问题和解决方案。

2.1 平台端安装常见问题

2.1.1 提示「插件版本过高，需升级系统」

问题描述：

提示「插件版本过高，需升级系统」

解决方案：

FineBI 版本需要为 5.1.12 及以上才能安装插件，若版本过低需要先升级 FineBI ，检查FineBI版本参见： FineBI 版本 

2.1.2 上传插件时提示「文件上传失败」

问题描述：

上传插件时提示「文件上传失败」

解决方案：

请按以下步骤操作：

1）点击 F12 打开开发者调试页面后再点击「Network」按钮

2）重新上传插件，若 network 页面中返回了报错信息:  Request Entity Too Large , 说明需要修改 Nginx 的文件限制大小，详细操作请参见:  nginx常见报错及解决方案

2.1.3  插件安装无反应，不显示进度条，不显示安装完成

问题描述：

插件安装后无反应，不显示进度条，不显示安装完成

解决方案：

多次刷新浏览器、重新安装插件、或者再等待一段时间。可参见 插件管理 进行排查，若不能处理，可点击界面右侧按钮联系帆软技术支持。

2.2 客户端安装常见问题

2.2.1 插件安装过程中报错：FineBI5.1/excel/FineBIForExcel.vsto

问题描述：

插件安装过程中报错有如下提示：FineBI5.1/excel/FineBIForExcel.vsto

解决方案：

下载 FineBI For Excel运行环境，解压后，点击修复，按照提示完成修复步骤，再双击安装excel插件客户端插件。

（FineBI For Excel运行环境的教程可参见 教程视频）

2.2.2 安装过程中遇到权限问题

问题描述：

安装过程中遇到权限问题

解决方案：

右击以管理员身份运行安装

2.2.3 安装过程中有杀毒软件警告或阻止

问题描述：

安装过程中有杀毒软件警告或阻止

解决方案：

将杀毒软件退出后重新安装插件

2.2.4 安装完毕后，Excel 顶端无「 FineBI 」标签

问题描述：

安装完毕后，Excel 顶端无「 FineBI 」标签

解决方案：

请按以下步骤操作：

1）确定用户端已安装插件

2）确定 Excel 已激活，未激活的Excel无法安装插件

3）打开 Excel，点击「文件-选项-加载项」，管理中选择禁用项目，查看插件是否被禁用，启用插件后重新打开 Excel 

4）运行插件安装目录下的 FineBIForExcelRepairTool.exe 修复工具进行修复，运行时若出现 Requested registry access is not allowed，则直接进行第 5 步

5）使用「 FineBI For Excel 运行环境」进行修复，下载并使用 FineBI For Excel运行环境 进行修复后，再重新安装插件（FineBI For Excel运行环境的教程可参见 教程视频）

6）查看 Excel 「文件-选项-自定义功能区」，检查主选项卡中是否勾选 FineBI

7）若自定义功能区空白，查看 COM 加载项，取消勾选 PageOffice Addin加载项，关闭所有 Excel 后重新打开 Excel 

8）检查环境中是否安装有天锐绿盾，需要用户调整天锐绿盾防护策略，允许 Excel 安装插件

2.3 用户端登录常见问题

2.3.1 登录插件时，登录页面空白

问题描述：

登录插件时，登录页面空白，如下图所示：

解决方案：

请按以下步骤操作：

1）若用户使用的是 IE 浏览器：

• 检查 IE浏览器 版本是否为 IE11，若版本低需要先升级浏览器（IE11下载链接）

      （若用户只能连接内网，升级前需要安装补丁 适用32位版本的 windows、适用64版本的 windows 安装完补丁后重启电脑，再离            线安装升级 IE11）

• 清除 IE浏览器 缓存后重新登录

2）运行插件安装目录下的 FineBIForExcelRepairTool.exe 修复工具，点击「安装 Edge 内核」。安装完毕后重新登录，内置浏览器顶部标签带有（ Edge 内核）则代表 Edge 内核的内置浏览器安装成功，若安装失败，请尝试更新 Windows 系统后重新登录

2.3.2 登录后提示「Excel 插件未安装/被禁用，无法使用」

问题描述：

登录后提示「Excel插件未安装/被禁用，无法使用」

解决方案：

请按以下步骤操作：

1）检查客户平台插件是否已安装或启用

2）检查用户端 BI 地址输入是否正确（BI 新建一个仪表板，截取/v5之前的地址即为 BI 地址）

3）检查客户电脑控制面板中是否有多个 excel 插件，若有则需要将旧插件卸载

4）检查 BI 安装路径%FineBI\webapps\webroot\WEB-INF\lib下是否有 fine-bi-excel-plugin-5.1.jar，若有则需要将其删除并重启 FineBI 

5）更改 BI 地址中的传输协议，http 改为 https 或者 https 改为 http

2.3.3 点击加载表数据，报错：数据刷新失败

问题描述：

点击加载表数据，报错：数据刷新失败，如下图所示：

解决方案：

请按以下步骤操作：

1）控制面板-程序卸载，查看是否有两个 FineBI for Excel 程序，如下图所示：

2)将两个 FineBI For Excel 程序都卸载，如下图所示：

3）再安装 Excel 客户端

Excel 插件安装请参见：安装

2.4 加载表数据常见问题

2.4.1 加载表数据时报错「xxxx Error message is Empty！」

问题描述：

加载表数据时报错「xxxx Error message is Empty！」

解决方案：

确定用户是否为集群转发环境，若是，可参见 集群转发环境 解决

2.4.2  加载后字段值扩展后未自动生成表格，除第一行外其余没有表格背景

问题描述：

加载后字段值扩展后未自动生成表格，除第一行外其余行没有表格背景填充。

解决方案：

在 Excel 中点击「文件-选项-校对-自动更正选项-键入时自动套用格式」，勾选「在表中包含新行和列」，重新加载表数据。

2.4.3 报错「单个sheet中不允许有多个BI明细表」

问题描述：

报错「单个sheet中不允许有多个BI明细表」

解决方案：

请按以下步骤操作：

1）确认单个 sheet 内是否有多个表格区域（判断依据：字段右下角是否有多个直角标志）

2）为了不影响其他公式的引用，可在当前明细表的下方间隔几个空行，从左到右依次对应拖入字段，然后通过删除行的方式将之前拖入的字段及空白行删除。

2.4.4 一直卡在「正在读取表字段信息」

问题描述：

一直卡在「正在读取表字段信息」，且预览发布时报错：无法将类型为“System._ComObject”的COM对象强制转化为接口类型xxxxxx，异常来自HRESULT：0x80029C4A（TYPE_E_CANTLOADLIBRARY）

解决方案：

确认之前是否安装过 WPS，并将其卸载过。由于 WPS 卸载残留导致 Excel 功能受损，所以需要重新下载安装 WPS 或更新

Excel 版本，比如 Office 2019。

2.5 预览发布常见问题

问题描述：

预览时日期字段的字段值显示成英文

解决方案：

日期字段的默认格式受系统区域和日期设置的影响，需用户修改系统环境设置，或者用户端 Excel 中设置日期字段为其他的数值类型。

2.6 筛选过滤常见问题

问题描述：

Excel 端过滤组件弹窗空白，无法点击添加过滤组件或弹窗中组件布局混乱。

解决方案：

请按以下步骤操作：

1）检查客户IE浏览器版本是否是IE11

2）清除客户IE浏览器缓存后重新打开过滤弹窗

2.7 数据透视表常见问题

2.7.1 数据透视表预览后值没有扩展

问题描述：

数据透视表预览后值没有扩展

解决方案：

选中「数据透视表>更改数据源」，查看数据源引用路径是否是绝对路径，若为绝对路径，则需要更改Excel设置：

• 点击「文件-选项-信任中心-信任中心设置-个人信息选项」，取消勾选「保存时从文件属性中删除个人信息」，重新发布 Excel 报表。

• 上述方法仅更改当前模板设置，之后新建的Excel还会出现此问题。下载 EXCEL12.XLSX 将文件放入C:\Windows\SHELLNEW并替换原 EXCEl12.XLSX 文件，可更改 EXCEL文件全局设置。

2.7.2 发布后数据透视透视表的列宽自动变宽了

问题描述：

发布后数据透视表的列宽自动变了

解决方案：

点击「文件-选项-数据-编辑默认布局-数据透视表选项」，「布局和格式」中取消「更新时自动调整列宽」