Assert 事件是一個調試工具，類似於 條件事件，它測試鏈的邏輯並驗證其按預期工作。在最基本的層面上，當斷言通過時，鏈分支將不間斷地繼續，並在斷言失敗時停止 - 但有許多條件會影響此規則。您可以在本文底部找到常見用例的 清單 。
第 1 步：將事件加入鏈中
- 在 Chain Builder中， 從 Chains 標籤中，按一下 編輯 鏈。
- 按一下 Chain Events，然後將 Assert 移到事件鏈中應發生的位置。
- 從鏈中的前一個節點拖曳指向事件的連結。
注意： 要更改節點在鏈中的位置，請取消它與其他節點的鏈接，然後將其移動到應出現的位置。要一次移動多個節點，請在選取它們時按住 Shift。
- 選擇事件的節點，然後按 編輯 。
- 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別事件。
注意：如果在此斷言失敗時整個鏈應停止，則啟用 Stop Chain on Fail 。如果不進行檢查，即使該特定分支失敗，其他鏈分支也將運行完成。
第 2 步：設定條件邏輯
在 Conditions下，將條件邏輯建構成規則或規則組，以測試各種資料類型的輸出和變數：
- String，用於一個或多個字符
- Integer，對於任何整數、非十進制數值
- Date，對於日期字串或變量
- Float，對於任何數值
- JSON，用於 Javascript 物件表示法
注意： 對於 JSON，使用變數轉換來解析值。
- 選擇是否要新增 規則 或 規則組 。
- 如果您包含多個規則或群組，請使用 AND 或 OR 布林值將它們連接起來：
- 如果 所有 規則或群組必須為 true 條件才能通過，請選擇 AND。
- 如果 任何 規則或群組必須為真才能通過條件，請選擇 OR。
- 對於每個規則，選擇資料類型和要測試的輸出或變量，並設定其標準以通過條件：
- 若要測試數值是否為空，請選擇 為空 或 為非空。
- 若要測試值是否包含特定字元或其他輸出或變數值，請選擇 Contains，然後輸入或選擇要符合的值。
- 若要測試值是否滿足正規表示式，請選擇 Matches RegExp，然後輸入要符合的表達式。
- 若要測試值是否以特定字元或其他輸出或變數值開頭或結尾，請選擇 Start with 或 Ends with，然後輸入或選擇要符合的值。
- 若要測試數值是否等於金額，請選擇 = 或 !=，然後輸入或選擇金額。
- 若要測試數值是否大於或小於某個金額，請選擇 < 或 >，然後輸入或選擇金額。
- 若要測試數值是否大於、小於或等於某個金額，請選擇 <= 或 >=，然後輸入或選擇金額。
- 設定完條件邏輯後，點選 【儲存】 。
注意： 若要從條件邏輯中刪除規則，請按 刪除 。
條件和常見用例
斷言事件可以加入到鏈的多個路徑或「分支」中。每個斷言獨立運行，這意味著失敗的斷言將僅停止它所在的特定分支 - 所有其他分支將繼續運行直至完成。但是，如果任何單一斷言失敗，則整個鏈將被標記為「失敗」。
要知道的事：
- 啟用 Stop chain on failure 選項可在斷言失敗時立即停止整個鏈。
- 您可以透過新增 Set Chain Result 事件來覆寫鏈故障。當「設定鏈結果」節點設定為「成功」時，無論任何斷言失敗，該鏈都將始終通過。
條件 |
結果 |
解釋 |
|---|---|---|
| 斷言透過 | 運行繼續；連鎖成功 | 鏈條運作不間斷地繼續進行。 |
|
斷言失敗 （單一斷言） |
運行失敗；鏈條故障 |
當單一斷言放置在鏈路徑上時，當斷言失敗時鏈運行將停止。 例子： （點擊放大） 注意：斷言事件可以用作“守衛”，如果不滿足條件，它會在關鍵點之前停止鏈。當斷言事件是後續節點的依賴時，整個鏈將停止。 |
|
斷言失敗 （啟用“失敗時停止鏈結”） |
運行失敗；鏈條故障；鏈條立即停止 |
當啟用“失敗時停止鏈”選項並且斷言失敗時，所有其他分支將立即停止。 例子： （點擊放大） |
|
斷言失敗 （多個分支/斷言） |
鏈運行在失敗的分支上停止，但在所有其他分支上繼續運行，直到滿足保護/停止條件；鏈條故障 |
斷言事件可以放置在同一鏈內的多個路徑或「分支」上。失敗的斷言將停止該特定分支，但所有其他分支將繼續運作。 這允許您測試同一鏈中的多個條件。 例子： （點擊放大） |
斷言事件對比條件事件
條件事件與 設定鏈結果事件結合使用時，可用於實現類似的結果 - 但相對於斷言事件需要多個節點和分支路徑。Assert 事件旨在簡化和取代這個更複雜的過程。
為了進行演示，以下是使用條件事件重新建立「通過」和「失敗」分支所需的典型邏輯範例：
這是使用單一 Assert 事件的相同邏輯：
注意：當在同一個鏈上使用時，Set Chain Result 事件將始終覆蓋 Assert 事件的結果。例如，設定鏈結果節點設定為「成功」的鏈將始終通過，無論斷言事件為何。