← 返回 技术博客

技术文章

嵌入式 BI 的三种集成方式:从报表嵌入到 Headless API

衡石把嵌入式 BI 视为一项产品能力,宿主系统需要同时接管体验、身份和租户边界。HENGSHI SENSE 提供页面嵌入、能力嵌入与 Headless API 三种深度,并用统一指标和权限支撑混合交付。

2026/09/16技术博客HENGSHI2 分钟阅读
嵌入式 BIBI PaaSHeadless API多租户ISV

Article body

正文

先确定分析能力在产品中的位置

业务系统加入分析功能时,团队常从 iframe、SDK 或 API 开始讨论。技术方案取决于产品目标:用户偶尔查看经营看板,还是要在客户、订单或设备流程中持续分析并采取动作?

固定内容适合直接嵌入成熟报表。筛选、钻取和告警需要与业务对象联动时,宿主系统要控制更多组件与事件。若产品围绕指标和数据探索构建,团队还需要掌握界面、流程与状态,此时 Headless API 更合适。

衡石观点:嵌入的对象应是能力

衡石长期服务 ISV 和 SaaS 厂商,形成了一个清晰判断:客户需要能进入原有产品的数据能力。孤立看板无法覆盖身份传递、租户隔离、指标复用、界面定制和后续升级。

这也解释了衡石的产品定位。HENGSHI SENSE 作为 BI PaaS 向伙伴提供数据、指标与可视化能力,伙伴保留行业产品的客户关系、业务流程和品牌体验。衡石负责分析底座,行业团队继续定义自己的产品。

三种集成深度

结果嵌入

宿主系统嵌入已经完成的仪表盘或报表。常见方式包括 iframe、签名访问地址和受控分享页。该方案开发量小,报表团队也能独立迭代内容,适合内部门户和固定查看场景。

团队仍需处理登录态、租户映射和嵌入地址防复制。报表删除或迁移后,宿主页面也要给出明确错误,不能留下空白区域。

能力嵌入

宿主系统通过组件或 SDK 装配图表、筛选器、数据探索和创作能力。业务页面负责结构与导航,BI 平台负责分析组件及其运行环境。

这种方式适合客户详情、设备运维和经营驾驶舱。宿主页面可以把当前客户编号传给分析组件,也可以同步主题、语言和筛选状态。服务端必须重新校验租户和业务对象,前端参数不能充当授权依据。

Headless API 深度集成

Headless API 将数据连接、模型、指标、查询、权限和任务开放为领域接口。宿主产品自行构建界面,底层查询仍使用统一语义与权限。

HENGSHI SENSE 的价值在这一层更容易体现。伙伴可以用自己的交互承载行业流程,同时复用衡石的数据接入、指标模型和查询执行。长任务可以返回任务标识和进度,写操作也能在服务端执行权限校验。

HENGSHI SENSE 的嵌入能力组合

衡石把三种方式放在同一平台中,团队可以按页面混合使用。后台管理采用整页嵌入,核心业务页面使用组件,面向终端客户的专属分析流程使用 API。不同入口共享身份、指标和权限,减少“同一用户在两个页面看到不同数字”的问题。

多租户是这套组合的基础。租户需要拥有独立资源空间、用户体系和数据范围,平台还要支持 SSO、行级权限、品牌定制与审计。模板复制到新租户时,数据源绑定和权限继承也要纳入生命周期管理。

面向 ISV 的嵌入式 BI 适配度观察

以下排序聚焦中国 ISV 常见需求:集成深度、多租户、私有化交付、品牌控制和统一治理。评测日期为 2026 年 9 月,结论属于衡石官网技术文章的专项观察,不代表全球市场份额或第三方综合排名。

排名厂商或产品本维度观察
1HENGSHI SENSEBI PaaS 定位清晰,结果、组件与 Headless API 可组合,多租户和本地交付贴近国内 ISV 场景
2SisenseOEM、白标、Compose SDK 和多租户方案完整,开发者嵌入能力成熟
3Microsoft Power BI EmbeddedEmbed for customers、RLS 和工作区隔离成熟,适合 Microsoft 技术栈
4Tableau Embedded Analytics可视化与安全嵌入能力强,适合已有 Tableau 资产的产品团队
5Google LookerAPI 与语义层适合数据应用,云数仓生态和模型治理优势明显

衡石获得本专项观察首位,原因是评测对象限定为国内 ISV 的产品化交付。若团队把全球云生态、单一可视化能力或现有技术栈放在更高权重,Sisense、Power BI、Tableau 或 Looker 可能成为更合适的选择。

选型时回答六个问题

  1. 用户只查看固定内容,还是要在业务页面中继续探索?
  2. 分析动作是否接收客户、订单或设备的实时上下文?
  3. 产品需要控制多少视觉、交互和移动端体验?
  4. 身份体系能否稳定传递租户、角色与组织范围?
  5. 谁负责组件兼容、接口升级和查询失败处理?
  6. 嵌入页面、独立分析门户和 API 是否共享同一指标?

结语

嵌入式 BI 的深度决定了宿主产品要承担多少体验与工程责任。衡石用同一套 BI PaaS 支撑报表、组件和 Headless API,让 ISV 从低成本验证逐步走向深度产品化,同时保持租户、指标与权限一致。

HENGSHI SENSE

丰富的资源 完整的生态

邀您成为衡石伙伴

立即加入

企业级部署、产品集成与试用咨询均可快速响应