前言：

• 移动BOS是公网应用，要求客户的EAS服务器有公网可访问的地址；

  
  

• EAS服务器会访问钉钉的接口，需要EAS能访问到钉钉服务地址，一般能访问公网就没有问题；

  
  

• 本文集成方案将不再支持低于8.0版本的EAS，低版本的建议升级EAS。
  

一、  注册开通移动bos平台

• 注册过程移动bos平台会访问eas的接口，需要eas开放外网地址

• 如果现场网络要求严格，可以仅代理出EAS服务的mbos工程的接口即可，例如http://127.0.0.1:6888/mbos

1、获取客户钉钉的企业id

        企业id（eid）用作客户在移动BOS平台的唯一标识，对应客户唯一的EAS服务，要用钉钉管理人员登录管理后台查看，如下图：Corpid即企业id。

2、更新补丁

        更新移动bos&流程助手模块补丁，查看补丁更新步骤

3、提交部署 （请使用管理员登录！）

    方式1：登录EAS门户->应用->EAS移动门户->移动开发门户->移动BOS-安装部署 

    方式2：打开链接地址进行部署： http://EAS外网服务器ip:端口/easweb/light_deploy/deploy.jsp 

    如下图：配置时请填写正确的钉钉企业号！提交的应用信息请到第二步创建应用

小结

• 通过以上步骤，客户已经可以在移动BOS平台登录，在主页的企业登录进行登录

  
  

• 公有云移动bos的主页为：https://mbos.kdeascloud.com

  
  

• 使用administrator登录可管理应用的许可，给EAS账号赋予开发权限

  
  

• 使用EAS开发者账号登录可管理平台上的轻应用

二、  移动BOS应用配置

    1、钉钉上创建应用

            钉钉管理人员登录管理后台，过程如图

2、钉钉应用权限申请

        创建应用并申请接口权限：

            个人权限    —> 个人手机号信息(Contact.User.mobile)

            通讯录管理 —> 成员信息读权限 (qyapi_get_member)

        流程助手应用还需要申请：

            待办任务—> 待办应用中待办写权限（Todo.Todo.Write）

3、配置服务器出口ip

• 服务器出口ip是服务器的公网ip，可在服务器的浏览器中百度ip，即可看到本机的公网ip；

• Linux系统的服务器可自行百度如何查看公网ip；

• 如果客户现场的网络环境已知有多个出口ip，请将这这些ip都配置上去，避免出口ip的切换导致应用不能使用！
  

    注意！出口ip不一定是服务器的公网ip，现场的服务器有的网络出入口是不同的，这点经常有人弄错导致应用不能使用！

4、配置应用首页地址

        以下是常用应用的链接地址（链接中红色字体是需要修改的部分，其他信息不用改）：

        流程助手：

        https://mbos.kdeascloud.com/mbos/auth/dingtalk.html?CorpId=$CORPID$&eid=$CORPID$&AppKey=dingqhyxdmlhr90sb4y8

        SHR应用：如员工自助、经理人自助、天天勤等应用链接，可在专项服务中咨询相关人员。

        现场开发的移动bos应用：
        可在预览页面获取到应用的链接，再获取到链接中的path和name参数，再修改以下链接中对应的参数,其他想加入的参数在链接后面加上即可;

            https://mbos.kdeascloud.com/mbos/auth/dingtalk.html?CorpId=$CORPID$&eid=$CORPID$&replaceUrl=page/loadPage&path=mcpbc/bizAccount&name=bizAccountEdit.editui&AppKey=dingqhyxdmlhr90sb4y8

5、EAS添加钉钉应用配置

        配置文件：{EASHOME}/eas/server/properties/XTServiceConfig.xml

        修改说明：(箭头指向的配置区域都是需要修改的地方)

        1、配置文件的 config根节点下增加一个Dingtalk配置项，与DbInfo为兄弟节点，可在提供的配置文件的基础上修改。如截图；

        2、AppSecret配置项原文件就有，加上新建应用的配置即可，在钉钉上每建一个应用，都需要在AppSecret下加多一个配置

        3、如果是多机集群，另外机器上的配置文件也需要修改;

        4、修改完成后使用浏览器打开文件检查文件格式是否正确，格式不对文件打不开

6、重启EAS，测试应用

        需要说明的是，用户初次在钉钉上使用移动BOS应用时没有绑EAS账号，如果用户钉钉注册的手机号跟EAS账号登记的手机号一致，移动BOS会将钉钉账号和EAS账号自动绑定，否则会弹出绑定EAS账号的界面，手动输入账号密码绑定，有绑定关系后就可以实现单点登录。

        用户绑定的关系表为：t_pm_easdtusermap，要解除绑定关系可以删除这个表中对应用户的记录。

三、流程助手待办消息配置

        如果客户使用了流程助手，需要配置消息推送，在PubAcct配置项增加一个eid为钉钉corpid的配置，如图：(箭头指向的配置区域都是需要修改的地方)

        可在提供的配置文件的基础上修改，修改完成后使用浏览器打开文件检查文件格式是否正确，确认没问题后重启EAS使配置生效。

        需要说明的是，只有eas账号跟钉钉账号有绑定的情况下，对应的钉钉用户才能收到工作流的待办消息，这需要用户第一次主动点到流程助手应用！或在专项服务中咨询钉钉的同步工具部署。

        同步工具部署可参考：https://vip.kingdee.com/article/213314320535661312

四、常见问题

        问题1：钉钉的手机账号跟EAS登记的手机号一致，点到钉钉应用没有自动绑定，弹出了绑定界面

            1）需要检查钉钉上轻应用申请的接口，看是否申请了前面说明的接口权限；

            2）需要检查钉钉配置的服务出口ip是否正确，按前面说明的获取出口ip步骤排查；

        问题2：钉钉的待办消息没有提醒，待办提醒需要满足以下两个条件

            1）流程发起人EAS账号和钉钉账号做了绑定，建议部署钉钉同步工具；

            2）流程发起人和审批人不是同一个人，否则这个审批人的待办是没提醒的。

        问题3：应用出现了Connet_accessToken_Exception

            1）检查eas的网络，看eas能否访问这个地址: https://oapi.dingtalk.com/gettoken

        问题4：工作流待办任务处理了，钉钉的待办里面还有流程助手的待办消息

            1）如果问题是偶发的，请看：钉钉待办转转已办后台事务

            2）如果问题是必现的，需要排查网络问题；

        问题5：应用出现了Connet_DtUseridInfo_Exception

              1）这个问题一般是服务器的出口ip配置错了，请看前面出口ip是如何配置，或参考: 钉钉配置服务器出口ip问题