可視化編排服務方法
服務方法可以通過可視化的方式對服務進行邏輯編排。在服務編排過程中,您可以進行數(shù)據(jù)源能力的調(diào)用。編排完成后可以被前端頁面調(diào)用,實現(xiàn)前端頁面和后端服務的打通。本文介紹如何通過可視化的方式編排服務方法。
前提條件
當前應用為輕應用。
當前應用已添加依賴數(shù)據(jù)源,或當前應用有關(guān)聯(lián)的限界上下文,且限界上下文中有已定義的應用服務。
當前應用的版本狀態(tài)處于開發(fā)中,尚未發(fā)布。
當前賬號具有應用開發(fā)權(quán)限。
編排服務方法
在服務編排頁面,單擊目標服務方法或目標服務方法右側(cè)操作列下的編排服務方法。
在新打開的編排服務方法畫布中,您可以通過以下兩種方式選擇目標流程節(jié)點和目標方法調(diào)用節(jié)點:
方式一:
在畫布右側(cè)的邏輯流中單擊圖標。
方式二:
單擊畫布左側(cè)的流程節(jié)點或方法調(diào)用節(jié)點頁簽。
說明畫布中已經(jīng)默認添加好開始節(jié)點和結(jié)束節(jié)點。
本文以方式一的方式描述如何編排服務方法。
您可以單擊服務方法編排頁面左上角的圖標,在服務方法下拉列表中選擇目標服務方法。
在選擇節(jié)點對話框中的流程節(jié)點頁簽,您可以參考以下步驟配置流程節(jié)點:
關(guān)于節(jié)點的詳細說明,請參見服務編排設計器內(nèi)節(jié)點說明。
說明以下枚舉的配置項都支持新增變量:
結(jié)束節(jié)點節(jié)點的流程出參變量賦值。
ForEach節(jié)點的集合變量。
變量賦值節(jié)點的變量賦值。
If節(jié)點和設置表達式對話框中的插入變量。
異常拋出節(jié)點的異常字段賦值。
方法調(diào)用節(jié)點的返回值。
可選:單擊服務調(diào)用,在服務調(diào)用面板,完成節(jié)點名稱、描述(可選填)、數(shù)據(jù)源、請求參數(shù)和返回值設置。
數(shù)據(jù)源下拉列表如果沒有可選項,您可單擊新增服務調(diào)用,在關(guān)聯(lián)數(shù)據(jù)源面板,關(guān)聯(lián)目標數(shù)據(jù)源,具體操作,請參見關(guān)聯(lián)和管理依賴數(shù)據(jù)源。
表達式支持在設置表達式對話框中設置。
可選:單擊If,在If面板完成節(jié)點名稱、描述(可選填)分支和分支條件設置(分支條件配置方式支持結(jié)構(gòu)化和表達式),單擊保存。
可選:單擊ForEach,在ForEach面板完成節(jié)點名稱、集合變量和條目變量設置,單擊保存。
說明在邏輯編排節(jié)點的參數(shù)配置面板,系統(tǒng)將節(jié)點名稱自動生成為相應邏輯編排節(jié)點的名稱,且支持修改。
可選:單擊While,在While面板完成節(jié)點名稱、描述(可選填)和條件配置方式(支持結(jié)構(gòu)化和表達式兩種方式)設置,單擊保存。
說明表達式返回值需為Boolean類型。當表達式值為
true
時,循環(huán)內(nèi)流程將重復執(zhí)行。可選:單擊變量賦值,在變量賦值面板完成節(jié)點名稱和賦值設置,單擊保存。
您可以參考下圖配置賦值設置。
說明變量賦值節(jié)點支持調(diào)整賦值順序。
入?yún)⒑椭虚g變量都支持在賦值節(jié)點賦值。
可選:單擊打印日志,在打印日志面板完成節(jié)點名稱、描述(可選填)和日志內(nèi)容設置。
可選:單擊自定義腳本,在自定義腳本面板完成節(jié)點名稱、描述(可選填)和自定義腳本設置。腳本編寫規(guī)則及說明請單擊點擊此處。
可選:單擊異常拋出,在異常拋出面板完成節(jié)點名稱、描述(可選填)和異常處理(條件配置方式支持結(jié)構(gòu)化和表達式兩種方式,你可以按需選擇)設置。
在選擇節(jié)點對話框中的方法調(diào)用節(jié)點頁簽,您可以參考以下步驟配置流程節(jié)點。
說明您可調(diào)用依賴限界上下文中的應用服務方法,以及輕應用內(nèi)用戶自定義的服務方法及系統(tǒng)內(nèi)置的服務方法。節(jié)點名稱將默認為服務方法名稱,您需要在調(diào)用節(jié)點內(nèi)對入?yún)①x值,并為方法輸出綁定變量。
對應用服務方法調(diào)用的節(jié)點中,您還能通過綁定變量的方式獲取該服務調(diào)用返回值中的
code
、message
信息。
單擊目標應用服務方法。
在方法調(diào)用面板,設置顯示名稱、描述(可選填)、入?yún)①x值、結(jié)果輸出,在服務方法下拉列表中選擇目標服務方法。
說明在方法調(diào)用配置面板,系統(tǒng)將顯示名稱自動生成為相應方法的名稱,且支持修改。
方法調(diào)用節(jié)點的入?yún)⒑统鰠⒍贾С中略鲎兞俊?/p>
如果出參在
client
層增加了response
,在對話框中會增加錯誤信息輸出配置項。如果入?yún)⒌念愋蜑椋?/p>
基本類型:支持通過值、變量、表達式賦值。
集合類型:支持通過變量、表達式賦值。
對象類型:支持通過變量、表達式賦值。
新增服務調(diào)用節(jié)點的結(jié)果輸出中默認只有
output
。
單擊保存。
單擊畫布左側(cè)變量管理頁簽,單擊新增中間變量。
在新增變量對話框中,完成變量名稱、變量類型和描述(非必填)設置后,單擊確定。
說明在未創(chuàng)建結(jié)構(gòu)對象時,新增變量的變量類型無法選擇對象類型。
在變量管理區(qū)域,您可以查看所創(chuàng)建的中間變量。
您可以單擊目標變量右側(cè)圖標、圖標或圖標,編輯、復制或刪除變量。
單擊目標變量,在變量管理區(qū)域下側(cè),查看變量信息。
如果變量的變量類型為集合類型或對象類型,您可以單擊詳情,在詳情對話框中,查看變量的詳細信息。
可選:單擊流程圖中的目標節(jié)點,單擊圖標或圖標,編輯或刪除該節(jié)點信息。
單擊畫布右上角保存。
調(diào)試服務方法
在服務方法頁面,單擊目標服務方法右側(cè)操作列下的編排服務方法。
在新打開的編排服務方法畫布中,將鼠標移動至(置灰)圖標附近:
如果提示請先修復校驗錯誤再使用調(diào)試,請您按照畫布下側(cè)校驗結(jié)果區(qū)域的提示,進行相應的編排修改后再使用調(diào)試功能。
在新打開的編排服務方法畫布中,將鼠標移動至(高亮)圖標附近,如果提示對當前流程進行驗證調(diào)試,且畫布下側(cè)校驗結(jié)果區(qū)域提示校驗通過。單擊圖標對服務方法進行調(diào)試。
在發(fā)起調(diào)試對話框中,在調(diào)試環(huán)境下拉列表中選擇目標調(diào)試環(huán)境,mock場景默認值為不使用,在輸入數(shù)據(jù)和期望返回數(shù)據(jù)(可選填)中完成相關(guān)配置后,單擊確定。
如果您想新增mock場景,請單擊圖標,在設置mock場景對話框中,您可以參考下圖完成相關(guān)配置項設置,完成后單擊保存。
完成調(diào)試后,單擊畫布右上角的保存。
您也可以回滾歷史服務編排版本。單擊畫布右上角圖標,選擇目標歷史版本后,單擊回滾(如果無需回滾,單擊返回編輯即可)。