本文介紹如何創建和管理集成流,以及集成流與集成接口的說明和開發集成流的基本原理。
創建和管理集成流
方式一:在集成流頁面創建集成流
在目標集成應用導航欄中,選擇 。
在集成流頁面,單擊新建流。
在新建集成流面板,完成相關配置項設置后,單擊創建。
配置項
說明
名稱
集成流名稱,必填,后續可修改。
編碼
集成流的唯一標識。系統自動生成,不支持修改。
描述
補充信息,非必填。
選擇觸發方式
當前集成流僅支持HTTP API的觸發方式。更多關于HTTP API方式的信息,請參見HTTP API方式。
選擇集成接口
您至少需要選擇一個集成接口與集成流綁定。
在是否打開設計器對話框中,單擊確定。
頁面自定跳轉至集成流設計器頁面,您可以按需設計。
方式二:在集成接口綁定服務時自動創建集成流
在目標集成應用導航欄中,選擇 。
在集成接口頁面,單擊目標接口分組名稱。
在應用接口管理頁面,單擊目標接口名稱右側綁定服務列下的圖標。
在綁定服務面板,在選擇服務類型下拉列表中選擇集成流,選擇自動創建集成流方式。
單擊確定。
在是否打開設計器對話框中,單擊確定。
頁面自定跳轉至集成流設計器頁面,您可以按需設計。
編輯集成流基本信息
在集成流頁面,單擊目標集成流名稱右側操作列下的編輯。
在編輯集成流面板,按需完成相關配置項修改后,單擊保存。
說明如需修改集成流和集成接口的綁定關系,您需要在應用接口管理頁面進行調整。
刪除集成流
在集成流頁面,單擊目標集成流名稱右側操作列下的刪除。
在二次確認對話框中,單擊刪除。
重要集成流被刪除后,平臺將自動取消其與集成接口的綁定關系,之前綁定的集成接口將不能被調用。
集成流與集成接口的關系說明
集成流與集成接口是1:N的關系。
一個集成流可被多個集成接口綁定,每個集成接口只能綁定一個集成流。
刪除已經完成綁定的集成流或集成接口時:如果刪除集成接口,原集成流不會自動刪除,僅會刪除該綁定關系,不影響其他接口與該集成流的關系;如果刪除集成流,原接口不會自動刪除,和此集成流相關的所有綁定關系會被自動刪除。
集成應用部署完成后,編排引擎收到HTTP請求后:
首先,編排引擎會根據HTTP請求中的URL將請求路由到對應的集成流元數據。路由是根據集成接口的分組BasePath和接口的Path共同構成。
其次,編排引擎會根據集成接口定義的入參,對HTTP請求內容進行校驗,只有滿足條件的請求才能響應執行。
集成接口定義中的HTTP Response,目前在綁定的集成流中并未直接使用,需要由開發者按照接口定義的內容自行拼裝返回內容。
開發集成流的基本原理
核心概念
集成流是基于流的方式進行開發,每個集成流由數個節點構成。集成流運行時依靠“消息”在節點之間傳遞信息,如下圖所示。每個節點每次運行時會包含三個環節:收到輸入消息(input message)、運行本節點的邏輯(如請求某個應用的接口)、產生輸出消息(output message)并向后傳遞。
集成應用對消息結構(message)進行了統一的約定,類型為StepMessage,主要結構如下:
屬性名 | 說明 |
attribute | 保存該節點配置在此次運行時的具體值 |
payload | 消息正文。例如:HTTP請求節點的輸出消息,payload內容為對端應用接口的HTTP Response內容。 |
variable | 變量。用于消息在流中傳遞的過程中,暫存的中間值 |
error | 保存錯誤信息 |
開發集成流
應用集成平臺提供集成流設計器用于進行集成流開發,具體如下圖所示:
集成流設計器頁面主要包括:
左側面板:列出當前支持的流程節點和連接器節點。
畫布:您可對流程中的節點進行增、刪、改操作。
右側面板:對選中的節點內容進行配置,不同類型的節點配置內容有所不同。
頂部工具欄:左側可快速切換到當前版本集成應用的其他集成流,右側提供了保存和調試功能。
設計器沒有自動保存功能,需要您根據當前開發進度及時進行保存。調試時更新的集成流設計內容為最后一次保存成功的內容,請及時保存。
調試集成流
應用集成平臺提供調試器用于調試集成流,具體如下圖所示:
集成流調式頁面主要包括:
左側面板:列出調試狀態下的運行記錄。點擊后可查看此次運行的概要情況,可逐步深入查看節點的每次執行的輸入消息和輸出消息。
畫布:列出此次運行的流程結構,并可直接看到此次運行到哪個環節出現錯誤。
底部面板:
此次運行記錄的概要信息,如果運行出錯,錯誤信息可在運行狀態處查看到。
調試環境的實例信息。
右側面板:針對畫布中選中的節點,在此次運行中的輸入消息和輸出消息,并可逐層展開。
頂部工具欄:
選擇調試環境。
發起接口調試。可根據集成流對應的集成接口定義,拼裝入參信息,在線發起調用。