🔥个人主页：杨利杰YJlio
❄️个人专栏：《Windows 疑难杂症与工单复盘案例库》 《Sysinternals实战教程》
《WINDOWS教程》 《Windows PowerShell 实战》 《IOS插件分析测试》
《超简单：用Python让Excel飞起来》
🌟让复杂的事情更简单，让重复的工作自动化
Excel安装SAP EPM插件：依赖修复与中文设置
- 一、先确认插件名称和适用场景
- 二、安装前检查：Office位数比Windows位数更重要
- 三、安装报错：缺少的是VSTO Runtime，不是Visual Studio
- 四、安装运行库：优先使用微软官方安装包
- 五、使用SAP Front-End Installer安装EPM组件
- 5.1 选择EPM Add-In组件
- 5.2 保持默认安装路径
- 5.3 完成安装
- 六、第一次启动EPM Add-In
- 6.1 从开始菜单启动
- 6.2 检查Excel功能区
- 七、将EPM界面切换为简体中文
- 7.1 打开用户选项
- 7.2 设置应用语言和数据语言
- 7.3 验证中文界面
- 八、建立SAP连接并完成首次验证
- 九、EPM标签不显示的排查方法
- 9.1 检查COM加载项
- 9.2 检查禁用项目
- 9.3 检查Office与安装包位数
- 9.4 检查VSTO Runtime
- 9.5 检查Excel是否处于安全模式
- 9.6 检查企业安全策略
- 十、常见问题与处理建议
- 十一、标准安装与验收流程
- 十二、处理总结
一、先确认插件名称和适用场景
本文安装的是SAP EPM Add-In for Microsoft Office。它用于在 Excel、Word 和 PowerPoint 中访问 SAP Enterprise Performance Management 相关数据，并执行报表、分析、预算、计划和数据提交等操作。
截图中的安装程序为SAP Front-End Installer，组件列表中同时包含Analysis for Microsoft Office (64 bit)和EPM add-in。安装完成后，Excel 功能区会出现EPM标签；根据所选 SAP 方案和组件，还可能出现Data Manager标签。
| 项目 | 说明 |
|---|---|
| 插件全称 | SAP EPM Add-In for Microsoft Office |
| 常见用途 | SAP BPC、财务预算、计划、合并、报表和多维分析 |
| 支持的 Office 应用 | Excel、Word、PowerPoint，具体功能以安装组件和 SAP 后端为准 |
| 安装包来源 | SAP Support Portal、组织软件中心或 SAP 管理员提供的正式安装介质 |
| 本文截图架构 | Microsoft Office 64 bit |
不要把来源不明的“EPM插件安装包”直接用于企业电脑。安装版本必须与组织的 SAP BPC、Analysis for Office、Office 版本和后台系统兼容。
二、安装前检查：Office位数比Windows位数更重要
SAP 为 EPM Add-In 提供 32 位和 64 位安装程序。选择哪个安装包，取决于 Microsoft Office 的位数，不取决于 Windows 是 64 位还是 32 位。
在 Excel 中查看 Office 位数：
文件 账户 关于 Excel“关于 Microsoft Excel”窗口中会显示32 位或64 位。
| Office架构 | 应使用的安装程序 |
|---|---|
| Office 32位 | EPM_Add-in_x32.exe或 SAP Front-End Installer 的 32 位组件 |
| Office 64位 | EPM_Add-in_x64.exe或 SAP Front-End Installer 的 64 位组件 |
安装前还应确认以下项目：
| 检查项 | 要求 |
|---|---|
| Office应用 | Excel、Word、PowerPoint 至少安装一个，并关闭全部 Office 进程 |
| 安装权限 | 使用组织批准的管理员账号执行安装 |
| .NET Framework | 以当前 EPM 安装包的 SAP 前置条件为准 |
| Visual C++运行库 | 位数应与 Office 和安装程序匹配，版本以 SAP 安装指南为准 |
| VSTO Runtime | 截图中的安装器明确要求Microsoft Visual Studio 2010 Tools for Office Runtime |
| Office版本支持 | 安装前核对 SAP Product Availability Matrix 或对应 KBA |
SAP 已确认 EPM Add-In 可在部分产品组合中支持 Microsoft Office 2024，但具体支持范围仍与 SAP BPC 产品版本和补丁级别有关。企业环境不能只根据 Office 年份判断兼容性。
三、安装报错：缺少的是VSTO Runtime，不是Visual Studio
首次运行 SAP Front-End Installer 时，安装器提示系统不满足前置条件：
Microsoft Visual Studio 2010 Tools for Office Runtime not found或者：
An old version of Microsoft Visual Studio 2010 Tools for Office Runtime was found这里缺少的是Visual Studio Tools for Office Runtime，简称VSTO Runtime。它是运行基于 .NET Framework 的 Office 加载项所需的运行环境，不需要安装完整的 Visual Studio 2010 开发工具。
微软官方安装方式为：
1. 确认系统已安装 .NET Framework 4 或更高版本 2. 下载 Microsoft Visual Studio 2010 Tools for Office Runtime 3. 运行 vstor_redist.exe 4. 完成安装后重新启动 SAP Front-End Installer微软目前仍提供独立的 VSTO Runtime，并说明该平台随 Office 和 .NET Framework 的支持生命周期进行维护。
不要根据报错名称安装完整 Visual Studio 2010 IDE。完整开发环境体积大、组件多，也不能替代正确的 VSTO Runtime 部署。
四、安装运行库：优先使用微软官方安装包
原始截图使用了第三方“微软常用运行库合集”，并在组件列表中选择了Microsoft Visual Studio 2010 Tools for Office Runtime。
这张图可以帮助识别需要的组件名称，但企业环境更建议从微软官方渠道获取vstor_redist.exe，或使用组织软件中心已经审核的安装包。
| 安装方式 | 建议 |
|---|---|
| 微软官方 VSTO Runtime | 优先使用，可核对数字签名和版本 |
| 企业软件中心 | 适合受管设备，便于统一部署和审计 |
| 第三方运行库合集 | 只在来源可信、哈希可验证且经过安全审批时使用 |
| 一次安装全部运行库 | 不建议，可能引入无关旧组件并增加维护复杂度 |
安装后可以在“设置 → 应用 → 已安装的应用”或“控制面板 → 程序和功能”中确认：
Microsoft Visual Studio 2010 Tools for Office Runtime完成后关闭安装窗口，重新运行 SAP Front-End Installer。如果仍提示版本过旧，应卸载旧版 VSTO Runtime，再安装微软当前提供的版本。
五、使用SAP Front-End Installer安装EPM组件
5.1 选择EPM Add-In组件
重新运行安装器后，在组件列表中展开Analysis for Microsoft Office (64 bit)，勾选EPM add-in。
截图中的Analysis plug-in和EPM add-in是两个独立组件。是否同时安装，应根据企业使用的 SAP 数据源、工作簿和部署标准决定。
| 组件 | 用途 |
|---|---|
Analysis plug-in | 用于 SAP Analysis for Microsoft Office 的分析功能 |
EPM add-in | 用于 SAP EPM/BPC 报表、计划和数据提交等功能 |
5.2 保持默认安装路径
安装器默认路径为：
C:\Program Files\SAP BusinessObjects\Office AddIn一般保持默认路径即可。修改路径前应确认企业脚本、插件更新、日志采集和安全策略是否依赖默认目录。
5.3 完成安装
点击“Next”开始安装，出现成功页面后点击“Close”。
安装结束后建议重启 Windows，确保 VSTO Runtime、COM 注册和 Office 加载项状态全部刷新。
六、第一次启动EPM Add-In
6.1 从开始菜单启动
安装程序会根据所选组件创建对应快捷方式：
EPM add-in for Excel EPM add-in for PowerPoint EPM add-in for Word第一次使用时，可以先从“EPM add-in for Excel”快捷方式启动。SAP 安装指南也建议至少直接启动一次 Office 应用，以完成加载项初始化。
6.2 检查Excel功能区
Excel 启动后，顶部应出现EPM标签。截图中还显示了Data Manager标签。
部分按钮在没有登录 SAP 连接、没有打开 EPM 工作簿或没有选择报表时会显示为灰色，这属于正常状态。
| 功能区状态 | 判断 |
|---|---|
显示EPM标签 | 插件已经成功加载 |
显示Data Manager | 安装方案和 SAP BPC 功能允许显示数据管理组件 |
| 标签存在但按钮灰色 | 通常需要先登录、建立连接或打开有效工作簿 |
| 完全没有EPM标签 | 继续检查加载项、VSTO、位数和禁用项目 |
七、将EPM界面切换为简体中文
7.1 打开用户选项
在 Excel 的EPM标签中依次点击：
Tools Options User Options不同 EPM 版本的菜单名称可能显示为：
EPM Options User Options如果界面布局与截图不同，应以当前 EPM Add-In 版本的“User Options”入口为准。
7.2 设置应用语言和数据语言
打开EPM - User Options后，切换到Display标签。在“Languages”区域设置：
Application Language：Chinese (Simplified) Legacy Data Language：Chinese (Simplified) Legacy| 语言选项 | 作用 |
|---|---|
Application Language | 控制 EPM 标签、菜单、按钮和对话框的界面语言 |
Data Language | 控制数据源中可翻译文本、成员描述等内容的语言，前提是后端提供对应语言 |
点击“OK”后关闭全部 Excel、Word 和 PowerPoint 进程，再重新打开 Excel。SAP 官方说明，应用语言在重启 Office 应用后生效。
7.3 验证中文界面
重新启动后，EPM 标签中的“登录、报表操作、查看格式、刷新、展开、折叠、选项、更多、关于、帮助”等命令应显示为中文。
切换 Data Language 不会翻译 Excel 工作簿中的普通文字、用户自行输入的内容或没有提供多语言描述的后台数据。
八、建立SAP连接并完成首次验证
插件安装完成只代表客户端组件正常。真正使用 EPM 报表，还需要创建或选择 SAP 连接。
通常从 EPM 标签点击：
登录 连接管理器 创建或选择连接连接信息可能包括：
| 连接信息 | 来源 |
|---|---|
| SAP服务器或URL | SAP Basis、BPC管理员或财务系统管理员 |
| 系统编号、客户端或环境 | 组织SAP连接文档 |
| 模型或应用集 | SAP BPC配置和用户权限 |
| 用户名与认证方式 | 组织账号、SSO、SAML或其他企业认证 |
不要根据互联网上其他公司的示例填写服务器地址。连接失败时，应区分客户端安装问题和 SAP 后台问题。
| 测试项 | 通过标准 |
|---|---|
| EPM标签 | Excel启动后稳定显示 |
| 用户选项 | 可以正常打开，中文界面生效 |
| 登录 | 能够连接到组织提供的SAP环境 |
| 报表 | 能够打开、刷新和展开现有EPM报表 |
| 数据提交 | 仅在测试环境或得到授权后验证保存和提交功能 |
预算和财务系统中的数据提交可能影响正式业务数据。首次验证应优先使用测试环境、只读报表或管理员提供的测试模型。
九、EPM标签不显示的排查方法
9.1 检查COM加载项
打开 Excel：
文件 选项 加载项 管理：COM加载项 转到检查是否存在并勾选：
SAP BusinessObjects EPM Solutions, add-in for Microsoft Office微软说明，取消勾选只会停止加载，并不会卸载插件。
9.2 检查禁用项目
文件 选项 加载项 管理：禁用项目 转到如果 Excel 因启动异常自动禁用了 EPM Add-In，选择该项目并点击“启用”。SAP 官方也提供了重新激活 EPM Add-In 的相同处理路径。
9.3 检查Office与安装包位数
64 位 Windows 上可以安装 32 位 Office。EPM 位数必须匹配 Office，而不是匹配 Windows。
9.4 检查VSTO Runtime
重新运行vstor_redist.exe，选择修复或重新安装。检查安装文件的微软数字签名，不使用来源不明的运行库。
9.5 检查Excel是否处于安全模式
以安全模式启动 Excel 时，COM 加载项可能不会加载：
excel /safe如果普通启动不显示、但加载项列表中存在 EPM，应检查 Excel 崩溃记录、加载行为和其他插件冲突。
9.6 检查企业安全策略
应用控制、EDR、宏安全策略、Office加载项策略和不受信任发布者规则，都可能阻止 VSTO/COM 加载项运行。受管电脑应查看安全软件日志并联系终端管理人员。
十、常见问题与处理建议
| 问题现象 | 处理方向 |
|---|---|
| 安装器提示VSTO不存在 | 安装微软官方vstor_redist.exe，不要安装完整Visual Studio IDE |
| 安装器提示VSTO版本过旧 | 卸载旧版VSTO Runtime后安装当前支持版本 |
| 组件无法选择 | 检查Office位数、前置组件和SAP安装包版本 |
| 安装完成但没有EPM标签 | 检查COM加载项、禁用项目、VSTO和企业安全策略 |
| 界面语言没有改变 | 关闭全部Office进程后重启；检查版本是否包含对应语言资源 |
| 应用语言中文、数据仍为英文 | 检查Data Language和SAP后端是否提供中文成员描述 |
| 按钮大量灰色 | 先登录SAP连接或打开有效EPM工作簿 |
| 连接服务器失败 | 检查URL、代理、证书、SSO、账号权限和后端服务状态 |
| Excel启动明显变慢 | 评估按需加载选项，并检查其他Office加载项数量 |
SAP 安装指南提供“仅在点击 EPM 标签时按需加载”的选项，可以减少 Office 启动时的插件加载时间。是否启用应由组织根据工作流统一决定。
十一、标准安装与验收流程
工单记录可以使用以下模板：
问题现象： 用户需要在 Excel 中安装 SAP EPM Add-In，首次运行 SAP Front-End Installer 时提示缺少 Microsoft Visual Studio 2010 Tools for Office Runtime。 环境确认： Windows：________________ Office版本：________________ Office位数：32位 / 64位 SAP安装包版本：________________ 目标组件：Analysis plug-in / EPM add-in 处理动作： 1. 确认Office位数与SAP安装组件一致。 2. 从微软官方或企业软件中心安装Visual Studio Tools for Office Runtime。 3. 关闭全部Office进程，以管理员身份运行SAP Front-End Installer。 4. 勾选EPM add-in并完成安装。 5. 重启电脑，从开始菜单启动EPM add-in for Excel。 6. 确认Excel功能区显示EPM标签。 7. 在EPM → Tools → Options → User Options中，将Application Language和Data Language设置为Chinese (Simplified) Legacy。 8. 重启Excel并验证中文界面。 9. 使用管理员提供的测试连接验证登录和报表刷新。 处理结果： EPM标签和Data Manager已正常显示，插件界面已切换为简体中文，测试连接及报表刷新正常。 当前状态： 问题已处理完成。安装包、Office位数、VSTO Runtime和SAP后端配置均已记录。安装成功的判断标准不只是“安装器显示完成”，还要确认 EPM 标签能够加载、中文设置生效、SAP 连接可用，并能刷新经过授权的测试报表。
十二、处理总结
SAP EPM Add-In 的安装重点集中在三个位置：Office 位数、VSTO Runtime 和 SAP 版本兼容性。截图中的错误来自缺少Microsoft Visual Studio 2010 Tools for Office Runtime，不需要安装完整 Visual Studio 2010。
完成运行库安装后，通过 SAP Front-End Installer 选择 EPM 组件，保持默认或组织规定的安装路径，重启后确认 Excel 显示 EPM 标签。界面语言可在User Options → Display中设置为Chinese (Simplified) Legacy，其中 Application Language 控制插件界面，Data Language 控制后端可翻译数据文本。
企业环境应使用 SAP Support Portal 或软件中心提供的安装包，不使用来历不明的 EPM 安装程序、运行库合集和连接配置。
官方参考：
- SAP Help：EPM Add-in for Microsoft Office Installation Guide
- SAP Help：EPM Add-in User Guide
- SAP KBA 3120664：下载EPM Add-in安装文件
- SAP KBA 3558242：EPM Add-in对Office 2024的支持
- Microsoft Learn：安装Visual Studio Tools for Office Runtime
- Microsoft Learn：VSTO Runtime生命周期
- Microsoft：Excel中添加或移除加载项
点击回到顶部
