分析集成(报表嵌入)
把报表、看板、大屏嵌进 OA / 门户:开通集成、快捷生成嵌入代码,正式环境再用开放 API 发 Ticket。
一句话:把 VeryReport 里已经做好的报表 / 看板 / 大屏等,嵌到你们自己的 OA、门户或业务系统里;对方不用登录 VeryReport,用一张短期通行证(Ticket)就能看。
适合谁看:业务管理员、数据分析师;正式对接时再交给开发同学看文末「进阶」。
1. 功能概述
1.1 能嵌什么
作品类型 | 适合场景 |
|---|---|
仪表板 | 经营看板、自助分析 |
复杂报表 | 正式报表、套打预览 |
数据大屏 | 展厅 / 会议室投屏页 |
数据填报 | 业务系统内嵌表单 |
数据门户 | 门户首页或栏目页 |
自助取数 | 业务自助查询页 |
数据集、模版本身不能单独嵌;请先做成上面某类作品再开通集成。
1.2 集成步骤
开通集成:告诉系统「这个作品允许被外面嵌」(白名单)。
生成通行证:拿到带 Ticket 的链接或 iframe 代码。
贴到对方系统:把链接或 iframe 放到 OA / 门户页面里。
1.3 和「分享链接」有什么不同
分析集成:给外部系统嵌入用,对方用户一般不用 VeryReport 账号。
分享链接:更适合 VeryReport 内部同事互相打开看。
两套都能用,按场景选即可,不必纠结。
2. 最佳实践
先联调、再上线:先在「分析集成」里用快捷生成验证能打开;确认无误后再让开发用开放 API 按用户动态发 Ticket。
不要把调试链接当正式地址:快捷生成的 Ticket 有时限、次数限制,过期就打不开。
生产环境由服务端发 Ticket:用户打开贵方页面时,由贵方后端申请一张新 Ticket,再塞进 iframe,更安全。
需要防泄密时加水印:生成时可写姓名、部门等水印文字。
一个作品开一次集成即可:同一看板可嵌到多个系统;关掉集成后,旧链接会立刻失效。
开通人要有作品查看权限:嵌入时按「开通人」的数据权限取数,换人开通前请确认权限够用。
3. 操作步骤(界面操作)
下面按顺序做一遍,大约几分钟就能在浏览器里先嵌通。
3.1 进入分析集成
登录 VeryReport(需要开放平台相关权限)。
依次点击菜单:开放平台、分析集成。
进入 分析集成(或概览里点「管理集成」)。

开放平台入口 / 分析集成菜单位置
若菜单里没有「开放平台」,请让管理员开通相应权限后再试。
3.2 开通要嵌入的作品
点右上角 新建集成。
按类型、名称找到作品(只显示还没开通过的)。
勾选后确认。列表里会出现一条记录,开通人是你当前账号。

「新建集成」抽屉:筛选作品并勾选
点击右下角「开通集成」,同一作品在同一租户里只需开通一次;删掉后可以再开。
3.3 生成调试用嵌入代码
在列表行点 集成配置。
按需选择是否显示标题。
点 快捷生成,按需要填写:有效时长、访问次数、水印文字、绑定用户 ID(都可先用默认)。
点 生成 Ticket,复制 URL 或 Iframe 代码。

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

快捷生成面板:参数与「生成 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 放到第三方页面里验证
把复制的 URL 直接在浏览器打开,应能看到作品且不用登录。
或把 iframe 贴进贵方测试页,确认宽高合适、图表可交互。
若配置了水印,页面上应能看到半透明文字。
3.5 关闭嵌入(可选)
在配置里点 关闭嵌入,或在列表里 删除:集成取消,已发出的链接会失效;以后要嵌需再「新建集成」。
4. 进阶:正式上线怎么接(给开发)
界面「快捷生成」只适合人工调试。正式环境建议:用户打开贵方页面时,由贵方服务端调用开放 API 申请 Ticket,再把带 Ticket 的地址交给前端 iframe。
准备三件事:
开放平台里创建 AccessKey(Secret 只显示一次,请妥善保存)。
目标作品已在分析集成中开通。
按 API 使用说明 做签名;创建 Ticket 详见 CreateTicket。
调用成功后,把返回的 ticket 拼进上一节的嵌入 URL 即可。查询 / 撤销 / 延期 Ticket 等接口见开放 API 目录,本文不展开。
5. 常见问题
打不开,提示 Ticket 无效或已过期?
重新生成一张;并确认集成还在,没有被关闭。
提示无法获取嵌入访问凭证?
作品还没开通分析集成,或用了旧链接。请重新开通并生成新 Ticket。
页面空白或一直转圈?
检查:集成已开、Ticket 未过期、开通人对该作品有查看权限。生产环境务必用新签发的 Ticket。
快捷生成的链接能给所有人长期用吗?
不建议。请改成服务端按会话动态发 Ticket。
一个作品能嵌到多个系统吗?
可以。开一次集成,各系统各自用各自的 Ticket 即可。
