专项接入

集成常见问题

为什么返回 601 或 602?

601 表示挂载点不存在,确保元素已经进入 DOM,并把查询到的实际元素传给 mount;当前缺失的字符串选择器可能更早抛出 TypeError。602 表示 Vue 类未定义,传入当前工程的 Vue 构造器或先加载 window.Vue。完整错误码见 状态码与错误排查。

为什么报表挂载成功但没有内容?

依次检查容器尺寸、CSS、reportCode / reportVersion、数据接口和 contextPath。不要用反复调用 mount 掩盖首个请求错误。

iframe 为什么一直不返回实例?

mount 要等子页发送 reportMounted。确认 reportOptions.url 指向同源兼容入口,页面没有被登录重定向,并且 postMessage 链路可用;当前源码还会直接访问子页 document 和全局参数,不能把跨域问题只归因于 CSP。

如何判断打印客户端可用?

在最终用户电脑访问 http://127.0.0.1:45111/bios-printer/ 做本机探活,并确认客户端连接目标打印机。客户端安装包及版本由部署管理员提供。

printAll 为什么忽略部分打印配置?

批量打印当前不支持续打,也会移除 viewPdf 等配置后串行生成。不要在批量流程依赖 businessId、偏移、续打面板或指定 PDF 预览;详见 print 与 printAll。

应该把参数放在哪里?

报表数据与渲染参数放 reportOptions,打印服务参数放同级 printOptions;iframe 开关、iframeStyle 和 extraStyle 也在 mount options 顶层。请链接 API 权威表,不要在业务文档复制并维护另一份参数表。