【OmniBPM資料庫大整理 Part 3】

Posted by: shirley.chen 5 years, 9 months ago

(0 comments)

〔OmniBPM資料庫大補帖〕

OmniBPM系統中可以設定Webhook與外部的系統串接，利用Webhook的功能外部系統可以即時接收由OmniBPM系統主動推送的流程進度更新與文件內容！

產生金鑰：在使用前需要產生一個公司的金鑰，請注意這個金鑰是有非常大的權限，需要好好的保管。要產生金鑰請到「設定」→「公司基本資料設定」→「系統設定」頁面去按 產生API金鑰 的按鈕
設定Webhook：先到「設定」→「外部連結與資料庫設定」→「Workflow RESTFUL API Hook」進行設定
- 從這邊可以選擇要建立Webhook的流程、要觸發的流程節點以及觸發的時機
- 觸發的流程節點可以選擇不指定 ，那就表是觸發的時機是以整個流程執行的狀況為單位
- 觸發的時機則有「進入」、「完成」以及「退回」三種時機
- 選擇好了Webhook觸發條件以後，新增Webhook就可以開始編輯Webhook了。Webhook的內容需要設定的是webhook的名稱（方便自已記憶），POST的URL（這邊用 http://requestb.in 做測試用），再來可以設定POST body的內容。Post body會是以JSON的型式POST到指定的URL，JSON中出現的欄位可以自行增加和客製。另外POST body中會有一個 _event_info 的資訊，基本上就包含了整個流程和文件的內容，但是還是在這邊提供POST body設計的模式，方便存取文件內的欄位資訊。設定好了以後試跑相關的流程，就會收到webhook的POST
內容簽章：
- 為了保證webhook的內容正確性和不可變造性，我們會使用金鑰做簽章，放在HTTP header中的欄位
- 簽章方法也就是post內容以sha256做hmac的結果