使用模擬器測試應變手冊

應對手冊模擬工具提供簡化的應對手冊開發方式，可減少所需時間和精力。

應對手冊模擬工具提供多項主要功能，可讓您：

• 在試產環境中作業，讓您測試動作並觀察結果，不會影響正式環境資料 (尤其是停用應對手冊時)。
• 測試每個劇本步驟或區塊，確認工作流程運作正常。
• 測試應對手冊中的所有可能條件分支，確認涵蓋範圍廣泛且行為可預測。

搭配應對手冊使用應對手冊模擬工具

使用應對手冊時 (無論是使用現有應對手冊或建立新的應對手冊)，請務必先開啟應對手冊模擬工具。畫面頂端會顯示綠色指標，確認已啟用。

如果您在有效應對手冊上使用應對手冊模擬工具，所有觸發該應對手冊的待處理快訊都會受到影響。這是因為儲存含有模擬資料的應對手冊，會將該資料套用至正式環境的即時案件，可能影響實際結果。

1. 在所選警告中，依序點選「more_vert」more_vert警告選項 >「擷取警告做為測試案例」。這項操作會建立測試案例，用於執行模擬應對手冊。在測試案例中修改的實體不會影響一般案例中的實體。
2. 在「Playbooks」頁面中，從「Choose Case」選單中選取警告。請確認所選測試案例與您要執行的應對手冊相符。如要確認，請按一下「Entities」(實體)，確認 Playbook 能處理測試案例中的實體。
3. 按一下「執行」。模擬器會處理步驟、執行定義的動作，並提供結果。

解讀每個步驟的模擬結果

點選「執行」後，控制台的第一列會顯示為即時劇本。每個模擬步驟都會顯示選項，通常包括「Case Data」(案件資料)、「View Results」(查看結果) 和「Pin Results」(固定結果) (或「Insert Results」(插入結果))。手動步驟會提示按鈕輸入參數、提供回應，並執行步驟。

案件資料

點選「案例資料」圖示，即可開啟對話方塊，查看案例在特定階段 (目前動作執行完畢後) 的資訊。這個對話方塊會動態更新，顯示目前步驟的結果。如果動作為案件新增了擴充功能，就會顯示在這裡。由於這項資料會顯示步驟執行後的案件狀態，因此模擬控制台中的每個步驟都會有不同的資料。檢查不同步驟的案件資料，有助於瞭解執行應對手冊期間，案件套用了哪些變更。對話方塊中的多個分頁會提供額外詳細資料。

查看結果

「查看結果」選項會顯示目前步驟的特定動作結果。顯示的資訊與案件總覽或案件牆類似，也包含任何擴充功能的詳細資料。

您可以查看下列類型的資訊：

• 主要分頁會顯示輸出訊息、表格、連結和附件。
• 「技術詳細資料」分頁會顯示動作結果和 JSON 結果 (如有)。

與其他選項類似，您可以點選資料進行深入檢查。在「查看結果」頁面，您也可以點選「設定 JSON 結果」。這項功能可讓您取代目前動作的 JSON 範例。您可以直接從整合開發環境 (IDE) 修改這個 JSON 範例，然後在運算式產生器中以此為基礎，從 JSON 結果擷取特定資料。

釘選結果

步驟成功執行後，即可使用「固定結果」選項。這項功能非常實用，可讓您將動作結果視為固定值。

釘選結果可節省時間，原因如下：

• 不必等待第三方服務的結果。
• 減少對這些服務發出的查詢數量，有助於節省憑證。

基本上，當您重新執行劇本時，系統會「略過」任何有釘選結果的步驟：不會再次執行其程式碼，並直接使用釘選的結果。您也可以插入自己的模擬資料，修改這項結果。啟用「固定結果」後，動作會進入模擬模式，步驟的視覺呈現方式通常會從藍色背景變為灰色背景，清楚指出該步驟已啟用「模擬」模式。

插入結果

如果某個步驟失敗，系統就會顯示「插入結果」選項。這項功能可讓您手動插入模擬資料。下次執行這個特定步驟時，系統會傳回你手動提供的資料做為結果。

點按這個選項後，系統會自動啟用「模擬」模式。步驟的視覺化呈現方式會從藍色背景變更為灰色，清楚指出「模擬」模式已啟用。在「模擬」模式下，所有步驟都必須填寫「指令碼結果」欄位。

插入模擬資料

如要插入模擬資料，請考量下列幾個用途：

• 隨時建構及測試應對手冊：您可以執行步驟、查看結果，並立即瞭解如何在應對手冊中進一步使用這些資料。
• 在成功執行後節省時間：你可能想釘選步驟的結果。這樣一來，後續測試就不會重複對第三方 API 執行這個步驟，可節省時間。
• 測試不同情境：您可以變更步驟結果，在各種條件下測試應對手冊。設定不同的模擬資料，即可影響後續條件和動作，這些條件和動作會依據先前的結果。舉例來說，如果劇本的條件會分支成兩條以上的路徑，您可以透過模擬資料「強制」劇本採取特定分支。

插入模擬資料

您可以使用兩種主要方式，將模擬資料插入劇本：透過劇本步驟設定對話方塊，或在模擬器執行後使用「固定結果」(或「插入結果」)。

使用 Playbook 步驟設定對話方塊

1. 在應對手冊中，按一下步驟設定對話方塊。
2. 切換「模擬模式」即可啟用。動作的視覺呈現會變成灰色，表示處於模擬模式。
3. 在「動作結果」部分，您可以插入模擬 (虛擬) 資料。包括：
• 指令碼結果：為指令碼動作提供模擬結果。
• JSON 結果：輸入 JSON 資料，可能需要從 JSON 程式碼中擷取特定資料。您也可以點按「載入範例」載入範例輸出內容。這會載入動作的預期 JSON 結果，特別適合用於下列情況：
• 模擬作業尚未執行，輸出結果為空白。
• 模擬失敗，未顯示任何結果。
• 您想用範例覆寫現有結果 (來自先前的固定或插入)。
• 強化功能：您可以使用先前模擬執行的強化功能，也可以建立自訂強化功能鍵。

使用模擬器執行後的結果

釘選結果

如果步驟執行成功，您可以按一下該動作旁的「Pin Results」(固定結果)。完成後會發生下列情況：

• 系統會自動以「模擬」模式開啟步驟
.
• 系統會將最近一次成功模擬執行的結果固定在步驟中。您可以直接使用這些結果，也可以編輯。
• 您可以使用 JSON 編輯器編輯 JSON 結果，或點選「載入範例」覆寫。
• 您可以使用先前模擬執行的擴充功能，也可以建立自訂擴充功能鍵。

插入結果

如果某個步驟失敗，可以點選該動作旁的「插入結果」。完成後會發生下列情況：

1. 現在，每次執行步驟時，系統都會傳回這項資料。

關閉應對手冊模擬工具

關閉應對手冊模擬工具後，系統會隱藏底部控制台，模擬模式中的所有步驟都會還原為一般「即時」模式。但應對手冊區塊是例外情況，您必須關閉區塊模擬工具，才能關閉區塊的模擬模式。插入的模擬資料會儲存下來，下次開啟模擬器時即可使用。

使用應對手冊區塊

您也可以使用應對手冊模擬工具建構及測試新的應對手冊模塊。如果模塊處於模擬模式，使用該模塊的所有父項應對手冊也會使用模塊的模擬資料。