云之家完全集成方案
1. 云之家完全集成方案概述
金蝶云之家（简称：云之家），是金蝶旗下一款移动办公、OA、审批及应用集成的软件，与钉钉、企业微信类似。观远数据支持与云之家的深度集成，通过云之家管理中心与观远数据管理中心的简单操作，即可进行集成，打通两个平台的账号体系，进行便捷的数据分析与智能决策。
2. 云之家完全集成价值
观远数据与云之家深度集成后，可实现：
观远BI平台成为云之家的内嵌应用（轻应用）；
在云之家应用内免密登录（包括移动端和PC端）；
观远BI平台Web端可用云之家扫码登录；
观远BI平台的订阅预警消息推送至云之家，一键触达。
3. 集成配置步骤
要实现扫码登陆以及配置轻应用，则需要配置2个应用，一个是扫码登陆使用，一个是移动应用本身。
3.1 创建轻应用
首先需要在云之家管理中心创建一个可支持免密登录的轻应用。
云之家管理中心地址：https://www.yunzhijia.com
（1）应用创建路径
云之家管理中心->业务中心->应用管理->添加应用。
（2）应用创建示例
点击页面右上角「新建应用」，即进入到开发者平台，进行应用创建。
点击右上角「新建应用」，添加应用描述信息。
详细信息配置
基本信息配置完成之后，将进入到应用详情信息中，可以点击编辑，对基本信息进行补全。
功能开发配置
进行「功能开发」配置，选择轻应用，对应用本身进行相关配置。
配置各终端访问地址以及消息打开方式。
移动端
网页端
桌面端
访问地址：
其中移动端访问地址的格式为：
其中，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用户可基于云之家内嵌应用的简单集成，通过记住密码来实现快捷登录。
当观远是私有化部署集成云之家时，请确保观远服务器与云之家服务器的网络连通。
