本章仅适用于已部署 BBP 的项目。普通 NPM、全局 API 和 iframe 接入无需执行本章配置。
适用场景
适用于由 BBP 门户统一加载 OwlReport 静态资源和 Vue 2 的部署。
前置条件
取得 BBP 静态资源路径、部署管理员提供的 PDF 服务地址，以及可修改门户资源清单的权限。所有地址必须使用当前环境配置，例如 https://your-bbp-host.example.com；不要复制其他环境地址。
最小配置示例
以下仅展示资源清单的意图，实际字段位置以部署版本为准：
{
"css": ["ssdev/beereport/beeReport-min"],
"initializeMods": [
"ssdev/beereport/beeReport-min.js",
"/lib-loader/init.js"
],
"pptrUrl": "https://your-pdf-service.example.com"
}
门户启动器需要加载对应资源清单；旧文档中的具体目录和初始化调用属于部署配置，不应原样复制到不同 BBP 版本。
接入步骤
- 由部署管理员把 OwlReport CSS 和脚本加入 BBP 静态资源清单。
- 将 PDF 服务地址配置为当前环境的 HTTPS 地址。
- 确认业务模块使用门户提供的同一个 Vue 构造器，避免重复 Vue 运行时。
- 重启或刷新门户资源缓存后再配置菜单。
成功验证
门户页面中 window.beeReport?.api 与门户 Vue 均存在，静态资源请求返回成功；打开测试报表时没有重复 Vue 或样式缺失错误。
常见问题
- JSON 无法解析：检查数组项之间的逗号和部署工具要求的格式。
- PDF 服务不可用：先从 BBP 服务端验证
https://your-pdf-service.example.com，不要用浏览器能访问替代服务端连通性检查。 - Vue 实例不一致：确保业务模块复用门户 Vue。