知行之桥如何将消息推送到钉钉群?
在钉钉平台中,机器人主要分为企业机器人和自定义机器人两类。本文将重点介绍如何通过自定义机器人,实现将知行之桥 EDI 系统的通知消息高效推送至钉钉群,帮助企业第一时间掌握业务动态。
一、在钉钉群中添加自定义机器人
在需要接收知行之桥消息的钉钉群组中,找到 群设置->机器人,按照下图所示内容,添加一个自定义机器人。
添加机器人的时候,在上述页面中需要进行安全设置,用户可以选择 自定义关键词、加签以及IP地址(段)的安全方式。
更多可参考:创建自定义机器人
二、获取已添加机器人的Webhook地址:
在群设置->机器人中,找到我们刚刚添加的机器人。
更多可参考:获取自定义机器人的Webhook地址
特别提醒:请妥善保管机器人的 Webhook 地址,避免泄露。切勿公开在 GitHub、博客等平台,否则可能被不法分子利用,导致机器人被用于发送垃圾信息。
三、知行之桥设置
在知行之桥EDI系统中,创建一个REST 端口,在 设置 选项卡下,需要完成以下配置:
1.设置 操作 为:Transform
2.将 方法 设置为 POST,将机器人的webhook地址配置在REST端口的URL处。
注意:每个机器人的URL 不一样,实际使用时请使用实际机器人的webhook地址即可
3.头部配置:设置 名称 为:Content_Type,值 设置为:application/json
4.正文配置:设置 正文类型 为 raw,Content Type 设置为:JSON(application/json)
四、通过钉钉机器人发消息
至此,就可以通过钉钉机器人发消息了,钉钉自定义机器人支持六种消息类型,包括Text文本类型、Link链接消息、Markdown 类型、整体跳转 ActionCard 类型、独立跳转 ActionCard 类型、FeedCard 类型,消息类型对比可参考:自定义机器人发送消息的消息类型
以发送文本消息为例,要实现钉钉通知,需要传输的json文件格式如下所示:
1 2 3 4 5 6 7 | {"text":{ "content":"IRIS,123" }, "msgtype":"text"} |
将上述文件上传至知行之桥REST端口的 输入 选项卡下:
文件成功发出后,在设置了自定义机器人的钉钉群中可以收到以下消息:
注意:为了保证安全性,钉钉强制使用一种安全方式,本次演示使用的是关键字方式:
更多说明:自定义机器人安全设置
五、EDI 消息提醒推送
接下来以接收一个850采购订单为例,为大家演示如何实现钉钉通知。
1.在接收端口(比如AS2)后新增一个报文转换端口(比如X12),报文转换后需要增加XML MAP端口,XML MAP端口后新增JSON端口,最后以REST端口作为工作流的结尾,形成这样的工作流:
2.在XML MAP中进行数据提取和格式调整
我们以850采购订单为例,在XML Map端口需要选择来源模板文件和目标模板文件,来源模板文件我们以最常见的00401为例,目标模板文件是将调用钉钉接口的json转换得到xml。以下是一个目标模板文件示例:
1 2 3 4 5 6 | <Items xmlns:json="http://arc.cdata.com/ns/jsonconnector" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <msgtype>text</msgtype> <text> <content>hello world</content> </text> </Items> |
上传好来源模板文件和目标模板文件后,首先需要将来源模板中的TX-00401-850节点拖拽到目标模板中的Items上,接下来找到来源模板中存放采购订单编号信息的BEG03节点,将其拖拽到目标模板中的 content上,如下所示:
注:用户可以在知行EDI规范查询平台中,查询EDI报文各个字段的含义,本次示例中需要的采购订单编号,对应EDI 850报文中的BEG03节点。
接下来点击上图content节点的 编辑节点 按钮,编辑节点值,为这个映射添加关键字PO,令content元素的值为PO:[xpath("BEG/BEG03")],这样设置的目的是,钉钉群组通知格式将会变成,PO:实际的采购订单编号。用户可以根据实际业务需求,修改这里的文字描述。
在此弹窗页面中点击 应用,在XML Map端口点击右上角的 保存 按钮,保存当前映射结果。上述操作完成后,即可提取PO号码,并且用文本类型将PO推送到钉钉群。
接下来回到当前工作流的X12端口,在 输入 选项卡下上传一个测试的850文件,文件将会被自动处理,用户可以在钉钉群中查看如下的消息提示:
收到采购订单后,知行之桥成功将消息推送到钉钉群中。
以上就是关于知行之桥如何将消息推送到钉钉群的基础示例介绍。如果您有更复杂的业务通知需求,欢迎随时交流。