Office Online Server只读模式下CUBEVALUE更新参数后不自动刷新问题

以下方案按实施复杂度从低到高排列，优先测试前两个配置类方案，兜底用前端脚本方案： #

方案1：Excel工作簿本地配置调整（无服务器权限可先试这个） #

不需要改服务端配置，直接修改上传前的源Excel文件即可：

• 打开源Excel文件，找到对接SSAS Cube的OLAP连接，进入「连接属性」面板
  • 勾选「打开文件时刷新数据」
  • 进入参数配置页，找到和浏览器视图参数绑定的单元格项，勾选参数值变更时自动刷新对应连接（绝大多数场景漏勾这个项就会出现只读模式下参数改了不触发连接刷新的问题）
• 进入Excel公式计算选项，确认计算模式设置为自动计算，不要选手动计算模式
• 重新进入「浏览器视图选项」，确认参数绑定关系正常，保存文件后覆盖上传到SharePoint文档库，清空浏览器缓存后测试即可。

方案2：服务端配置修正（需要OOS和SharePoint场管理员权限） #

这个是根治配置类问题的方案，默认部署的OOS经常会关闭参数触发刷新的开关：

1. 登录Office Online Server服务器，以管理员身份打开PowerShell，执行以下命令加载OOS管理模块并修改Excel计算服务全局配置：

# 加载OOS管理模块
Import-Module OfficeWebApps
# 开启参数变更时自动刷新连接的全局开关
Set-OfficeWebAppsExcelSetting -RefreshOnParameterChange $true
# 开启CUBE类函数随参数更新自动重算的开关
Set-OfficeWebAppsExcelSetting -AutomaticCUBEFunctionRefreshOnParameterUpdate $true
# 重启Excel计算服务和IIS使配置生效
Restart-Service WACServer
iisreset /noforce

2. 登录SharePoint2019管理中心，进入对应Web应用关联的Excel服务受信任文件位置配置，确认：

• 外部数据刷新权限设置为「允许刷新」
• 勾选「允许参数查询触发自动重算」
  配置完成后等待5分钟左右服务生效，再测试只读模式下的参数变更场景。

方案3：JSOM脚本兜底（前两个方案配置后仍有兼容问题时用） #

不需要修改服务端全局配置和源文件，通过SharePoint页面注入脚本，监听参数提交事件自动触发连接刷新，用的是OOS官方支持的客户端对象模型接口，无兼容性问题：

• 在承载Excel Online的页面/文档库加脚本，监听EWA（Excel Web Access）控件的参数提交事件，触发后自动调用刷新所有连接的接口即可，核心逻辑参考：

// 等待EWA控件加载完成
if (window.ewa) {
  ewa.EwaControl.add_applicationReady(function(){
    const wb = ewa.getActiveWorkbook();
    // 监听参数面板应用事件
    wb.add_parametersChanged(function(){
      // 自动刷新所有连接，替代手动点击操作
      wb.refreshAllConnectionsAsync();
    })
  })
}

这个方案可以针对单个站点集、单个文档库甚至单个文件部署，不会影响其他OOS承载的文件。 #

常见踩坑说明：

• 不要在Excel连接里硬编码存储SSAS访问凭据，使用Windows集成认证或者SharePoint受信任数据连接库存凭据，硬编码凭据的场景下OOS会默认禁用自动刷新逻辑防止凭据泄露
• 测试时不要同时打开同一文件的编辑模式和只读模式标签页，会话缓存会导致刷新逻辑不触发
• 如果SSAS Cube存在自定义计算成员，先把SSAS实例升级到2017及以上最新累积更新，老版本SSAS和OOS对接时存在参数传值上下文丢失的已知问题

内容的提问来源于stack exchange，提问作者Joseph Caruana