调用REST端口实现钉钉通知

钉钉已经成为很多企业日常工作必备的交流软件,知行软件也在钉钉通知上做出了一些努力,利用知行之桥的REST端口调用钉钉机器人API从而实现钉钉通知的功能,这样当客户在EDI系统上收到数据后,钉钉群组同时会发送通知消息,客户可以及时处理信息,提高效率。

一,创建钉钉机器人

钉钉的群组有一个自定义机器人的功能,可以利用这个功能来创建消息通知的钉钉机器人,实现钉钉通知。

1、打开群组设置,点击添加机器人。

edi

2、选择自定义机器人

edi

3、设置机器人姓名

这里可以进行自定义比如:【消息通知】。选择对应需要接收通知消息的群组,添加安全设置。如下图所示,这里是三选一,一般选择自定义关键字即可,注意这个关键字需要在REST端口传输的json文件中使用到。例如添加了一个自定义关键词:“收到”,则这个机器人所发送的消息,必须包含“收到”这个词,才能发送成功。

edi

4、设置完成后机器人就会开始工作

edi

需要注意的是,机器人的设置界面会有一个带有access_token的url,复制保存,在调用时需要用到这个带有access_token的url。

edi

二 调用API

在知行之桥的REST端口设置带有access_token的url,方法为:POST 头部为Content_Type:application/json 另外需要注意的是:发起POST请求时,必须将字符集编码设置成UTF-8。

edi

配置好这些,下一步就是在实际业务转换结束时生成一份json文件,这份json文件需要包括以下参数。

edi

要实现钉钉通知,需要传输的json文件的格式如下所示。

三 实现消息传输

1、钉钉通知-订单通知

edi

如图所示,可以在知行之桥中搭建工作流,我们要完成的功能是:为一个Excel方案添加接收方向的钉钉通知demo。 在正常接收到X12报文,并将X12报文转换为XML后通过上图所示的Demo_Copy端口复制一份转换后的xml文件,得到两份相同的xml文件。一份按照正常的流程继续经Excel端口后再通过邮箱端口发送到客户邮箱,另一份来进行钉钉通知。

但是在进行钉钉通知之前,需要先经过一个Schedule端口进行几分钟的延时,以确保真实的数据完全进入到客户的邮箱后,再进行钉钉通知。完成Schedule端口延时之后经过Script端口,提取报文名称和主键信息,转为钉钉机器人可以读取的json文件,然后经过REST端口发送到钉钉群组,即可实现钉钉通知的功能。以下是几种钉钉通知的界面展示。

艾特到具体人的钉钉通知

edi

艾特所有人的钉钉通知

edi

不做任何艾特的文本消息通知

edi

2、报错预警-AS2端口自动巡检

edi

EDI对外的连接端口有时也会因为各种各样的情况出现问题,比如修改http为https后,出现设置的SSL证书问题,这样就会导致EDI环境挂掉,因此可以利用钉钉通知功能来进行自动巡检,当环境出现问题后,用户就可以及时知道并进行处理。 如上图所示,我们在知行之桥EDI系统上创建一个Script端口和AS2端口,利用Script端口来实现当AS2端口的出现问题时,及时进行钉钉通知,方便运维人员及时进行检查并纠正。 Script端口具体代码如下:

其中,postdata里的内容就是调用钉钉机器人的json文件内容。 报警示例:

edi

这样,通过REST端口调用钉钉通知的功能就可以实现,用户通过知行之桥EDI系统进行数据收发时,可以及时在钉钉群组中收到通知消息,确保信息能够得到及时处理,提高响应效率。

了解更多EDI信息,请您电话 188-2919-1381或邮件 sales@kasoftware.cn 联系我们。点击下方蓝色按钮,即可免费试用EDI软件。
标签: , , ,
文章分类 帮助文档, 知识库