條件分支

1.1 版本說明

1.2 應用場景

進行資料開發時，需要基於某個變數作為判斷的條件，將節點與上游節點、其他任務建立聯絡，靈活地控制下游節點運作的前提。

例如：

• 當某個部門銷售額達到一定值時，將該部門標記為優秀。

• 基於任務 1 執行的結果（success\fail），判斷是否執行任務 2 。

• 當離職人員資料達到 N 條時，將該部門的穩定性標記為風險。
  

1.3 功能簡介

「條件分支」節點需要與 参数 配合使用，當參數的值符合某個條件時，運作下游節點或者運作下游節點裏面的哪一個；當參數值不符合某個條件時，跨越執行下游節點，未執行的下游節點不等同於運作失敗，不影響整體任務的運作。

demo 範例詳情參見：https://demo.finedatalink.com/  「條件分支-複本」

2.1 準備參數

參數說明請參見：参数概述

「條件分支」節點需要與參數配合使用，當參數的值符合某個條件時，運作下游節點或者運作下游節點裏面的哪一個。

需注意：

1）若參數值為一個，設定參數後，後接一個「條件分支」節點或直接使用「條件分支」節點判斷如何運作後續節點即可。如下圖所示：

2）若參數值為多個，由於「條件分支」節點每次只能使用一個參數值進行判斷，需要將「條件分支」節點及後續要判斷是否運作的節點放到「循環容器」節點中，由「循環容器」節點遍歷所有參數值。如下圖所示：

2.2 條件分支節點設定項說明

「條件分支」節點設定項如下圖所示：

2.2.1 下游節點

當條件判斷透過時，運作對應下游節點，否則不運作。

2.2.2 判斷條件

1）判斷條件說明：

條件判斷傳回的值為布林型：true 或 false

• 當回傳值為 true 時，執行下游節點。

• 當回傳值為 false 時，不執行下游節點。

• 判斷條件預設傳回 null ，即無判斷，直接執行下游節點。

判斷條件中支援使用內建參數，可直接在條件配置中輸入參數名，格式為${參數名稱}

注：某個條件可以由多個條件用且、或的關係組成。

基於不同的參數類型，提供不同的判斷條件：

注：4.1.1 及之後版本，產品內條件判斷邏輯進行了統一，每個判斷條件的說明可參見：條件判斷邏輯說明

2）可透過摺疊樹選擇參數：

4.1.0 及之後版本，新增參數時，可透過摺疊樹選擇參數，可選的參數類型：任務內參數、全局參數、內建參數。如下圖所示：

3）常數條件值說明：

直接輸入常數類型的條件值，和定義參數時輸入常數格式保持一致，具體要求如下表所示：

用正文常數值舉個例子，設定如下圖所示：

2.3 設定後續運作節點

使用者根據實際情況設定條件分支後需要運作的節點。

本文範例：每天根據機台的當機次數，將機台對應的維護級別寫到另一張表裏（任務運作當天，日期為2024-08-06）。

3.1 資料庫表說明

範例任務用到兩張表，其表名稱和欄位的說明分別如下：

edown：模擬生產環境，某個機台每天的當機次數會自動錄入該表。

estatus：每天根據 edown 表裏的當機次數，將機台維護級別寫到這個表裏，不同當機次數對應的級別不同，需要進行判別。

機台維護級別說明如下：

• 當機次數為0：正常級別。

• 當機次數大於3：嚴重級別。

• 其他：一般級別。
  

3.2 設定參數

由於不同當機次數對應的級別不同，需要透過當機次數判斷機台維護級別。因此，需要將當機次數作為參數匯出，便於後續「條件分支」節點根據當機次數判斷機台維護級別。

1）建立定時任務，拖入「參數指派」節點，將當天機台當機次數取出。如下圖所示：

點選「資料預覽」，如下圖所示：

2）將當機次數匯出為參數。如下圖所示：

注：參數建議設定除錯值，便於後續節點引用參數後查看效果；除錯值不參與實際運作。

3）給該節點新增備註：獲取當天當機次數。如下圖所示：

3.3 級別入庫

1）拖入一個「SQL腳本」節點，將當天日期和正常級別寫到 estatus 表裏，並給節點備註為：正常級別入庫。如下圖所示：

2）再拖入一個「SQL腳本」節點，將當天日期和一般級別寫到 estatus 表裏，並給節點備註為：一般級別入庫。如下圖所示：

3）再拖入一個「SQL腳本」節點，將當天日期和嚴重級別寫到 estatus 表裏，並給節點備註為：嚴重級別入庫。如下圖所示：

3.4 設定條件分支

1）在「參數指派」節點和「SQL腳本」節點之間，拖入「條件分支」節點；上游跟「參數指派」節點遠端，下游跟三個「SQL腳本」節點遠端。如下圖所示：

此時點選「條件分支」節點，可以看到多了三個分支，分別對應到下游的三個節點，可以給每個分支設定判別條件，決定執行哪一個。

2）先設定SQL腳本節點的判別條件，當當機次數等於 0 時，就執行該分支。如下圖所示：

相同步驟，設定另外兩個「SQL腳本」節點的執行條件。如下圖所示：

3.5 效果查看

點選「運作」按鈕，任務執行成功後，日誌如下圖所示：

2024-08-05 的當機次數為 6，將只執行嚴重級別入庫的「SQL腳本」節點，剩餘兩個「SQL腳本」節點跨越執行。如下圖所示：

estatus 表資料如下圖所示：

條件分最佳實踐詳情參見：使用条件分支获取优秀员工信息