1.功能介绍
通过添加第三方系统的配置信息,将本平台与第三方系统进行集成,集成后可在第三方系统中启动、审批流程,可在第三方系统中接收流程审批通知等;
支持集成:企业微信、阿里钉钉、微信公众号和小程序
2.集成企业微信操作指引
2.1集成信息配置
第一步:进入【集成配置】->【企微钉钉】页面;
第二步:点击“添加”;
第三步:输入对应的corpId、corpSecret、移动端地址
第四步:配置完毕,点击保存;
企业微信后台地址:https://work.weixin.qq.com/wework_admin/frame#apps/contactsApi
注:corpId、corpSecret需要登录微信公众号的后台获取,如下图:
移动端地址:格式:【http或https】+【域名】+【端口号】+【根路径】 如:http://www.hotent.org:8280/mobilevue;
2.2同步通讯录
添加集成配置信息后,需要将通讯录进行同步;
通讯录同步方式有两种:
1、上传通讯录:将本平台的组织架构数据上传到企业微信中
2、拉取通讯录:将企业微信的组织架构拉取到平台中
2.3配置应用
配置对应的应用信息,并将菜单发布到对应的应用上
操作步骤如下:
第一步:点击企业微信下的{配置应用}按钮;
第二步:填写配置信息;
第三步:点击{一键生成};
第四步:点击{保存}或{保存并发布}
保存:仅保存配置信息;
保存并发布:保存配置信息,并将配置信息发布到企业微信对应的应用中;
配置项说明:
agentId:第三方应用id。在企业微信的应用管理里;下图中的“AgentId”:
应用secret:第三方应用secret。 在 企业微信的应用管理里;下图中的“Secret”:
菜单名称:自定义菜单名称;
菜单url:点击一键生成后,根据配置信息生成在企业微信中访问的url
(若打开应用是启动系统的某个流程,直接将手机端启动流程的链接复制到下图的标签2中即可(需要先将链接转义),)
预览效果:
接收消息效果图(点击消息可进入对应的流程页面):
注意事项
在企业微信中打开应用时,出现以下错误,需要在企业微信的应用管理中添加可信域名
3.集成小程序操作指引
集成方案示意图:
授权认证时序图:
1.申请账号
集成前,首先去腾讯小程序官网(https://mp.weixin.qq.com/)申请企业级小程序账号,个人类型的小程序不能进行集成。原因:本集成方案是基于小程序的组件<web-view>链接到H5部署地址的,小程序官方明文规定<web-view>暂不支持个人类型。
2.配置信息
账号申请成功后,将小程序的AppID和AppSecret配置到eip系统中,注意字符串前后是否有空格。如下两张图所示:
3.安装开发工具
小程序的开发和发布,都需要使用官方提供的开发工具。下载地址: https://developers.weixin.qq.com/miniprogram/dev/devtools/devtools.html 。
4.导入项目
安装好开发工具后,将项目按照下图所示导入到开发工具中,项目路径在eip项目代码的tools/miniprogram目录下。
AppID:填写步骤二中的AppID
后端服务:勾选不使用云服务
5.修改H5地址
打开pages/index.js文件,将baseUrl的值改成Eip7移动端部署的地址。注意,地址结尾无需斜杆/。
若您需要发布上线,则此地址协议必须是https开头,且需要自行去做域名备案。
若您只是测试使用,可以使用http协议,并且如下图所示配置忽略校验。
6.配置业务域名
发布上线前,必须到小程序管理后台,配置业务域名。不然微信认为不合法,将拦截H5地址,不给予访问。
7.发布上线
开发工具右上角,上传,填写版本号,提交。
提交成功后,将在小程序管理后台的开发版本上,看到刚提交的版本。可以设为体验版,或者提交审核。
上线版本、审核版本、开发版本的关系:开发版本提交到审核版本,审核版本中选择已审核通过的到上线版本。
8.错误排查
①非业务域名,如下图所示,未配置业务域名,或者业务域名校验不通过。
②小程序配置信息有误
4.集成微信公众号操作指引
添加:
在【集成中心】-移动办公,点击添加
填写信息:
AppID:开发者ID(AppID)。在【微信公众平台-开发-基本配置】复制
AppSecret:开发者密码(AppSecret)。在【微信公众平台-开发-基本配置】复制
生成菜单:
点击【集成中心】-移动办公,找到微信公众号,点击【生成菜单】
将所显示的URL地址复制,设置在公众号菜单里
设置模板消息ID:
微信公众号后台【功能】-【模板消息】-【我的模板】-复制模板消息ID
填入模板消息ID,点击保存
5. 集成阿里钉钉操作指引
阿里钉钉平台地址:https://open-dev.dingtalk.com/
1、登录钉钉开放平台,创建应用,获取第三方平台的AppKey、AppSecret、Agentld
2、进入eip系统集成中心添加钉钉并配置(点击配置前面的号,可查看相关说明。登录跳转的页面,复制ID并配置移动端地址,复制第三方平台的AppKey、AppSecret、Agentld)
3. 配置应用
将一键生成的菜单url放到钉钉开放平台的应用配置里
配置钉钉开发管理
4. 应用授权
5. 登录与分享添加回调域名
6. 版本发布及钉钉添加应用
7. 拉取用户
拉取用户前要先配置授权
若拉取失败,先手动在组织管理下添加一个组织
然后进入数据库打开uc_org表,把刚添加的组织的ID改为1,保存后再重新拉取
1.1.1.1 集成飞书操作指引
6.1 集成信息配置
第一步:进入【集成配置】->【企微钉钉】页面;
第二步:点击“添加”;
第三步:输入对应的AppID、AppSecret、移动端地址
第四步:配置完毕,点击保存;
飞书后台登录地址:https://open.feishu.cn/app?lang=zh-CN
登录会注册、并新建企业
(注:更改配置后,需要在飞书开发者后台,应用发布-版本管理与发布 中创建新的版本)
点击配置前面的号,可查看相关说明。登录跳转的页面,复制ID并配置移动端地址
进入第三方集成的开发平台复制对应开发者id、开发者密码填入获取开发者id、开发者密码需先再第三方平台创建应用
6.2点击配置,同步通讯录
拉取/上传第三方平台的通讯录,需要再第三方平台开放通讯录访问权限,保存配置后发布应用
需要发布应用后,配置的权限管理方可生效
点击同步通讯录,拉取或上传通讯录
在【用户中心】->【用户管理】查看同步第三方平台的用户,用户账号是用户的手机号,点击“更多操做”,“企微钉钉”,会生成一个第三方平台的userid,表示该用户是对应第三方平台用户
6.3第三方平台配置移动端的应用,从第三方平台跳转到移动端进行审批:如图可在飞书电脑端与飞书的手机端查看
1. 在配置中,设置产品应用配置,通过一键生成url,复制到第三方平台应用访问地址中
2.权限范围设置为全部成员
权限配置中,开通通讯录、消息与群组下的所有权限。通讯录权限是为了上传与下载用户及组织数据,消息与群组权限是为了发送卡片消息。
启用机器人,是用于发送飞书卡片消息。
3.安全设置
安全设置是为了从飞书应用中通过页面单点跳转到EIP系统的页面,即在飞书应用中登录后,可以免登录跳转到EIP系统的页面,主要包括首页和流程审批页。
添加重定向url、和H5可信域名
效果:飞书中bpm应用点击跳转到bpm移动端