本文介绍了针对云之家、企业微信、钉钉、Welink等OA系统的单APP集成方法,包括准备工作、注册开通移动bos平台、部署和验证等步骤。若需多APP集成,则需另外修改配置文件。文章还提供了同步人员的方法和其他集成、部署阶段的参考资料,以及使用阶段的报错及解决方案。
注!此文仅针对集成下列oa系统:云之家,企微,钉钉,welink。其他第三方应用(例如泛微等)集成请参考:https://vip.kingdee.com/article/197248889182317056?lang=zh-CN&productLineId=8&isKnowledge=2
详细带图的操作说明来了!根据下文一步步来~可简单归纳为如下图几个步骤。附件可下载docx版。
说明:此文介绍的是单APP集成,若多APP集成(例如既和云之家又和钉钉集成),则需另外修改配置文件,请联系余路生。另外许可是绑定在企业下的,多APP集成注意在不同企业下购买许可。
一、准备工作(非常重要)
这个步骤非常非常重要,问题大都因为准备工作没做好
(1)EAS服务器所在网络要能访问OA系统、mbos服务器:
(2)EAS服务器能被移动bos服务器(域名:mbos.kdeascloud.com、IP:121.37.207.73)访问
验证方式:https://mbos.kdeascloud.com/mbos/auth/pingEasUrl?easurl=http://211.162.122.83:80(红色部分替换为现场的EAS公网映射地址,即后续部署会用的地址(如图),如果返回结果为true,则表示网络没问题可以部署)
若返回失败,请检查EAS服务器是否有防火墙拦截规则,有则给移动bos平台加上访问白名单,IP:121.37.207.73
二、注册开通移动bos平台
1、获取企业id(eid)
企业id(eid)用作客户在移动BOS平台的唯一标识,对应客户唯一的EAS服务,以下是各个常用OA系统获取eid的步骤。
OA系统 | 获取eid的步骤 |
云之家 注册EID即eid | 管理员——1、登录云之家圈子的管理中心;2、查看团队概况 |
企业微信 企业ID即eid | 管理员——1、登录企业管理后台;2、查看企业ID |
钉钉 CorpId即eid | 管理员——1、登录钉钉开放平台:https://open.dingtalk.com/;2、进入后台,获取CorpId |
2、更新移动bos补丁
注意,是移动bos平台的补丁,请参考以下方式在社区搜索。
例如:【移动bos和流程助手】EASCloud_V8.8.0补丁介绍(持续更新...)——适用于s-HR的8.8及88sp1版本
务必更新!若不更新补丁,可能部署时会存在下列报错:京东云注册失败,等等。
3、部署
注:企业微信部署使用,需要按照总用户数量购买企业微信基础账号,否则会提示风险。购买路径:外购通用软件产品-标准外购-企业微信基础账号。且企业微信基础账号激活后不能更改企业EID,一旦绑定错误需要重新购买许可。详细参考:https://vip.kingdee.com/article/438401515007364096?productLineId=8&isKnowledge=2&lang=zh-CN 第5章 企业微信基础账号许可激活
若部署失败,请检查前文提到的网络、更新mbos补丁是否已执行。
云之家-新部署方式 轻应用扫码安装地址:https://mbos.kdeascloud.com/mbos/auth/install 登录云之家圈子,找到【EAS Cloud应用管家】,打开后,按照以下步骤部署环境。之后数据中心切换/环境重新部署等都在此处操作。 | 企微-新部署方式 轻应用扫码安装地址:https://mbos.kdeascloud.com/mbos/auth/install 登录企微工作台,找到【EAS Cloud应用管家】,打开后,按照以下步骤部署环境。之后数据中心切换/环境重新部署等都在此处操作。 | 钉钉-旧部署方式 采用旧的网页端部署方式 管理员(administrator),登录EAS网页:http://xxx.xx.xx.xxx:xxxx/portal/main.jsp(红色部分替换为现场的EAS公网映射地址)——>部署——>提交——>重启EAS服务器 若提示下述错误: 应用AppId为:xxx的应用信息查询失败,请检查应用信息是否正确。 处理:请检查服务器时间是否同步(最好设置自动同步),同步后也要注意重启对应服务。 |
提示:“云端服务器连接EAS服务器超时”
处理:请检查EAS服务器是否有防火墙拦截规则,可能是没有给移动bos平台加上访问白名单,IP:121.37.207.73
注:若想看部署对应哪个数据中心(如下图),路径:{EASHOME}/eas/server/properties/XTServiceConfig.xml
4、验证
填入前文的企业eid,使用能登录EAS(或者sHR系统)的管理员(administrator+密码),去登录mbos开发平台,地址:https://mbos.kdeascloud.com 。
再通过授权,允许其他人登录mbos开发平台,如下图。
注:如果既和云之家又和钉钉集成了,即有两个企业号,那么均需维护这两个企业号下的应用。它们是一一对应的关系,即云之家上的应用,需使用云之家企业eid去维护;钉钉上的应用,需使用钉钉CorpId去维护。
注意:
一般扩展的某个轻应用,只能存在一个账户下,所以请注意授权的人员,避免扩展时出现冲突。例如,A扩展开发了“我要请假”,那么B员工没法再扩展此应用
考勤的轻应用需要先扩展“资源库”
三、同步人员(非必选)
1、测试圈子
如果是轻应用的测试圈子,可以不同步人员到OA系统。原因如下:
以集成云之家为例,同步后在云之家的测试圈子会加入所有人员,导致超过可免费激活人数上限,无法正常测试。
可以通过邀请的方式,添加其他人员加入圈子共同测试。
2、正式圈子
OA系统 | 同步工具 |
云之家 | 操作:https://vip.kingdee.com/article/216139742775972096?productLineId=8&isKnowledge=2
|
企微 | 同步后,用户登录企微后,点击门户入口,无需手工输入eas账号及密码 参考:https://vip.kingdee.com/article/380026498914293504?productLineId=8 |
钉钉 | 参考:https://vip.kingdee.com/article/165120107889089792?productLineId=8 |
附、其他资料
集成&部署阶段
(1)集成
钉钉集成:https://vip.kingdee.com/article/197486207666961920?productLineId=8&isKnowledge=2
云之家集成:https://vip.kingdee.com/article/74444039365159168?productLineId=8&isKnowledge=2
企业微信集成:https://vip.kingdee.com/article/438401515007364096?productLineId=8&isKnowledge=2
第三方app集成mbos:https://vip.kingdee.com/article/197248889182317056?productLineId=8&isKnowledge=2
多数据中心集成:https://vip.kingdee.com/article/254636414615776256?productLineId=8&isKnowledge=2
(2)私有化部署/内网部署网络问题
考勤移动应用私有化部署:https://vip.kingdee.com/article/449968404376791296?productLineId=10
EAS服务器部署在内网:https://vip.kingdee.com/article/74505462095204352?productLineId=8&isKnowledge=2
配置门户阶段
集成成功后,如何配置门户并使用:https://vip.kingdee.com/article/491666856340772864?productLineId=10
使用阶段--报错及解决方案
(1)F7打开无数据
1、实际移动BOS已经支持(但按照移动BOS配置,会过滤组织)参考帖子:https://vip.kingdee.com/article/467652192510517504?productLineId=10
2、如果不希望过滤组织,请新建query,并调整f7字段的数据源为新建query处理(弊端:不受集团管控方案控制,跟PC端逻辑不一致,不推荐使用)参考下述两个帖子:https://vip.kingdee.com/article/420604097658723840?productLineId=8 、https://vip.kingdee.com/article/472807388152676096?productLineId=10
(2)轻应用报错整理
(3)轻应用许可不足
轻应用集成部署操作指导.docx(2.54MB)
推荐阅读