釘釘已經(jīng)成為很多企業(yè)日常工作必備的交流軟件,知行軟件也在釘釘通知上做出了一些努力,利用知行之橋的REST端口調(diào)用釘釘機(jī)器人API從而實(shí)現(xiàn)釘釘通知的功能,這樣當(dāng)客戶在EDI系統(tǒng)上收到數(shù)據(jù)后,釘釘群組同時(shí)會(huì)發(fā)送通知消息,客戶可以及時(shí)處理信息,提高效率。
一,創(chuàng)建釘釘機(jī)器人
釘釘?shù)娜航M有一個(gè)自定義機(jī)器人的功能,可以利用這個(gè)功能來創(chuàng)建消息通知的釘釘機(jī)器人,實(shí)現(xiàn)釘釘通知。
1、打開群組設(shè)置,點(diǎn)擊添加機(jī)器人。
2、選擇自定義機(jī)器人
3、設(shè)置機(jī)器人姓名
這里可以進(jìn)行自定義比如:【消息通知】。選擇對應(yīng)需要接收通知消息的群組,添加安全設(shè)置。如下圖所示,這里是三選一,一般選擇自定義關(guān)鍵字即可,注意這個(gè)關(guān)鍵字需要在REST端口傳輸?shù)膉son文件中使用到。例如添加了一個(gè)自定義關(guān)鍵詞:“收到”,則這個(gè)機(jī)器人所發(fā)送的消息,必須包含“收到”這個(gè)詞,才能發(fā)送成功。
4、設(shè)置完成后機(jī)器人就會(huì)開始工作
需要注意的是,機(jī)器人的設(shè)置界面會(huì)有一個(gè)帶有access_token的url,復(fù)制保存,在調(diào)用時(shí)需要用到這個(gè)帶有access_token的url。
二 調(diào)用API
在知行之橋的REST端口設(shè)置帶有access_token的url,方法為:POST 頭部為Content_Type:application/json 另外需要注意的是:發(fā)起POST請求時(shí),必須將字符集編碼設(shè)置成UTF-8。
配置好這些,下一步就是在實(shí)際業(yè)務(wù)轉(zhuǎn)換結(jié)束時(shí)生成一份json文件,這份json文件需要包括以下參數(shù)。
要實(shí)現(xiàn)釘釘通知,需要傳輸?shù)膉son文件的格式如下所示。
1
2
3
4
5
6
7
|
{ "at": { "atMobiles": [ "180xxxxxx" ], "atUserIds": [ "user123" ], "isAtAll": false }, "text": { "content": "收到850收據(jù)@180xxxxxx " }, "msgtype": "text |
三 實(shí)現(xiàn)消息傳輸
1、釘釘通知-訂單通知
如圖所示,可以在知行之橋中搭建工作流,我們要完成的功能是:為一個(gè)Excel方案添加接收方向的釘釘通知demo。 在正常接收到X12報(bào)文,并將X12報(bào)文轉(zhuǎn)換為XML后通過上圖所示的Demo_Copy端口復(fù)制一份轉(zhuǎn)換后的xml文件,得到兩份相同的xml文件。一份按照正常的流程繼續(xù)經(jīng)Excel端口后再通過郵箱端口發(fā)送到客戶郵箱,另一份來進(jìn)行釘釘通知。
但是在進(jìn)行釘釘通知之前,需要先經(jīng)過一個(gè)Schedule端口進(jìn)行幾分鐘的延時(shí),以確保真實(shí)的數(shù)據(jù)完全進(jìn)入到客戶的郵箱后,再進(jìn)行釘釘通知。完成Schedule端口延時(shí)之后經(jīng)過Script端口,提取報(bào)文名稱和主鍵信息,轉(zhuǎn)為釘釘機(jī)器人可以讀取的json文件,然后經(jīng)過REST端口發(fā)送到釘釘群組,即可實(shí)現(xiàn)釘釘通知的功能。以下是幾種釘釘通知的界面展示。
艾特到具體人的釘釘通知
艾特所有人的釘釘通知
不做任何艾特的文本消息通知
2、報(bào)錯(cuò)預(yù)警-AS2端口自動(dòng)巡檢
EDI對外的連接端口有時(shí)也會(huì)因?yàn)楦鞣N各樣的情況出現(xiàn)問題,比如修改http為https后,出現(xiàn)設(shè)置的SSL證書問題,這樣就會(huì)導(dǎo)致EDI環(huán)境掛掉,因此可以利用釘釘通知功能來進(jìn)行自動(dòng)巡檢,當(dāng)環(huán)境出現(xiàn)問題后,用戶就可以及時(shí)知道并進(jìn)行處理。 如上圖所示,我們在知行之橋EDI系統(tǒng)上創(chuàng)建一個(gè)Script端口和AS2端口,利用Script端口來實(shí)現(xiàn)當(dāng)AS2端口的出現(xiàn)問題時(shí),及時(shí)進(jìn)行釘釘通知,方便運(yùn)維人員及時(shí)進(jìn)行檢查并糾正。 Script端口具體代碼如下:
1
2
3
4
5
|
set attr="check.sslcert" value="*"/><> set attr="check.url" value="AS2URL"/><> call op="httpGet" in="check"><> catch code="*"><> set attr="notify.url" value="【釘釘自定義機(jī)器人的url】"/><> setm item="notify"><> url = 釘【釘自定義機(jī)器人的url】 postdata = {"at": {"atMobiles":\["【被@人的手機(jī)號】"\],"isAtAll":是【否@所有人,是為true,否為false】},"text": {"content":"業(yè)務(wù)警報(bào):AS2端口無法訪問,請馬上檢查![_message | def]"},"msgtype":"text"} contenttype = application/json
call op="httpPost" in="notify" /><> catch>
set attr="o.FileName" value="[_|now]" /><> push item="o"/><> |
其中,postdata里的內(nèi)容就是調(diào)用釘釘機(jī)器人的json文件內(nèi)容。 報(bào)警示例:
這樣,通過REST端口調(diào)用釘釘通知的功能就可以實(shí)現(xiàn),用戶通過知行之橋EDI系統(tǒng)進(jìn)行數(shù)據(jù)收發(fā)時(shí),可以及時(shí)在釘釘群組中收到通知消息,確保信息能夠得到及時(shí)處理,提高響應(yīng)效率。
審核編輯:符乾江
-
端口
+關(guān)注
關(guān)注
4文章
967瀏覽量
32084 -
REST
+關(guān)注
關(guān)注
0文章
32瀏覽量
9419
發(fā)布評論請先 登錄
相關(guān)推薦
評論