连接钉钉后,通过配置输入输出参数,无需编程,即可完成与钉钉推送的集成。

本章以推送消息到钉钉为例,演示与钉钉推送集成的配置过程。

集成场景

使用ESB业务输出,配置钉钉推送→在流程上调用,推送消息到钉钉。

Image

钉钉推送的消息形式有一下两种:文本和卡片式。

Image

本节包括以下主题:

# 连接到钉钉

在【服务连接】模块,添加【钉钉】连接,填写连接信息,测试通过后,保存连接。如图:

Image

说明:

  • AppKey、AppSecret、AgentId

 登录钉钉开放平台(https://open-dev.dingtalk.com/)→应用开发→钉钉应用,在创建的的应用企信通(创建方式详见:钉钉集成 (opens new window))应用下找对应的AppKey、AppSecret、AgentId,如图:

Image

# 配置钉钉推送

在【ESB输出流】模块,点击【添加】,进入ESB业务输出配置界面,拖出【钉钉推送】节点进行配置,如图:

Image

# 文本消息推送

选择连接

在【常规】配置界面,选择连接,如图:

Image

配置传参

选择钉钉连接后,在调用界面,会自动列出推送所需的参数模板,一个用来发送文本消息,一个用来发送卡片消息,根据需要选择要使用的模板进行传参,如图:

Image

在Listenner参数下,右键“Payload”【添加主表引用】,如图:

Image

以拖拽的方式,把左侧添加的主表字段依次映射到右侧文本消息对应的参数,如图:

Image

参数说明:

touser: 钉钉帐号(必传),多个以,分割,比如:zhangsan,lisi

toparty: 钉钉部门id(可不传),若传,将推送消息给此部门下的所有钉钉账户。

content:消息内容

返回参数

返回参数这里我们用不到,无需配置,保持默认就好。

保存

到这里,推送文本消息到钉钉就配置好了,点击保存文件为:钉钉-文本消息推送。

# 卡片消息推送

选择连接

在【常规】配置界面,选择连接,如图:

Image

配置传参

选择钉钉连接后,在调用界面,会自动列出推送所需的参数模板,一个用来发送文本消息,一个用来发送卡片消息,根据需要选择要使用的模板进行传参,如图:

Image

在Listenner参数下,右键“Payload”【添加主表引用】,如图:

Image

以拖拽的方式,把左侧添加的主表字段依次映射到右侧卡片消息对应的参数,如图:

Image

参数说明:

touser:钉钉帐号(必传),多个以,分割,比如:zhangsan,lisi

toparty:钉钉部门id(可不传),若传,将推送消息给此部门下的所有钉钉账户。

title:卡片标题

$body:消息内容,文本格式

single_title:使用整体跳转ActionCard样式时的标题,必须与single_url卡片链接地址同时设置。

single_url:消息点击链接地址

markdown:消息内容,支持markdown格式,语法参考标准markdown语法。

返回参数

返回参数这里我们用不到,无需配置,保持默认就好。

保存

到这里,推送文本消息到钉钉就配置好了,点击保存文件为:钉钉-卡片消息推送。

# 在流程上调用,推送消息给钉钉帐号

在流程建模模块,拖出任务,切换为调用ESB节点,分别调用文本消息推送和卡片消息推送。

# 调用文本消息推送

流程建模模块,拖出任务,切换为调用ESB节点,选择调用对象为在ESB输出流模块配置的微信-文本消息推送,如图:

Image

配置传参

把流程数据传给ESB,只需拖拽字段一一映射即可(也可按住Ctrl键拖拽表名映射),如图:

Image

数据返回

在ESB业务输出模块,我们配置钉钉-文本消息推送时没有配置输出参数,这里也无需配置,保持默认。

到这里,在流程上的调用配置就完成了,保存发布流程:钉钉推送-文本。

调用

在流程门户,点击流程填写表单发起流程:

Image

经过一步审批,调用ESB钉钉-文本消息推送,在钉钉查看推送的文本消息,如图:

Image

# 调用卡片消息推送

流程建模模块,拖出任务,切换为调用ESB节点,选择调用对象为在ESB输出流模块配置的微信-卡片消息推送,如图:

Image

配置传参

把流程数据传给ESB,只需拖拽字段一一映射即可(也可按住Ctrl键拖拽表名映射),如图:

Image

数据返回

在ESB业务输出模块,我们配置钉钉-卡片消息推送时没有配置输出参数,这里也无需配置,保持默认。

到这里,在流程上的调用配置就完成了,保存发布流程:钉钉推送-卡片。

调用

在流程门户,点击流程填写表单发起流程:

Image

经过一步审批,调用ESB钉钉-卡片消息推送,在钉钉查看推送的卡片消息,如图:

Image Image Image

也可以传文本内容,推送内容($body)。仅仅是文本格式的卡片信息。