在釘釘平臺中,機器人主要分為企業機器人和自定義機器人兩類。本文將重點介紹如何通過自定義機器人,實現將知行之橋 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文件,文件將會被自動處理,用戶可以在釘釘群中查看如下的消息提示:
收到采購訂單后,知行之橋成功將消息推送到釘釘群中。
以上就是關于知行之橋如何將消息推送到釘釘群的基礎示例介紹。如果您有更復雜的業務通知需求,歡迎隨時交流。