1. 集成原理
2. 开启集成
设置中心->集成到第三方OA->接口管家认证->开启
备注:除开目前已知的钉钉、企业微信、云之家、泛微、IM、亚信之外的所有集成全部选择接口管家认证方式。接口管家的认证为通用集成方案,可适配市面上大部分的app
3. 根据需要开启应用的消息推送开关
4. 获取应用首页链接地址
此链接需要咨询OA方是否需要。
5. 集成移动审批应用
5.1. 单点登录
OA的工作台会出现我们应用的图标,点击图标,可进入应用的首页。同时OA的待办消息中,也会接收到审批的消息推送。两个位置都可以点击进入审批中处理业务
①联系二开团队同学,将单点登录的接口填入此处。 二开同学可参考详细操作指引:http://jfplatform.fdccloud.com/article/view?id=143
备注:接口地址需要二开团队提供,请一线同学联系对应的二开研发人员。详细操作步骤按照操作指引即可。若有其他问题,可联系云助手的开发人员。
此链接为必填项,若未填写,云助手将无法实现单点登录。
②移动审批消息地址
【使用单点登录的格式】客户OA的工作台需要增加我们应用的入口,实现点击入口,无需登录直接进入应用的首页。复制链接,此链接需要保存,需要提供给二开团队开发人员。
链接内容需要二开处理重要!!!--链接内容需要二开处理,链接中包含中文字符的内容,是变量字段,需要根据实际业务进行替换。
5.2. 【很重要】设置审批结束后跳转地址
完成所有设置后,二开同事需要根据文档内容配置审批跳转页面位置,详细配置流程可参考 链接:http://jfplatform.fdccloud.com/article/view?id=142
6. 集成管理简讯或移动报表或移动计划
6.1. 单点登录
OA的工作台会出现我们应用的图标,点击图标,可进入应用的首页。同时OA的待办消息中,也会接收到应用的消息推送。两个位置都可以点击进入应用中处理业务。 ①联系二开团队同学,将单点登录的接口填入此处。 二开同学可参考详细操作指引:http://jfplatform.fdccloud.com/article/view?id=143
备注:接口地址需要二开团队提供,请一线同学联系对应的二开研发人员。详细操作步骤按照操作指引即可。若有其他问题,可联系云助手的开发人员。
此链接为必填项,若未填写,云助手将无法实现单点登录。
6.2. 关于应用的发送消息来源
管理简讯、移动报表、移动计划的消息的发送源非ERP,是由移动端发起;而移动审批的消息是由ERP直接发起。
6.3. 填写消息转发接口
若集成管理简讯、移动报表、移动计划中的任意一个应用的时候,需要开启消息转发,需要二开团队进行开发,然后输出转发接口给负责的一线,一线在设置项中填写,如下图所示
详细原理和开发文档地址可参考:http://jfplatform.fdccloud.com/article/view?id=144
重要!!!!消息转发的类型无法定位到某一应用,需要二开在转发接口中过滤推送的审批消息。否则会导致同时集成了移动审批和移动计划(或移动报表或管理简讯)的租户,审批的同一条消息ERP直接向客户的OA推送后,通过我们转发接口又重复向客户的OA推送一个。
过滤方法:在上面步骤的http://jfplatform.fdccloud.com/article/view?id=144开发文档中
标红色的框内即消息来源是哪个应用,根据对应应用的appcode判断是否向ERP推送消息。 目前的各个应用对应的APPCODE如下。仅需要过滤掉3022的消息不推送
应用名称 | APPCODE |
---|---|
移动计划 | 3042 |
移动审批 | 3022 |
移动报表 | 3023 |
管理简讯 | 3021 |
6.4. 启用消息推送
在消息设置的配置项中,选择启用推送消息。 上一步骤的消息转发接口和启用推送消息必须同时开启和填写,否则会导致消息推送失败
7. 是否开启缓存登陆
接口管家集成方案默认将开启缓存登录,旨在用户单点登录更方便更快捷,目前市面上常规APP(企业微信、钉钉、泛微等)都会在APP切换账号的时候,清空应用缓存,所以不存在APP切换账号导致我们应用内窜号的风险;
但部分APP可能因部分技术原因限制,未实现APP切换账号的时候清空应用缓存的功能,所以可能会导致我们从应用缓存中取的用户数据没变,导致客户以为我们应用窜号了。遇到该情况,需要在设置项中关闭缓存登录的选项。
备注:关闭该选项后,应用首页地址将发生改变,请重新复制首页地址。