在 Shopify Flow 中測試工作流程

您可以在啟用工作流程之前先進行測試。這能讓您在啟用工作流程以使其自行運作之前，先驗證工作流程邏輯，並確認變數和參數是否正確。工作流程測試不會執行傳送通知、更新訂單或商品，或對線上商店資料進行任何變更等動作。您可以隨時在 Shopify Flow 中測試工作流程。

每次測試都會從觸發條件事件資料開始。在 Shopify Flow 中，有 3 種取得觸發條件事件資料的方法，具體取決於您要使用真實商店資料還是模擬商店資料：

• 記錄事件：此選項會啟動測試模式，監控商店中自然發生、會使工作流程觸發的即時事件。在此模式下，您也可以開啟新的瀏覽器分頁，手動執行會以真實資料產生測試事件的即時動作，例如，自行建立真實訂單以測試「已建立訂單」觸發條件。
• 建立事件：此選項讓您能使用會導致工作流程觸發的真實商店資料來手動建立模擬事件，而不必對商店進行任何實際變更。例如，您可以從管理介面選取現有訂單，並將其真實資料用作「已建立訂單」觸發條件的測試事件，即使該訂單已建立也無妨。
• 產生事件：與手動建立測試事件類似，此選項會由 Sidekick 為您產生模擬的測試事件。例如，Sidekick 可以使用商店中的現有訂單資料，產生 2 個測試事件 (符合條件與不符合條件)，藉此測試「已建立訂單」工作流程，接著您便能依據測試偏好來使用、編輯或移除這些測試事件。

在 Shopify Flow 中測試工作流程的注意事項

在測試工作流程之前，請先留意下列事項：

• 測試模式中的工作流程會使用您商店的真實資料，以回傳 Liquid 變數並判定流程邏輯，但不會對商店執行動作或進行任何修改。為避免非預期變更，測試執行在流程邏輯中遇到第一個嘗試變更資料的動作時就會停止。
• 在建立工作流程的任何階段，您都可以測試工作流程。工作流程無須完全建置完畢即可測試您目前的版本，但工作流程中的所有步驟都必須是有效的。不完整或設定錯誤的步驟無法用於測試。
• 工作流程的「近期執行作業」清單不會納入測試的工作流程執行作業。
• 工作流程中連接外部服務的動作 (例如 Send HTTP request)，在測試期間會顯示設定預覽，但由於回傳的是模擬值而非實際資料，會顯示 Can't simulate this action 訊息。

在 Shopify Flow 中使用真實的記錄事件來測試工作流程

記錄事件時，您的工作流程會根據設定的觸發條件，使用真實商店資料來產生測試事件清單。視觸發條件事件而定，您可能需要手動執行動作來產生測試事件。例如，如果您要測試「已建立商品系列」事件，則需在 Shopify 管理介面中手動建立商品系列，以便讓工作流程記錄事件以供測試。

步驟：

1. 在 Shopify 管理介面中，前往 應用程式 > Flow。

2. 在 工作流程 區段中，按一下您要測試的流程。

3. 按一下 編輯 以開啟工作流程編輯器。

4. 在工作流程的觸發條件中，點擊「測試工作流程」。

5. 在「測試工作流程」對話方塊中，點擊「+ 新增事件」>「記錄事件」，以啟用工作流程的測試模式。

6. 選用：若沒有自然產生的可用測試事件，請在新的瀏覽器分頁中手動建立事件，以觸發並啟動測試工作流程。

7. 在測試事件對話方塊中，所有觸發的測試事件都會顯示在「記錄事件」清單。選取您要執行測試工作流程的測試事件。

8. 根據您選取的觸發條件事件，工作流程會將特定的條件和動作反白顯示，以視覺化方式呈現工作流程使用的邏輯路徑。您可以執行下列任一動作：

   • 若要根據測試事件資料來預覽適用的輸出內容，請點擊工作流程中的條件或動作步驟，然後點擊「預覽」分頁。這有助於確認變數是否顯示正確資料。
   • 若要選取不同的測試事件，請從「記錄事件」清單中選取新的測試事件。
   • 若要重新整理工作流程的測試結果，請在工作流程觸發條件上點擊 「重新啟動測試」。
   • 若要儲存測試事件，請點擊 ，然後點擊「儲存」。儲存測試事件後，您可以視需求修改測試資料。

9. 選用：點擊「停止記錄」即可結束聆聽模式。點擊「開始記錄」即可恢復聆聽即時測試事件。

在 Shopify Flow 中建立模擬事件來測試工作流程

建立模擬事件時 (無論是手動或使用 Sidekick)，您需要根據設定的觸發條件提供事件資料，以產生測試事件清單。這些模擬事件會使用真實的商店資料 (例如商店中確實存在的商品和商品系列資訊)，但不會對商店進行任何實際變更。之後您便能讓工作流程使用該模擬事件來執行工作流程的測試。

建立事件時所選取的資料，取決於啟動工作流程的觸發條件類型。例如，以「已建立訂單」觸發條件開頭的工作流程，僅需要您選取一筆現有訂單即可做為測試事件。然而，「獲得權限的公司聯絡人」觸發條件則需要您選取公司地址、該公司的聯絡人以及權限層級，才能建立測試事件。

如果您不想自行選取資料來建立測試事件，Sidekick 可以為您產生一組測試事件。

步驟：

在 Shopify Flow 中編輯已儲存的測試事件

您隨時都可以編輯工作流程所儲存之測試事件的內容。您也可以完全移除任何儲存的測試事件。

步驟：

1. 在 Shopify 管理介面中，前往 應用程式 > Flow。

2. 在 工作流程 區段中，按一下您要測試的流程。

3. 按一下 編輯 以開啟工作流程編輯器。

4. 在工作流程的觸發條件中，點擊「測試工作流程」。

5. 在「儲存的事件」清單中，將游標停留在要編輯的測試事件上，然後點擊「…」>「編輯」。

6. 更新測試事件的欄位內容。您可能需要點擊「X」來移除資料，然後才能選取新資料。

7. 點擊「儲存」。

8. 選用：若要刪除已儲存的測試事件，請將游標停留在要刪除的測試事件上，然後點擊「…」>「移除」。

檢視工作流程測試

在 Shopify Flow 中測試工作流程時，請檢查下列項目，確保流程在該測試觸發事件下如預期運作：

• 整體邏輯是否如您預期？例如，若測試事件的條件為真，流程是否會走向符合條件的邏輯路徑？
• 在所有條件與動作中，是否都使用正確的變數？例如，您可能要求流程檢查 fulfillments_item.totalQuantity 變數，它會回傳某次出貨作業中所有商品項目的數量總和；但其實應該使用 order.fulfillmentsCount.count 變數，該變數會回傳此訂單的出貨次數。
• 在所有條件與變數中，是否都使用正確的運算子？
  • 請確認 AND/OR 邏輯。例如，對於包含多個元素的條件，是要同時為真 (A AND B)，還是任一為真 (A OR B)？
  • 視情況確認 None of/At least one of/All of 邏輯。
  • 視情況確認變數運算子的設定是否正確，例如 Equal to、Not equal to、Does not exist、Exists、Greater than、Less than、Is at least one of 等邏輯。
• 條件與動作是否依正確順序發生？例如，您的工作流程可能被設定為同時檢查多個不同條件，而非先檢查一個條件，再依結果繼續檢查下一個。

如果測試工作流程的行為異常，請參閱 在 Shopify Flow 工作流程中疑難排解錯誤 的相關資訊。