官方文档

分析集成(报表嵌入)

把报表、看板、大屏嵌进 OA / 门户:开通集成、快捷生成嵌入代码,正式环境再用开放 API 发 Ticket。

一句话:把 VeryReport 里已经做好的报表 / 看板 / 大屏等,嵌到你们自己的 OA、门户或业务系统里;对方不用登录 VeryReport,用一张短期通行证(Ticket)就能看。

适合谁看:业务管理员、数据分析师;正式对接时再交给开发同学看文末「进阶」。

1. 功能概述

1.1 能嵌什么

作品类型

适合场景

仪表板

经营看板、自助分析

复杂报表

正式报表、套打预览

数据大屏

展厅 / 会议室投屏页

数据填报

业务系统内嵌表单

数据门户

门户首页或栏目页

自助取数

业务自助查询页

数据集、模版本身不能单独嵌;请先做成上面某类作品再开通集成。

1.2 集成步骤

  1. 开通集成:告诉系统「这个作品允许被外面嵌」(白名单)。

  2. 生成通行证:拿到带 Ticket 的链接或 iframe 代码。

  3. 贴到对方系统:把链接或 iframe 放到 OA / 门户页面里。

1.3 和「分享链接」有什么不同

  • 分析集成:给外部系统嵌入用,对方用户一般不用 VeryReport 账号。

  • 分享链接:更适合 VeryReport 内部同事互相打开看。

两套都能用,按场景选即可,不必纠结。

2. 最佳实践

  • 先联调、再上线:先在「分析集成」里用快捷生成验证能打开;确认无误后再让开发用开放 API 按用户动态发 Ticket。

  • 不要把调试链接当正式地址:快捷生成的 Ticket 有时限、次数限制,过期就打不开。

  • 生产环境由服务端发 Ticket:用户打开贵方页面时,由贵方后端申请一张新 Ticket,再塞进 iframe,更安全。

  • 需要防泄密时加水印:生成时可写姓名、部门等水印文字。

  • 一个作品开一次集成即可:同一看板可嵌到多个系统;关掉集成后,旧链接会立刻失效。

  • 开通人要有作品查看权限:嵌入时按「开通人」的数据权限取数,换人开通前请确认权限够用。

3. 操作步骤(界面操作)

下面按顺序做一遍,大约几分钟就能在浏览器里先嵌通。

3.1 进入分析集成

  1. 登录 VeryReport(需要开放平台相关权限)。

  2. 依次点击菜单:开放平台、分析集成。

  3. 进入 分析集成(或概览里点「管理集成」)。


开放平台入口 / 分析集成菜单位置

若菜单里没有「开放平台」,请让管理员开通相应权限后再试。

3.2 开通要嵌入的作品

  1. 点右上角 新建集成

  2. 按类型、名称找到作品(只显示还没开通过的)。

  3. 勾选后确认。列表里会出现一条记录,开通人是你当前账号。


「新建集成」抽屉:筛选作品并勾选

点击右下角「开通集成」,同一作品在同一租户里只需开通一次;删掉后可以再开。

3.3 生成调试用嵌入代码

  1. 在列表行点 集成配置

  2. 按需选择是否显示标题

  3. 快捷生成,按需要填写:有效时长、访问次数、水印文字、绑定用户 ID(都可先用默认)。

  4. 生成 Ticket,复制 URLIframe 代码


集成配置弹窗:显示标题、快捷生成入口


快捷生成面板:参数与「生成 Ticket」按钮


生成结果:URL / Iframe 代码与复制按钮

URL 大致长这样(域名换成你们环境):

https://{您的VeryReport域名}/#/embed/report/338?ticket=……

iframe 示例:

<iframe src="https://{域名}/#/embed/report/338?ticket=……" width="100%" height="600" frameborder="0"></iframe>

提醒:限次 Ticket 用过或过期后要重新生成。快捷生成只适合演示和联调,不要当成长期对外地址。

3.4 放到第三方页面里验证

  1. 把复制的 URL 直接在浏览器打开,应能看到作品且不用登录

  2. 或把 iframe 贴进贵方测试页,确认宽高合适、图表可交互。

  3. 若配置了水印,页面上应能看到半透明文字。

3.5 关闭嵌入(可选)

在配置里点 关闭嵌入,或在列表里 删除:集成取消,已发出的链接会失效;以后要嵌需再「新建集成」。

4. 进阶:正式上线怎么接(给开发)

界面「快捷生成」只适合人工调试。正式环境建议:用户打开贵方页面时,由贵方服务端调用开放 API 申请 Ticket,再把带 Ticket 的地址交给前端 iframe。

准备三件事:

  1. 开放平台里创建 AccessKey(Secret 只显示一次,请妥善保存)。

  2. 目标作品已在分析集成中开通

  3. API 使用说明 做签名;创建 Ticket 详见 CreateTicket

调用成功后,把返回的 ticket 拼进上一节的嵌入 URL 即可。查询 / 撤销 / 延期 Ticket 等接口见开放 API 目录,本文不展开。

5. 常见问题

打不开,提示 Ticket 无效或已过期?
重新生成一张;并确认集成还在,没有被关闭。

提示无法获取嵌入访问凭证?
作品还没开通分析集成,或用了旧链接。请重新开通并生成新 Ticket。

页面空白或一直转圈?
检查:集成已开、Ticket 未过期、开通人对该作品有查看权限。生产环境务必用新签发的 Ticket。

快捷生成的链接能给所有人长期用吗?
不建议。请改成服务端按会话动态发 Ticket。

一个作品能嵌到多个系统吗?
可以。开一次集成,各系统各自用各自的 Ticket 即可。

6. 相关文档