Office 365本地环境集中部署Office-JS Word加载项报错如何解决
针对Office-JS Word加载项Sideloading模式运行正常、SharePoint Catalog部署时报错此加载项使用了其加载项目录不支持的功能的问题,具体原因和解决办法如下:
问题产生原因
- API要求集版本超出支持范围:本地部署的SharePoint Server对Office JS API要求集的版本存在上限,Sideloading模式由本地Office客户端直接校验权限和兼容性,只要客户端版本足够就能运行;但SharePoint Catalog上传时会强制校验清单中声明的要求集版本,超出其支持范围就会触发报错。
- 清单包含不支持的配置节点:
<WebApplicationInfo>(SSO相关配置)、<Runtime>(共享运行时配置)、<CustomFunctions>(自定义函数配置)等节点仅支持在线SharePoint Online或者最新版的SharePoint Server,旧版本地SharePoint Catalog识别到这些未知节点时就会判定为存在不支持的功能。 - SharePoint Catalog配置异常:本地SharePoint未正确启用应用目录相关配置,或者未将加载项的托管域名加入跨域访问白名单,也会触发该类报错。
可行解决办法
- 调整清单中的API要求集版本:将清单
<Requirements>节点下声明的WordApi要求集版本,降级到对应本地SharePoint Server支持的范围,比如SharePoint 2019最高支持WordApi 1.3,SharePoint 2016最高支持WordApi 1.1,同步移除代码中超出对应版本的API调用,或者做兼容降级处理。 - 移除清单中不兼容的配置节点:删除清单中
<WebApplicationInfo>、<SharedRuntime>、<CustomFunctions>等旧版SharePoint不支持的节点,如果需要使用SSO功能,可替换为弹出页授权的兼容方案,避免依赖仅在线环境支持的SSO配置。 - 修正SharePoint Catalog配置:确认当前SharePoint Farm已正确创建应用目录站点集,上传账号具备应用目录管理员权限,同时开启自定义脚本支持,对应本地SharePoint Server的PowerShell命令为
Set-SPSite -Identity <应用目录站点URL> -DenyAddAndCustomizePages 0,同时将加载项的托管域名添加到SharePoint的外部资源访问白名单中。 - 更换部署方式:如果加载项必须使用高版本要求集或共享运行时等特性,可放弃SharePoint Catalog部署,改用组策略推送Sideloading注册表项、或者通过Microsoft Endpoint Configuration Manager批量分发本地清单文件,绕过SharePoint Catalog的校验逻辑。
内容的提问来源于stack exchange,提问作者emraldinho
相关产品推荐
相关产品推荐

