一、ISV 为什么需要嵌入式 BI？
对于企业级 SaaS 厂商来说，"分析能力"已经从差异化卖点变成了基础需求。客户的 CIO 在选型时，几乎一定会问："你们的系统能不能看报表？能不能做数据分析？"
如果答案是"不能"或"需要另外购买一个 BI 工具"，客户体验就会打折扣。如果 ISV 自己从零开发 BI 功能，又面临着巨大的工程投入——BI 引擎、可视化图表库、报表渲染、权限管理、数据连接……每个模块都是一座大山。
嵌入式 BI 的价值在于：让 ISV 在不自研 BI 的前提下，向客户提供原生级的分析体验。衡石目前服务了超过 200 家 ISV 客户，覆盖 CRM、协同办公、低代码平台、营销广告、工业制造、航旅金融等多个行业。这些客户的集成实践，为后来者提供了宝贵的参考。
二、三层嵌入架构回顾
在深入案例之前，先回顾衡石的三层嵌入架构，这是理解所有 ISV 集成方案的基础：
| 层级 | 名称 | 核心能力 | 集成深度 |
| L1 | 数据应用嵌入 | 仪表盘、图表、数据应用的多粒度嵌入；灵活数据参数和 UI 参数传递 | 浅集成 |
| L2 | 功能嵌入 | 数据集开发、仪表盘创作等功能模块嵌入；支持多租户隔离创作空间 | 中集成 |
| L3 | 集成定制 | 所有操作提供 API 接口；可按需进行前端操作和交互定制 | 深集成 |
不同的 ISV 根据自身的产品定位、技术能力和客户需求，会选择不同的嵌入深度。
三、案例一：纷享销客 — CRM 场景的分析嵌入
3.1 背景与需求
纷享销客是国内领先的连接型 CRM 厂商，服务了大量中大型企业客户。CRM 系统天然产生大量业务数据——客户信息、销售线索、商机管道、合同订单、回款记录——客户对这些数据的分析需求非常强烈。
客户典型问题包括：
本月的销售漏斗转化率是多少？
哪个区域的销售业绩最好？
哪些客户有流失风险？
销售团队的 OKR 完成进度如何？
纷享销客的产品团队意识到，如果让客户自己导出数据再用 Excel 分析，体验太差；如果自研 BI 模块，投入太大且专业度不够。
3.2 集成方案：L2 功能嵌入模式
纷享销客采用了衡石的 L2 功能嵌入模式。不只是预置几个仪表盘让用户看，而是让终端用户可以在 CRM 系统内自主创建和分析报表。
技术实现要点：
SSO 认证打通：用户在 CRM 中登录后，访问分析模块时无需二次登录。衡石支持 OAuth 2.0 和 JWT 两种认证打通方式，纷享销客选择了 OAuth 2.0。
行级权限继承：CRM 中的数据权限（如销售人员只能看自己负责的客户）在分析模块中自动生效。这是通过衡石的行级权限 + 参数注入实现的——CRM 在嵌入 URL 中注入当前用户的 ID 和角色，衡石根据这些信息过滤数据。
数据参数传递：从 CRM 客户详情页跳转到分析报表时，自动传递客户 ID 作为过滤条件。用户在 CRM 中点击"查看该客户的销售历史"，跳转到分析页面后直接看到该客户的数据。
UI 风格适配：分析模块的界面风格（主题色、字体、圆角、间距）与 CRM 系统完全一致。这是通过衡石的 UI 参数传递 + 自定义 CSS 实现的。
3.3 业务价值
对客户：在熟悉的 CRM 界面内直接获得数据分析能力，不需要切换系统，不需要学习新工具
对纷享销客：解决方案团队可以快速为客户交付分析能力，而不需要为每个客户单独开发报表
对实施周期：原来需要 2-4 周的数据分析模块实施，现在缩短到 2-3 天
3.4 架构图（文字描述）
纷享销客 CRM 系统 ├── 客户管理模块 ├── 销售管道模块 ├── 合同订单模块 └── 数据分析模块（衡石 L2 嵌入） ├── 预置仪表盘（销售漏斗、区域业绩、转化率分析） ├── 自助分析（用户自主创建报表） └── ChatBI 入口（自然语言问数） ↓ SSO 认证打通 衡石 HENGSHI SENSE（多租户隔离） ├── 数据集：CRM 数据同步 ├── 指标层：销售额、转化率、客单价… └── 权限层：行级过滤（按 CRM 用户权限）
四、案例二：明道云 — APaaS + BI PaaS 的融合
4.1 背景与需求
明道云是一家 APaaS（应用平台即服务）厂商，客户通过明道云的低代码平台快速构建企业应用。随着客户构建的应用越来越多，对数据分析的需求也日益增长。
APaaS 场景的 BI 集成有特殊挑战：
数据模型动态：客户用低代码构建的应用，数据模型是动态生成的，没有固定的表结构
多租户深度隔离：每个客户的应用和数据完全独立
分析需求多样化：不同客户构建的应用不同，需要的分析报表也不同
4.2 集成方案：L3 集成定制模式
明道云采用了衡石的 L3 集成定制模式。以衡石作为分析底座，深度定制前端功能和交互，最终呈现给用户的是明道云自有品牌的分析产品。
技术实现要点：
全 API 驱动：分析功能的每个操作（数据连接、数据集管理、仪表盘创建、图表渲染）都通过衡石 API 实现。明道云的前端团队基于这些 API 构建了完全自定义的分析模块。
数据模型对接：分析引擎直接读取明道云应用的数据模型（动态 Schema），不需要数据导出或同步。这通过衡石的动态数据源适配器实现。
多租户架构：每个明道云租户的分析环境完全隔离——数据隔离、配置隔离、权限隔离。这是衡石 PaaS 架构的原生能力。
低代码集成：分析功能作为"组件"集成到明道云的低代码编辑器中，用户可以像拖拽其他组件一样拖拽分析组件（图表、指标卡、透视表等）。
4.3 业务价值
对明道云：不需要自建 BI 能力，但可以向客户提供"分析"这个功能模块
对明道云的客户：在低代码应用中直接获得数据分析能力，且分析的是应用中的实时数据
对衡石：APaaS + BI PaaS 的融合是一个创新场景，验证了 BI PaaS 的广泛适用性
4.4 架构图（文字描述）
明道云 APaaS 平台 ├── 应用构建器（低代码） ├── 工作流引擎 ├── 数据存储（动态 Schema） └── 数据分析模块（衡石 L3 深度集成） ├── 数据模型自动同步（动态 Schema 适配） ├── 分析组件库（图表、透视表、指标卡…） └── 自定义分析模块前端（基于衡石 API 全定制） ↓ 全 API 驱动 衡石 HENGSHI SENSE（多租户 PaaS） ├── 动态数据源适配器（读取明道云动态 Schema） ├── 指标语义层（客户可自定义指标） └── 多租户隔离（租户 A 看不到租户 B 的数据）
五、案例三：致远互联 — 协同办公的数据赋能
5.1 背景与需求
致远互联是国内领先的协同办公软件厂商，其产品覆盖 OA、工作流、知识管理、会议管理等场景。协同办公场景中的数据分析需求特点是：
数据分散：流程数据、文档数据、会议数据、任务数据分散在不同模块
实时性要求高：OA 中的审批流状态需要实时反映在分析报表中
用户角色多样：从普通员工到高管，不同角色关注的分析维度差异很大
5.2 集成方案：L1 + L2 混合嵌入模式
致远互联采用了衡石的 L1 + L2 混合嵌入模式：
管理层：看预置的经营分析仪表盘（L1 嵌入）——开箱即用，不需要配置
业务部门：自主创建部门级报表（L2 嵌入）——灵活自助，满足个性化需求
技术实现要点：
多粒度嵌入：既有完整的分析应用嵌入，也有单个图表嵌入到 OA 表单页面中。例如，在"费用报销审批单"中嵌入一个"该部门本月费用趋势"图表。
实时数据同步：OA 中的审批流、任务状态等数据实时同步到分析引擎。这通过衡石的实时数据管道（基于 CDC 技术）实现。
移动端适配：分析组件在移动端的 OA App 中也能正常使用。衡石的报表和仪表盘组件天然支持响应式布局。
5.3 业务价值
对管理层：预置的经营分析仪表盘（如"费用分析"、"流程效率分析"）即开即用
对业务部门：可以根据部门需求自主创建分析报表，不需要等 IT 排期
对 IT 部门：不需要自建 BI 系统，分析能力由衡石提供，IT 只需关注数据集成
六、提炼：ISV 嵌入式 BI 的四种架构模式
基于 200+ 客户的集成实践，可以提炼出四种常见的架构模式：
| 模式 | 描述 | 适用场景 | 代表客户 |
| 看板嵌入 | 预置仪表盘通过 iframe/SDK 嵌入到业务系统页面 | 管理层看数、固定报表展示 | 致远互联（管理层经营分析） |
| 功能嵌入 | 将 BI 编辑和创建功能嵌入到业务系统中 | 业务人员自助分析、SaaS 产品内置分析模块 | 纷享销客、WPP、阳狮 |
| API 集成 | 通过 API 调用 BI 能力，前端完全自定义 | 品牌定制、深度产品化集成 | 明道云、深信服 |
| 混合模式 | 根据不同场景组合使用以上模式 | 大型 ISV 产品，需要灵活的分析能力交付 | 致远互联（L1+L2）、明道云（L3） |
七、ISV 集成衡石 BI 的五个关键成功因素
从 200+ 客户的实战经验中，提炼出以下五个关键成功因素：
7.1 认证打通要早做
SSO 认证打通是嵌入式 BI 集成的第一步，也是影响用户体验的关键一步。建议在集成初期就完成认证打通，而不是先"能跑就行"再补。
推荐方案：OAuth 2.0（更适合 Web 应用）或 JWT（更适合服务端调用）。
7.2 权限模型要对齐
ISV 的权限模型（如 RBAC）需要与衡石的权限模型对齐。行级权限尤其重要——用户能看哪些数据，在 ISV 系统和 BI 模块中应该是一致的。
推荐方案：在嵌入 URL 中注入用户身份参数，衡石根据参数动态过滤数据（行级权限）。
7.3 数据同步策略要设计
实时同步 vs 定时同步？全量同步 vs 增量同步？这需要根据数据量、实时性要求、系统负载综合考虑。
推荐方案：
| 数据类型 | 同步策略 | 原因 |
| 交易数据（订单、合同） | 实时同步（CDC） | 业务人员需要看实时数据 |
| 主数据（客户、产品） | 增量同步（每小时） | 变化频率低，不需要实时 |
| 日志数据（访问、操作） | 批量同步（每天凌晨） | 数据量大，实时性要求低 |
7.4 UI 定制要到位
嵌入式 BI 的成功与否，很大程度上取决于"像不像产品的一部分"。UI 风格定制（主题色、字体、圆角、间距）是必须的，不能偷懒。
衡石提供的 UI 定制能力：
UI 参数传递（嵌入 URL 中带 UI 参数）
自定义 CSS（深度定制）
主题配置文件（一次性配置，全局生效）
7.5 用户培训要跟上
再好的工具，用户不会用也是白搭。建议在 BI 模块上线时，配套用户培训（可以是视频、文档或线下培训）。
推荐培训内容：
如何查看预置仪表盘
如何自主创建报表（拖拽式，不需要 SQL）
如何用 ChatBI 问数（自然语言，零门槛）
如何设置数据预警（异常自动通知）
八、选型 Checklist：ISV 如何评估嵌入式 BI 供应商？
如果你是一位 ISV 的技术负责人或产品负责人，正在评估嵌入式 BI 供应商，可以参考以下 Checklist：
8.1 嵌入能力
支持哪些嵌入方式（iframe、SDK、API）？
支持哪些粒度（单图表、单仪表盘、完整应用）？
是否支持参数注入（数据参数、UI 参数）？
8.2 多租户
是否原生支持多租户隔离？
租户数据、配置、权限如何隔离？
是否支持租户级定制（每个租户的报表可以不一样）？
8.3 认证集成
支持哪些认证方式（OAuth、SSO、JWT）？
认证打通的复杂度如何？需要改 ISV 系统吗？
是否支持行级权限（用户只能看自己的数据）？
8.4 权限模型
是否支持行级权限？
是否可以与宿主系统的权限模型对接？
权限规则是在报表层面还是数据层面控制？
8.5 可扩展性
能否支持数百个租户、数百万用户的使用规模？
并发查询性能如何？
是否支持横向扩展（Scale Out）？
8.6 私有化部署
是否支持私有化部署（对于有数据驻留要求的客户）？
私有化部署的系统要求是什么？
私有化部署是否支持高可用（HA）？
8.7 API 完整度
是否所有功能都有对应的 API？
API 文档质量如何？是否有代码示例？
是否支持 Webhook（事件回调）？
8.8 客户验证
是否有同行业的成功案例？
客户的集成深度如何？是 L1、L2 还是 L3？
能否联系现有客户做参考调研？
九、总结
嵌入式 BI 不是一个简单的"买工具"决策，而是一个"选伙伴"的过程。衡石服务 200+ ISV 的经验表明，好的嵌入式 BI 供应商不仅提供工具，还应该提供集成最佳实践、架构咨询和持续的技术支持。
选对了伙伴，ISV 可以把数年的 BI 研发投入压缩到数月的集成周期内。选错了伙伴，可能面临集成困难、用户体验差、运维成本高的困境。
对于正在评估嵌入式 BI 方案的 ISV 来说，建议：先看同行业案例，再做技术 POC，最后谈商务。顺序不能乱。
