SmartBI 报表配置指南¶

📄 创建: 吴乐 2026-08-04 · 修改: JimWb 2026-08-04

https://doc.xpku.com/raw/products/bxjc/smartBIreportSet.md

本文说明如何在 MES 系统中通过菜单集成 SmartBI 报表，包含「获取报表链接 → URL 编码 → 拼接访问参数 → MES 菜单配置」四个环节，文末附注意事项。

目录¶

• 一、获取 SmartBI 报表链接
• 二、对报表链接进行 URL 编码
• 三、拼接报表访问参数
• 四、在 MES 系统中配置菜单
• 五、注意事项

一、获取 SmartBI 报表链接¶

登录 SmartBI 后，打开目标报表，复制其分享链接。

• 示例链接：https://smartbi.bnbm.com.cn/vision/share.jsp?resid=I0be185a555522000

二、对报表链接进行 URL 编码¶

报表链接中包含 ?、=、& 等特殊字符，直接拼接到外层系统会被误解析。因此需要先对整条链接做 URL 编码（即 encodeURIComponent 编码方式）。

• 推荐在线编码工具：https://www.mayicms.com/urlencode/
• 编码前：https://smartbi.bnbm.com.cn/vision/share.jsp?resid=I0be185a555522000
• 编码后：https%3A%2F%2Fsmartbi.bnbm.com.cn%2Fvision%2Fopenresource.jsp%3Fresid%3DI0be185a555522000

三、拼接报表访问参数¶

在编码后的地址基础上，拼接以下固定参数，组成完整的报表访问地址：

ssoClient、secretKey、ssoUser 为系统固定值，无需修改。

完整拼接示例：

?reportUrl=https%3A%2F%2Fsmartbi.bnbm.com.cn%2Fvision%2Fopenresource.jsp%3Fresid%3DI0be185a555522000&ssoClient=sso_iframe&secretKey=H7kP2mX9&ssoUser=18601288099

四、在 MES 系统中配置菜单¶

1. 登录 MES 系统：https://mes.bnbm.com.cn
2. 进入 【平台运营管理】→【菜单管理】，点击「新增菜单」。
3. 菜单地址（路径）固定填写：smartBIReport
4. 参数格式填写如下（开头的 ? 不可省略）：

?reportUrl=报表地址&ssoClient=xxxxx&secretKey=xxxxx&ssoUser=xxxxx

配置示意：

五、注意事项¶

• 拼接参数时必须以英文半角 ? 开头，否则菜单无法正确接收报表地址。
• ssoClient、secretKey、ssoUser 为系统固定值，请勿随意更改。
• 报表链接务必先完成 URL 编码再拼接，否则其中的特殊字符会导致跳转异常。