适用版本：EAS8.2及以上、EAS Cloud8.6.1及以上版本

一、用户场景

       按照企业微信公布的接口收费政策,部署EAS Cloud轻应用到企业微信平台上,需要额外购买其接口服务。轻应用集成企业微信项目部署变得异常困难,内容繁琐且流程复杂易混淆,难以实施。痛点如下：

1） 企业微信接口单独收费，不便于管理管理和对接；

2） 环境部署过程过于复杂，需要专业技术人员更改配置文件；

3） 轻应用种类繁多，没有统一的管理入口。

二、解决方案

      企业可通过金蝶许可订货渠道购买微信基础账号，无需与企业微信对接。EAS Cloud轻应用支持扫码安装，并通过应用管家在移动端完成环境部署。管理员可以灵活配置不同轻应用的接入方式,将多种轻应用整合在一起。

三、功能介绍

以下为EAS Cloud集成企业微信的操作手册详情。

1.必备条件

1.1 网络访问

1）EAS需要有访问这个地址的权限https://api.kingdee.com/kcclightservice

2）EAS需提供公网地址（用手机流量也能访问的地址）

3）EAS服务器能被移动bos服务器(域名:mbos.kdeascloud.com、IP:121.37.207.73）访问

     验证方式：https://mbos.kdeascloud.com/mbos/auth/pingEasUrl?easurl=http://211.162.122.83:80（红色部分替换为现场的公网地址，如果返回结果为true，则表示网络没问题，可以部署。）

     特别说明：此处不做网络验证，也可以直接部署，部署过程中程序也会做校验。

1.2 补丁更新

注意：使用流程助手轻应用，需要更新BOS，lightapp，流程中心三个领域的补丁。使用其他轻应用只需更新BOS领域的补丁即可。补丁更新详见各版本补丁发放链接（按迭代更新）

1） EAS Cloud9.0版本，暂无需更新补丁

2） EAS Cloud880版本补丁链接：

https://vip.kingdee.com/article/419524757193633280

3）EAS Cloud861版本补丁链接：

https://vip.kingdee.com/article/391318686167804160

4）EAS 850版本补丁链接：

https://vip.kingdee.com/article/391546579934324992

5）EAS 820版本补丁链接：

此版本可能需要更换服务器端JDK版本：点击这里。

https://vip.kingdee.com/article/391582400984983808

6）EAS Cloud860版本--标准产品暂不支持，需提单分析

2. 企业微信基础账号许可订货

• 标准轻应用（包括流程助手、s-HR轻应用等）的许可订购方式和以前一样。需注意，在企业微信部署使用，需要按照总用户数量购买企业微信基础账号。购买路径：外购通用软件产品-标准外购-企业微信基础账号

3. 轻应用扫码安装

 轻应用扫码安装地址：https://mbos.kdeascloud.com/mbos/auth/install

 打开上面的地址，弹出轻应用安装界面，切换到企业微信如下图

注意：其中企业微信的团队管理员必须安装EAS Cloud应用管家，EAS Cloud可支持部署环境，也可作为所有轻应用的门户工作台，统一轻应用入口。

1）点击添加，弹出二维码。

2）使用手机企业微信扫码，弹出应用详情界面。点击添加应用，此时需要同意当前界面信息的授权，更改可见范围，设置授权应用信息等，最后点击“同意以上授权，则可添加成功”。

3）安装后显示在企业微信工作台中，根据企业微信配置，可设置显示列表模式或者工作台模式。列表模式（左图），工作台模式（右图）。

4. 移动BOS环境部署

企业微信管理员可在EAS Cloud应用管家完成部署的操作，具体步骤如下：

1） 企业微信管理员打开EAS Cloud应用管家，点击设置数据中心

2）在输入框输入该环境的公网地址，获取数据中心列表。如下图所示：

2） 如果有多个数据中心，此处只允许打开一个数据中心。打开数据中心开关，需要验证管理员密码，如下图所示：

3） 部署成功后，则可以进入EAS Cloud应用管家

4) 输入账号密码，绑定轻应用，则可以进入轻应用界面。由于轻应用并未设置内容，此时EAS Cloud应用管家轻应用界面是空白的。如下图所示：

5) 移动BOS部署后，如果需要更换环境，则在EAS Cloud应用管家中关闭数据中心，再删除该外网环境。重新输入新的外网环境开启数据中心即可。

5. 企业微信基础账号许可激活

5.1 激活注意事项

       注意：企业微信基础账号激活后不能更改企业EID，一旦绑定错误需要重新购买许可。

5.2 激活操作步骤

1）购买企业微信基础账号后，拿到订单序列号（19位数字），由企业微信团队的管理员在应用管家中激活许可。

2）用管理员打开EAS Cloud应用管家，进入【轻应用设置】菜单                                           

3）进入管理员设置界面，点击【序列号】，进入许可添加列表界面，输入19位序列号，点击【确定】，完成激活操作。

5.3 企业微信基础账号转移

如想查看企业微信基础账号被哪些用户占用，或者要转移许可，可按以下步骤操作：

1）企业微信基础账号转移需扫码安装星空应用管家，安装地址：https://qing.ik3cloud.com/install/

2）安装星空应用管家后，按照帖子转移许可：https://vip.kingdee.com/school/detail/347454493422153728

3）企业微信基础账号基础的常见问题：

 https://vip.kingdee.com/article/337232261290638336?productLineId=1&isKnowledge=2

6. 轻应用发布到EAS Cloud应用管家

 获取企业微信团队EID的方式：

打开查询分析器，复制如下服务器端脚本，result输出的即为mbos注册的eid

1） 使用管理员登录移动BOS 网页端，地址为：https://mbos.kdeascloud.com/portal

输入企业的EID，管理员账号密码，验证码登录系统。

2）进入移动BOS网页端界面，选择轻应用发布菜单

3）点击“+”添加轻应用分组，输入分组的编码、名称和描述。该分组名称则是EAS Cloud在移动端的分组名称

4） 创建分组完成后，在分组中添加轻应用，点击分组下方的编辑按钮

5） 在分组编辑界面，点添加轻应用

6） 进入新增轻应用界面，轻应用类分为三类，按照需求选择对应的分类，填入对应的信息，可根据不同的轻应用选择不同的logo作为图标。

7） 可根据要求，在该界面设置轻应用的可见范围，默认仅创建人可见，可根据需求更改设置。

8） 点击确定，轻应用分布成功，展示在分组的列表中。

9） 添加应用后，移动端EAS Cloud应用管家的展示效果如下图所示：

10）EAS Cloud应用管家中轻应用分组或者轻应用信息需要调整，可以在web端轻应用发布功能中操作。

7.工作流消息推送问题

注意：流程助手实现推送消息要满足以下条件：

 1、将流程助手标准应用扫码安装在企业团队中。如果只是通过EAS Cloud应用管家发布流程助手，则无法实现消息推送； 

2、审批人需要打开EAS Cloud应用管家或者流程助手标准应用，在弹出的隐私声明授权后，才能收到待办消息，没有隐私授权 无法推送消息。

8. 企业微信同步工具

参考知识：  【企业微信同步工具】-操作手册 （适配新企业微信接口2022.08.15）