云之家完全集成方案

1. 云之家完全集成方案概述

金蝶云之家（简称：云之家），是金蝶旗下一款移动办公、OA、审批及应用集成的软件，与钉钉、企业微信类似。观远数据支持与云之家的深度集成，通过云之家管理中心与观远数据管理员设置的简单操作，即可进行集成，打通两个平台的账号体系，进行便捷的数据分析与智能决策。

2. 云之家完全集成价值

观远数据与云之家深度集成后，可实现：

• 观远BI平台成为云之家的内嵌应用（轻应用）；

• 在云之家应用内免密登录（包括移动端和PC端）；

• 观远BI平台Web端可用云之家扫码登录；

• 观远BI平台的订阅预警消息推送至云之家，一键触达。

3. 集成配置步骤

要实现扫码登陆以及配置轻应用，则需要配置2个应用，一个是扫码登陆使用，一个是移动应用本身。

3.1 创建轻应用

首先需要在云之家管理中心创建一个可支持免密登录的轻应用。

云之家管理中心地址：https://www.yunzhijia.com

（1）应用创建路径

云之家管理中心->业务中心->应用管理->添加应用。

（2）应用创建示例

点击页面右上角「新建应用」，即进入到开发者平台，进行应用创建。

点击右上角「新建应用」，添加应用描述信息。

详细信息配置

基本信息配置完成之后，将进入到应用详情信息中，可以点击编辑，对基本信息进行补全。

功能开发配置

进行「功能开发」配置，选择轻应用，对应用本身进行相关配置。

配置各终端访问地址以及消息打开方式。

• 移动端

• 网页端

• 桌面端

访问地址：

其中移动端访问地址的格式为：<host_url>/m?provider=yunzhijia&domain=<domain>&appType=embed

其中，domain为观远环境内的域名，注意不是如bi.abc.com这样的访问地址，一般为公司的缩写，若不清楚，请联系专属的解决方案顾问。私有化部署时，domain部分可视情况缺省。

打开方式：

• Web端展现形式一般选择“新建窗口”形式。

• 桌面端的“弹窗形式”默认的展示上有异常，需要点击弹窗右上角的扩放按钮后才能正常显示（如下图），“新建窗口形式”正常。

创建完后，可得到该APP的APP ID和APP Secret，把这些信息记下来，在后面环境配置中还将用到它们。 

创建完成之后，需要提交审核，并由管理员在业务中心-应用管理-审核自建应用中进行应用上架审核。

3.2 应用权限分发

当完成轻应用与扫码应用的配置之后，需要提交至管理员审批。审批完成之后才能进行权限的分发。

应用审核入口：业务中心-应用管理-审核自建应用。

审核通过后，即可进行应用权限的分发。权限分发入口：业务中心-应用管理-点击「详情」。

即：谁能在企业云之家门户中看到该应用。

可以设置应用可见范围是：不公开（仅应用管理员可见）、指定人员可见、全员可见。

这一步配置完成后，可以在列表中看到该新增的APP。

3.3 创建扫码登录的轻应用

云之家的移动端应用与扫码登录的应用，是严格区分的，因此不能使用同一个应用（即不能用同一个APP ID）。如果需要支持扫码登录，还需要新建一个扫码登录的应用。

整体创建流程与创建轻应用无明显差异。

需要注意：扫码应用的移动端访问地址是一个固定的地址：https://yunzhijia.com/opencloud/openthird/qrlogin

创建完后，可得到扫码应用的APP ID和APP Secret，把这些信息也记下来，在后面环境配置中还将用到它们。

3.4 观远后台配置应用信息

为了让观远平台能够在云之家内部实现免密登录，以及提供消息推送、扫码登录等相关功能，需要在观远平台内配置相关的云之家轻应用信息。

管理员登录到观远平台，在管理员设置>系统集成>云之家，启用云之家应用，编辑相关配置信息。

其中：

• 扫码登录的 App ID 和 APP Secret 在以上3.3中获得。

• 免密登录的 App ID 和 APP Secret 在以上3.1中获得。

填写完成后可测试连接确保填写无误。

这一步，需要确保服务器后端已经开启了云之家集成开关，同时为了保证能正确扫码登录与消息推送，需在后端配置正确的url-prefix(Durl.prefix)。

3.4 关联账户

所有配置信息完成之后，要想直接扫码登陆以及完成移动应用免密登陆，还需要在观远管理员后台为用户添加云之家账号信息，以便识别用户。

云之家账号关联方式：

a.云之家应用启用后，观远平台会在用户属性中添加“云之家账号”字段;

b.管理员可在用户管理中为用户绑定云之家账号。

c.也可通过批量导入或者账户同步功能的方式，来关联用户云之家账号。

云之家账号获取路径：云之家管理后台->业务中心->组织管理->批量导出。

导出的数据中，"OPENID"即为用户的云之家账号。

4. 效果演示

第一步，Web登录页新增了“云之家账号登录”入口，可以用扫码登录的方式，通过关联的云之家账户登录到观远系统。

第二步，企业员工的云之家APP中，在应用列表中可看到创建的应用。点击进入后，即可完成免密登录到观远平台H5界面。

第三步，云之家PC端应用中，找到观远平台应用入口，点击后直接免密登录到观远平台Web端界面。

第四步，订阅、预警消息推送至云之家。在配置订阅、预警通知渠道时，选择“云之家”作为触达方式。订阅与预警将会作为消息发送至云之家关联账户。用户接受消息后，点击可直达相应的卡片或者页面。

需要注意的是：

• 观远的SaaS用户可基于云之家内嵌应用的简单集成，通过记住密码来实现快捷登录。

• 当观远是私有化部署集成云之家时，请确保观远服务器与云之家服务器的网络连通。