致远微协同标准集成只支持微信服务号、企业微信/微信企业号、钉钉。
随着企业的发展,很多企业都会考虑使用自己专属的APP平台,来塑造企业形象,实现统一移动办公。
致远微协同可以通过少量客开来实现在其它APP上使用,本文主要针对第三方APP如何集成微协同做介绍,主要分以下几个步骤:
- 组织机构同步(可选)
- 身份认证
- 访问协同H5页面
- 消息推送(可选)
依赖版本要求:V6.1SP2(含)以上,包含微协同插件。
1. 组织机构同步
第三方APP都有人员唯一标识,需要和V5人员建议对应关系,一般有两种方式:
- 通过组织机构同步实现自动绑定,V5组织架构也会一目了然的展现在第三方APP通讯录中
- 员工自行手动绑定
详细手册请参考组织同步文档:
2. 身份认证
访问协同H5页面,必须有人员身份,并且占用PC并发,实现方式:
- 通过Rest接口获取人员token
//Rest请求地址
协同地址 + "/seeyon/rest/token/" + restName + "/" + restPassword + "?loginName=" + loginName + "&memberId=" + memberId + "&userAgentFrom=weixin
参数:
restName:Rest账号
restPassword:Rest密码
loginName:协同人员账号
memberId:协同人员ID
返回值:
{"bindingUser":{},"id":"93701378-c5e7-4d9b-9938-7b243baaff17"},id为需要的token
详细手册请参考REST调用文档:
3. 访问协同H5页面
默认访问微协同待办首页,可以自定义直接访问某应用首页
//访问H5页面
协同地址/seeyon/H5/collaboration/index.html?token=93701378-c5e7-4d9b-9938-7b243baaff17&html=&loginName=
参数:
token:人员身份信息
html:要访问的H5页面地址,传空默认进入微协同待办首页
loginName:协同人员姓名,需URLEncoder.encode
4. 消息推送
通过接口实现消息推送到第三方APP
通过实现MessagePipeline接口,实现消息推送
消息链接:可参考WeixinMessagePipeline拼接
消息穿透:同样需要人员身份信息token
详细手册请参考消息集成文档:
5. 其它注意事项
- 返回问题、关闭问题
在协同安装目录\webapps\seeyon\m3\cmp\js\cmp.js中
_.platform.wechatOrDD,设为true
_.href.closePage,实现第三方app关闭webview的方法
- 文件下载问题、文件查看问题
重写cmp.att.download_third方法
重写cmp.att.read_third方法
详细手册请参考CMP文档: