使用模擬器測試應對手冊

應對手冊模擬工具提供簡化的方法，可減少時間和工作量，輕鬆開發應對手冊。

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

• 在預先製作環境中作業，讓您測試動作並觀察結果，不會影響實際製作資料 (特別是當劇本停用時)。
• 測試每個劇本步驟或區塊，確認工作流程運作正常。
• 測試劇本中的所有可能條件分支，確認涵蓋範圍全面且行為可預測。

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

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

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

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

解讀每個步驟的模擬器結果

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

案件資料

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

查看結果

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

您可以存取下列資訊：

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

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

釘選結果

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

釘選結果可節省時間，因為：

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

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

插入結果

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

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

插入模擬資料

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

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

插入模擬資料

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

使用 Playbook 步驟設定對話方塊

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

使用模擬工具執行後的結果

釘選結果

如果步驟順利執行，您可以按一下該動作旁的「固定結果」。之後會發生以下情況：

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

插入結果

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

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

關閉應對手冊模擬工具

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

使用應對手冊區塊

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