开始接入

集成指南概览

OwlReport 是基于 Vue 2 的报表渲染组件。本指南只说明如何把已发布的报表接入业务系统;完整参数和方法定义请查阅 API 参考。

接入前准备

  • 从报表管理员处取得报表标识和版本。本文统一使用 sales-summary、1.0.0。
  • 确认页面能访问 OwlReport 所需的报表服务;跨域、认证和 contextPath 由部署环境决定。
  • 使用静默打印时,在最终用户电脑安装与部署版本匹配的打印客户端和打印机驱动。安装包请向部署管理员获取。
  • 准备有明确尺寸的挂载容器。高度为 0 是“已挂载但看不到内容”的常见原因。

推荐阅读路径

普通 Vue 2 工程从 NPM 与 Vue 2 集成 开始;已有全局构建产物的页面使用 全局 API 与 mount 接入;需要运行时隔离时阅读 iframe 集成。BBP 是独立的可选路径,通用接入不依赖 BBP。

上线前至少验证:报表能完成挂载、数据请求成功、容器销毁后不再保留实例、目标浏览器能够加载静态资源。若启用打印或导出,还要分别验证目标打印机、PDF 和 Excel 文件。