钉钉与企信通app、采用同一个网站,同一套代码,用户在app中制作的模块、表单、流程等,可在钉钉中直接展示,反之亦然。
app与钉钉的差别只是入口不同:
- app入口:Index.cshtml
- 钉钉入口:dingtalk.cshtml
本节包括以下主题:
# 钉钉集成预览
审批
流程发起
# 开通钉钉
在https://www.dingtalk.com/ (opens new window)开通钉钉。
# 导入组织用户
在钉钉中添加用户时,请确保员工ID与BPM保持一致,BPM缺省使用员工ID栏位实现单点登录。
当钉钉账号和BPM账号,不与员工ID栏位对应时,需修改单点登录部分,实现账号映射。
# 添加钉钉应用
创建应用
在应用开发模块,依次创建企信通、流程审批、流程发起3个应用,如图:
配置应用属性
- 应用URL
流程审批 - http://网站地址/dingtalk?app=worklist
流程发起 - http://网站地址/dingtalk?app=post
企信通 - http://网站地址/dingtalk?app=main
如:
http://trial.flowportal.com/dingtalk?app=worklist (opens new window)
http://trial.flowportal.com/dingtalk?app=post (opens new window)
http://trial.flowportal.com/dingtalk?app=main (opens new window)
发布应用
发布前需要先创建版本,填写版本描述,保存后发布。
# 修改钉钉入口文件
修改dingtalk.cshtml.cs文件(发布包源码目录SourceCode.rar\Mobile\Pages下),将创建的3个钉钉应用信息记录到网站。
注意:修改后需重新发布移动端程序。
企业corpId
在钉钉开放平台首页模块,或直接打开网址https://open-dev.dingtalk.com/#/index (opens new window)即可查看企业的corpId。
应用agentId、AppKey、AppSecret
在应用的凭证与基础信息界面可查看应用的AgentId、AppKey、AppSecret。
# 集成钉钉推送
流程审批过程中的推送信息如:新任务提醒,核准通知、拒绝通知,均可推送到钉钉。
系统内置钉钉推送Provider,只需放出该Provider并设置钉钉账号信息,即可实现推送。
放出钉钉推送Provider
修改Server端的appsettings.json文件,放出钉钉推送Provider。
文件位置:发布包源码目录SourceCode.rar\Mobile\Pages下文件appsettings.json。
配置推送账号
修改Server端的appsettings.json文件,完成推送账号设置。
文件位置:发布包源码目录SourceCode.rar\Mobile\Pages下文件appsettings.json。
注意:这里的AppKey、AgentId、AppSecret分别对应的是钉钉中创建的【企信通】应用的AppKey、AgentId、AppSecret。
如何从钉钉后台找到AppKey、AgentId、AppSecret请参考本章前序小节。
配置推送消息可直接点击处理
修改dingtalk.cshtml.cs文件(发布包源码目录SourceCode.rar\Mobile\Pages下),配置process应用和openTask应用的agentId、appkeey、secret项为【企信通】应用对应的AgentId、AppKey、AppSecret。
重启BPM服务
配置项生效,需要重启BPM服务。
确认微信消息格式
还需要设置钉钉消息模板,若消息模板为空,即使进行了上述设置,仍不会发消息。