钉钉与企信通app、采用同一个网站,同一套代码,用户在app中制作的模块、表单、流程等,可在钉钉中直接展示,反之亦然。

app与钉钉的差别只是入口不同:

  • app入口:Index.cshtml
  • 钉钉入口:dingtalk.cshtml

本节包括以下主题:

# 钉钉集成预览

审批

Image

流程发起

Image

# 开通钉钉

https://www.dingtalk.com/ (opens new window)开通钉钉。

Image

# 导入组织用户

在钉钉中添加用户时,请确保员工ID与BPM保持一致,BPM缺省使用员工ID栏位实现单点登录。

Image

当钉钉账号和BPM账号,不与员工ID栏位对应时,需修改单点登录部分,实现账号映射。

# 添加钉钉应用

创建应用

在应用开发模块,依次创建企信通、流程审批、流程发起3个应用,如图:

Image

配置应用属性

Image

  • 应用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)

发布应用

发布前需要先创建版本,填写版本描述,保存后发布。

Image

Image

# 修改钉钉入口文件

修改dingtalk.cshtml.cs文件(发布包源码目录SourceCode.rar\Mobile\Pages下),将创建的3个钉钉应用信息记录到网站。

Image

注意:修改后需重新发布移动端程序。

企业corpId

在钉钉开放平台首页模块,或直接打开网址https://open-dev.dingtalk.com/#/index (opens new window)即可查看企业的corpId。

Image

应用agentId、AppKey、AppSecret

在应用的凭证与基础信息界面可查看应用的AgentId、AppKey、AppSecret。

Image

# 集成钉钉推送

流程审批过程中的推送信息如:新任务提醒,核准通知、拒绝通知,均可推送到钉钉。

系统内置钉钉推送Provider,只需放出该Provider并设置钉钉账号信息,即可实现推送。

Image

放出钉钉推送Provider

修改Server端的appsettings.json文件,放出钉钉推送Provider。

Image

文件位置:发布包源码目录SourceCode.rar\Mobile\Pages下文件appsettings.json。

配置推送账号

修改Server端的appsettings.json文件,完成推送账号设置。

Image

文件位置:发布包源码目录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。

Image

重启BPM服务

配置项生效,需要重启BPM服务。

确认微信消息格式

还需要设置钉钉消息模板,若消息模板为空,即使进行了上述设置,仍不会发消息。

Image