注！此文仅针对集成下列oa系统：云之家，企微，钉钉，welink。其他第三方应用（例如泛微等）集成请参考：https://wenku.my7c.com/article/197248889182317056?lang=zh-CN&productLineId=8&isKnowledge=2

详细带图的操作说明来了！根据下文一步步来~可简单归纳为如下图几个步骤。附件可下载docx版。

说明：此文介绍的是单APP集成，若多APP集成（例如既和云之家又和钉钉集成），则需另外修改配置文件，请联系余路生。另外许可是绑定在企业下的，多APP集成注意在不同企业下购买许可。

一、准备工作（非常重要）

这个步骤非常非常重要，问题大都因为准备工作没做好

（1）EAS服务器所在网络要能访问OA系统、mbos服务器：

• OA系统官网
  

• https://mbos.kdeascloud.com

（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的步骤。

2、更新移动bos补丁

注意，是移动bos平台的补丁，请参考以下方式在社区搜索。

例如：【移动bos和流程助手】EASCloud_V8.8.0补丁介绍（持续更新...）——适用于s-HR的8.8及88sp1版本

务必更新！若不更新补丁，可能部署时会存在下列报错：京东云注册失败，等等。

3、部署

管理员（administrator），登录EAS网页：http://xxx.xx.xx.xxx:xxxx/portal/main.jsp（红色部分替换为现场的EAS公网映射地址）——>部署——>提交——>重启EAS服务器

• 若部署失败，请检查前文提到的准备工作、更新mbos补丁是否已执行。

若提示下述错误：

• 应用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、正式圈子

附、其他资料

集成&部署阶段

（1）集成

钉钉集成：https://wenku.my7c.com/article/197486207666961920?productLineId=8&isKnowledge=2

云之家集成：https://wenku.my7c.com/article/74444039365159168?productLineId=8&isKnowledge=2

企业微信集成：https://wenku.my7c.com/article/438401515007364096?productLineId=8&isKnowledge=2

第三方app集成mbos：https://wenku.my7c.com/article/197248889182317056?productLineId=8&isKnowledge=2

多数据中心集成：https://wenku.my7c.com/article/254636414615776256?productLineId=8&isKnowledge=2

（2）私有化部署/内网部署网络问题

考勤移动应用私有化部署：https://wenku.my7c.com/article/449968404376791296?productLineId=10

EAS服务器部署在内网：https://wenku.my7c.com/article/74505462095204352?productLineId=8&isKnowledge=2

配置门户阶段

集成成功后，如何配置门户并使用：https://wenku.my7c.com/article/491666856340772864?productLineId=10

使用阶段--报错及解决方案

（1）F7打开无数据

• 1、实际移动BOS已经支持（但按照移动BOS配置，会过滤组织）参考帖子：https://wenku.my7c.com/article/467652192510517504?productLineId=10

• 2、如果不希望过滤组织，请新建query，并调整f7字段的数据源为新建query处理（弊端：不受集团管控方案控制，跟PC端逻辑不一致，不推荐使用）参考下述两个帖子：https://wenku.my7c.com/article/420604097658723840?productLineId=8  、https://wenku.my7c.com/article/472807388152676096?productLineId=10

（2）轻应用报错整理

• 报错汇总：https://wenku.my7c.com/article/438006176740271872?productLineId=10

（3）轻应用许可不足

• 许可的概念&不足的应对策略：https://wenku.my7c.com/article/472365115992436224?productLineId=10

轻应用集成部署操作指导.docx