嵌入式应用指南

1. 概述

1.1 功能概述

在上一节简单了解嵌入式分析概念后，接下来本章将重点介绍 Wyn 商业智能提供什么样的嵌入式能力，用户在实际实施项目或者应用数据分析结果的过程中如何使用 Wyn 来快速实现他的场景。

1.2 嵌入式常见应用场景和价值

在上一节介绍到的软件公司数字化转型和企业客户构建数字文化的过程中，他们都有不同程度、不同环节的数据分析的需要，总结常见的嵌入式分析场景如下：

2. 了解 Wyn 嵌入式方案

基于以上三种常见的嵌入式分析场景， Wyn 平台到前端技术，五大技术支持三大应用场景，全面满足用户不同层次的嵌入式分析需要。

• 平台 API 层： Wyn 提供 Restful API 和 JavaScript API，几乎所有的在界面上的数据分析的操作都可以通过调用 API 完成。

• 前端技术层： 如果要在业务应用系统中集成 Wyn 的仪表板、报表、文档门户以及系统设置后台管理，可以通过 iFrame（URL） 的集成方式，如果用户在集成的同时，想要更多的定制图表、仪表板样式和添加更多的与外部的交互，还可以通过 DIV 原生的纯前端的方式集成，这也是 Wyn 在嵌入式 BI 分析领域的核心优势。

• 应用功能层： 通过以上的技术支撑， Wyn 的对外提供 5 个不同层级的嵌入式分析能力，将所有分析能力完全赋能到业务系统，为最终用户提供全面的嵌入式分析的需要。

3. 嵌入式方案选型指南

在了解了嵌入式分析的典型应用场景和Wyn的核心能力后，接下来我们将指导您如何选择最优的集成方案。选型前，请先明确您的集成方向：是将Wyn嵌入到第三方应用，还是将第三方应用集成到Wyn中。根据您的具体需求，我们提供以下选型建议。

3.1 嵌入 Wyn 到第三方应用程序

1. Wyn 提供iFrame（也称"URL"）和DIV两种前端方式，特点对比如下：

   分类	URL嵌入（iFrame）	DIV嵌入
   技术要求	HTML 基础知识	JavaScript 以及 CSS基础知识
   开发速度	非常快	快
   嵌入内容	仪表板和报表，单个可视化组件	仪表板和报表，单个可视化组件，设计器
   灵活度	有限	非常灵活
   适配场景	静态嵌入	自定义布局，图表样式，多种交互行为

2. 将 Wyn 商业智能嵌入到第三方应用程序根据实际使用场景，详细场景为：

   嵌入场景	场景详情描述	方案建议	实施步骤
   嵌入分析结果	嵌入一整张仪表板到业务系统，比如：OA，CRM	URL 嵌入	集成仪表板或单个组件
   	嵌入仪表板单个图表到业务系统某个页面	URL 嵌入	集成仪表板或单个组件
   	嵌入一整张报表到业务系统。比如：OA，CRM	URL 嵌入	集成报表
   	嵌入分析结果到到移动端，用户可以直接在移动端查看和分析仪表板和报表	URL 嵌入	嵌入企业微信 嵌入钉钉
   	在第三方业务系统查看数据模型，数据集，数据模型的数据处理结果	URL 嵌入	嵌入数据集，数据模型，数据集查看器
   嵌入设计能力	嵌入仪表板原生设计器，用户可在线直接新设计和编辑已经存在的仪表板	DIV 嵌入	DIV嵌入仪表板设计器
   	在嵌入原生设计器的基础上，用户可以自定义仪表板设计器的能力。 比如：左侧工具箱，顶部菜单栏样式等	DIV 嵌入	集成时自定义仪表板设计器
   	嵌入报表原生设计器，用户可在线直接新设计和编辑已经存在的报表	DIV 嵌入	DIV嵌入报表设计器
   	在嵌入原生设计器的基础上，用户可以自定义报表设计器的能力和样式。 比如：顶部菜单栏样式，初始化数据集等	DIV 嵌入	集成时定义报表设计器
   	集成数据集，数据模型，数据集设计器，在第三方业务系统接入数据源，完成建模等	DIV 嵌入	集成数据源/数据集查看器
   	集成整个数据分析门户的能力，通过调用 API 查看文档列表，管理文档，预览文档等	API 嵌入	API集成
   整个数据分析能力嵌入	自定义系统外观样式，包括系统Logo，名称，系统主题，登录画面，使得和业务系统保持统一风格	UI 配置	门户外观设置
   	自定义系统外观和产品安装包，将 Wyn 嵌入系统安装包中，只需安装业务系统， 便能直接获得全部数据分析功能	OEM 白标	OEM定制安装包
   认证和授权	管理员可直接在 Wyn 的后台给特定用户生成一个 Token，通过 URL 传递临时访问和查看 Wyn 里面的文档，用于安全性要求较低的场景		使用Token访问 Wyn
   	当最终用户在浏览器中通过访问 URL 查看 Wyn 的文档时，在上一个场景的基础上， 对于安全性要求较高的场景，用户可以调用 Wyn 的 API 来生成 authToken，然后将 authToken 添加到 URL中，形成最终集成用的完整 URL，这种场景下 authToken （被解析为cookie） 只能使用一次，之后用户不能在其他浏览器中再次访问该URL，也不能将其发送给其他浏览器查看， 从而大大提高了安全性。		使用 AuthToken 访问 Wyn
   嵌入 Wyn 到泛微OA	Wyn 提供专用的插件用于和泛微OA集成，包括e-cology，e-mobile，e-office集成	专用插件	泛微 OA 集成
   嵌入 Wyn 到用友U8	Wyn 支持与用友U8的集成，可在应用平台中直接查看Wyn 所生成的报表和仪表板	专用插件	用友 U8 集成

3.2 用户集成

1. 在将 Wyn 与第三方业务系统集成时，为了提高系统的安全性和多个系统集成时的登录体验，Wyn 提供以下三种方式实现用户身份的准确验证和授权访问，这样管理员可以统一、方便的在一个系统中管理和维护用户账号、权限和授权策略，同时简化了用户的登录流程，无需在每个独立的系统中单独进行登录。

• Wyn 目前提供三种用户身份集成的方式，对比如下：

  用户集成方式	详细描述
  自定义用户登录认证	用户可以自定义 Wyn 的登录验证逻辑，不使用 Wyn中的用户也可登录系统
  单点登录	在第三方系统（例如OA系统）中登录后不需要重复登录即可进入访问 Wyn
  用户信息同步	将第三方系统（例如OA系统）中的用户同步到 Wyn 的系统中

3.2.1 使用第三方认证系统登录 Wyn

1. Wyn 提供独有的安全提供程序机制，可以基于第三方系统的用户信息或者其他的登录验证机制，执行用户登录信息的验证，以此来登录 Wyn 。简单来说就是在和 Wyn 集成的过程中，用户可以使用其他业务系统中已有的用户名和密码登录到 Wyn 系统，这种安全提供程序机制完美解决了用户需要在多个系统维护多套用户名和密码的问题，同时保障了集成的安全性。

• 方案选型建议如下：

  集成场景	场景详情描述	实施步骤
  使用企业微信登录 Wyn	移动办公的场景下，用户期望直接使用企业微信扫描二维码，授权登录 Wyn	微信用户扫码登录
  使用钉钉登录 Wyn	移动办公的场景下，用户期望直接使用钉钉扫描二维码，授权登录 Wyn	钉钉用户扫码登录
  AD 认证	当第三方系统与 Wyn 集成时，可使用 Wyn 内置的账号登录验证，用户输入的用户名和密码与 Wyn 中已经定义的用户名和密码匹配时，才能成功登录 Wyn，这种场景下可将 Windows 活动目录添加到 Wyn 的用户安全提供程序	AD Security Provider 集成
  Open LDAP 认证	统一管理认证登录，Wyn 与支持LDAP协议的系统集成后，可以使用一个账号同时登录到 Wyn 和其他业务系统	Open LDAP 集成
  自定义安全提供程序	自定义一个安全提供程序，从而实现业务系统的用户可以直接登录 Wyn	自定义安全提供程序
  通用 OAuth 2.0 认证集成	OAuth 2.0 这个授权协议在Oauth的基础上再安全方面做了进一步的提升，客户可以采用 OAuth 2.0 作为登录 认证来接入和访问Wyn	通用 OAuth 2.0 认证集成

3.2.2 单点登录

1. 目前 Wyn 支持的单点登录协议如下：

   集成场景	场景详情描述	实施步骤
   调用 API 单点登录	Wyn 提供了后台登录的 API，可实现用户账号与密码验证，通过后返回 Wyn 的令牌	调用 Wyn API 实现 单点登录
   CAS 单点登录	用户想要通过 CAS（Central Authentication Service）统一身份认证平台登录 Wyn	配置 CAS 协议实现单点登录
   Oauth2.0 单点登录	用户想要通过 Oauth2.0 认证登录 Wyn	配置 Oauth 实现单点登录
   OIDC 单点登录	用户想要通过 OIDC（OpenID Connect）认证登录 Wyn	配置 OIDC 实现单点登录

3.2.3用户信息同步

1. 在之前的第三方业务系统（比如：OA,CRM等）中已经创建和管理了一套用户信息，在 Wyn 集成时，想要以业务系统作为统一用户管理平台同时用这部分用户信息登录 Wyn 时，需要将第三方业务系统中的用户信息同步到 Wyn 中，这样用户就可以登录和使用 Wyn 。

• Wyn 提供 Restful API 来创建，修改，删除用户、角色、组织、权限等信息，第三方业务系统可以通过调用 以下 API 来实现用户信息的同步，如下：

  集成场景	场景详情描述	实施步骤
  用户信息	包括：创建用户、查看用户信息、删除用户、禁用/启用用户、更改用户密码、解锁用户、更新用户个人资料信息、 获取当前用户所属的组织、设置用户登录的默认组织等	User
  用户上下文	包括：获取用户上下文信息、添加用户上下文信息、修改指定用户的上下文信息、删除指定用户的上下文信息等	Identity
  用户扩展属性	包括：获取所有扩展属性、添加新的扩展属性、获取指定的扩展属性的信息、删除指定的扩展属性、更新指定的扩展 属性的信息等	Identity
  角色信息	包括：查询所有角色、添加新角色、获取当前登录用户的所有全局角色、删除角色、查询属于特定角色的所有用户、 将用户添加到指定角色、更新属于指定角色的用户、删除属于指定角色的用户、获取指定角色的权限、 更新指定角色的权限、导入角色等	Role
  组织信息	包括：查询所有组织信息、增加一个新组织、查询特定的某个组织信息、修改指定的组织信息、删除某个指定的组织、 获取指定组织的所有子组织、获取某个组织下的所有用户、给指定的组织增加用户、修改指定组织下的用户、 删除指定组织下的指定用户、获取某个组织下的所有角色、给某个组织增加新角色、删除某个组织下的某个角色	Organization
  权限信息	包括：获取所有权限、修改文档权限、批量修改文档的权限等	Identity-permission

4. Wyn 嵌入式 Playground 体验

1. 在嵌入式方案选型和实施项目的过程中，除了参考上面的集成指南，您还可以单击 Wyn 嵌入式分析Playground 身临其境的体验 Wyn 的嵌入式场景和能力，助力快速实施项目。