关于api:用好-DIV-和-API在前端系统中轻松嵌入数据分析模块

在数字化转型潮流席卷各大行业的明天，越来越多的企业开始器重 BI（商业智能）技术的部署和利用，冀望从一直增长的数据资源中取得更多业务价值，从而晋升利润、管制危险、降低成本。BI 能整合、组织和剖析数据，将数据转化为有价值的信息，为企业治理和决策提供反对，成为企业迎接改革和商业翻新的决胜因素。

因为 BI 技术的重要性，企业更心愿在现有的业务平台和零碎中按需集成 BI 能力，从而在各类场景中充分发挥数据分析带来的劣势，满足企业日益多样化的数据分析诉求，使 BI 能力与企业业务深度交融。然而，市面上常见的 BI 工具大都是独立、打包的整体计划，很难与前端的业务系统集成在一起，在实践中经常无奈满足需要。在这样的背景下，嵌入式 BI 应运而生。

所谓嵌入式 BI，就是在企业现有业务零碎中按需集成各种类型的数据分析能力。这种集成工作个别须要思考两个要点：一方面，它实质上是现有业务零碎的一次降级过程，须要关注降级内容与原零碎的兼容性、稳定性、安全性等指标；另一方面，业务侧个别心愿深度集成业余的数据分析组件，而不是任意挂载一个简略的模块应酬了事。这两个要点为开发团队提出了更高的要求和挑战，须要团队认真对待。

对于很多中小企业而言，软件开发团队并不具备独立开发 In-House 嵌入 BI 计划的能力，须要寻求内部第三方供应商的反对。行业中也呈现了很多业余的内部供应商，他们摸索出了一些通过市场验证的嵌入式 BI 最佳实际。咱们以业内老牌知名企业葡萄城开发的 Wyn 商业智能嵌入式架构为例，探讨数据分析模块应该如何嵌入现有业务零碎：

如上所示，对于业务人员来说，利用性能层的数据分析仪表板、图表、设计器、门户等模块，就是嵌入式 BI 计划展示进去的最终成果。其中，模块的内容和状态个别是依据业务需要决定的，例如为某个销售看板集成一些销售数据动静图表，实时反映各地区的以后销售情况。因为业务需要往往比拟多样化，嵌入模块的内容和状态也十分多变，这就要求前端技术层具备更强的适应能力。

前端技术层在过来广泛采纳 URL iFrame 架构来实现模块嵌入，现在更简单的需要更多用 DIV 形式打造解决方案。此外，以 Wyn 商业智能为例，其 BI 模块还能够同泛微、用友 U8+、企业微信和钉钉等罕用的企业信息系统集成，加强它们的数据分析能力。

API 层对于嵌入式 BI 计划是十分重要的。例如，API 容许依据用户类型关上和敞开工具栏，只容许依据应用规定显示指定的数据源，并反对创立具备不同过滤器和选项的仪表板。业余的嵌入式 BI 能够通过调用 API，在应用软件内对仪表板 / 报表进行权限治理、分类管理、重命名、删除等深度集成操作，而应用软件和 BI 软件之间的接口对最终用户是齐全通明的。当然，对于较为简单的业务需要而言，嵌入式 BI 架构中勾销 API 层，或者只有简略的 API 层也是能够承受的。

如上所述，对于开发团队而言，嵌入式 BI 计划的技术选型关键在于 DIV 和 IFrame 架构的抉择，以及是否退出弱小的 API 层。

IFrame 架构在晚期的嵌入式 BI 市场十分风行，因其原理简略、实现不便、开发周期较短，使企业可能疾速实现初期的嵌入式 BI 需要。但这种形式尽管简略，局限性也是很大的。例如，应用 IFrame 就很难在零碎中深度集成数据分析模块。IFrame 更像已经的 Flash 元素，是一种绝对独立的模块。它与页面的其余元素很难交融和互动，即使能够实现也须要付出大量致力和代价。

相比之下，基于 JavaScript 的 DIV 层级的无缝嵌入计划，能够利用原生的 JavaScript 将整个仪表板等以 DIV 的形式集成到我的项目中。嵌入的图表元素具备高度凋谢的接口，可能与其余元素进行数据交互。甚至 BI 软件整体都能够通过 DIV 架构间接嵌入到现有零碎中，确保了无缝和直观的用户体验。即使以后的业务需要仅仅停留在简略的图表展现层面，思考到将来的降级和扩大后劲，开发团队还是最好抉择 DIV 架构来设计 BI 嵌入计划。

另一方面，API 层可能大大简化业务人员对嵌入式 BI 模块的操作，往往是开发团队须要重点实现的性能指标。Wyn 商业智能的嵌入式 BI 计划就提供了 GraphQL API，简直所有界面操作均可通过 API 调用简略实现。下图就是一个简略的 API 调用示例：

GraphQL API 不须要为不同的对象操作提供不同的 URL。不同对象的不同操作均通过一个对立的 URL（http://localhost:51980/api/gr…）调用，只是各类操作提交的数据不同。能够看到，GraphQL API 的操作十分易于上手，能够大大不便开发团队和业务团队，满足各类简单的业务需要。上面来看 Wyn 商业智能提供的一个数据查问 API 的操作示例，从中能够领会 API 的低门槛与便利性：

当咱们须要调用某个数据集，能够通过该 API 以 POST 或 GET 两种形式实现操作。（示例 URL 为 http://10.32.5.7:51980/api/v1… *from Categories&token=27487CA0BE14CF599444E8553E5E07F78D5D1AB8646302A2715E4802FCB95F08&format=json；调用数据集的 URL 格局为 POST/GET api/v1/dataset/{document id}/query。）

POST 形式，无效负载格局：

{
  "QueryType": "NONE|WAX",
  "Query": "some text like a WAX statement or empty"
  "DatasetParameters":{"Parameter1": "ParameterValue1"( 单值),
    "Parameter2": "ParameterValue1,ParameterValue2" (多值应用逗号分隔)
  },
  "Format":Arrow | Json,
  "Options":{"Parameter1":"Value1"}
}

GET 形式，查问参数

?format=Arrow | Json
&$parameter1=value1
&$parameter2=value2_1
&$parameter2=value2_2
&option1=value1
&option2=value2

option1, option2 … 为选项参数，前缀 $ 示意数据集参数，多个值通过多次重复一个参数来示意。Option 选项参数具体信息如下：

只需几行简略的代码即可实现数据集的调用操作，这对嵌入式 BI 场景而言无疑是十分有价值的。API 层与 DIV 嵌入联合，能够为嵌入式 BI 场景需要提供令人满意的解决方案。

总体而言，尽管 iFrame 架构在入门门槛、开发成本和周期方面具备肯定劣势，但随着企业数据分析需要更加简单，DIV 架构很快就能体现出更强的扩大能力和适应性。团队能够在初期抉择 iFrame 实现，并在需要晋升后迁徙到 DIV 计划。与此同时，开发团队往往在一开始就要思考 API 层的实现，为业务团队带来更多便当，并为前期的开发工作打好根底。

企业开发团队在抉择嵌入式 BI 计划时，除了关注计划的开发周期、开发难度外，个别还要思考定价模型、云端反对、业务系统集成反对等因素：

老本。不仅要思考初期的开发成本，还要思考长期的总体领有老本，将将来的性能扩大、安全性加强等需要纳入成本计算。
定价模型。第三方提供的嵌入式 BI 计划经常有多种定价模型可选，例如按用户 / 服务器 /CPU 定价，或者依照实在使用量、应用工夫定价等。一般来说，绝对固定的定价模型更有利于企业用户一方。
云端反对和业务系统集成反对。嵌入式 BI 是否反对私有云、公有云、本地部署、混合部署等多种模式，在云计算时代也是很重要的思考因素。此外，与其余风行第三方企业零碎（ERP、CRM、OA 等）集成的能力能够大大扩大嵌入式 BI 计划的利用范畴。
受权治理 / 安全性。嵌入式 BI 模块常常会与企业秘密数据互动，这就要求嵌入式 BI 计划具备良好的受权治理能力和安全性，防止模块自身成为企业安全性防线的薄弱环节，造成敏感数据的意外泄露事件。

思考到以上因素，实际中中小企业和开发团队更适宜抉择成熟的第三方嵌入式 BI 计划来满足本身需要。以 Wyn 商业智能提供的嵌入 BI 计划为例，其不仅提供了欠缺的性能、基于 GraphQL 的便捷 API 集成，还反对弱小的受权治理、加强平安个性，兼容多种云端部署模式，且可能不便地集成到用友、企业微信等零碎中。该计划既能够嵌入部署也能够独立应用，具备良好的伸缩能力，帮忙企业继续深度开掘数据价值。想要进一步理解对于嵌入式 BI 计划的相干内容，能够点击以下链接获取更多信息。

参考链接：
Wyn 嵌入式商业智能：https://www.grapecity.com.cn/…
数据可视化大屏示例汇合：https://www.grapecity.com.cn/…
嵌入式 BI：https://www.grapecity.com.cn/…
如何与 SaaS 利用集成计划：https://www.grapecity.com.cn/…

关于api:用好-DIV-和-API在前端系统中轻松嵌入数据分析模块

嵌入式数据分析模块架构摸索

支流实现计划比照

嵌入式 BI 选型：如何筛选最适宜本人的计划？