云之家完全集成方案
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用户可基于云之家内嵌应用的简单集成,通过记住密码来实现快捷登录。
当观远是私有化部署集成云之家时,请确保观远服务器与云之家服务器的网络连通。