編排測試套件

建立測試套件後，你需要新增測試內容。Apidog 提供彈性的「Static」與「Dynamic」模式，以滿足不同的測試管理需求。

匯入測試內容

在測試套件詳情頁面的 Orchestration 分頁下，點擊 + Add Endpoint Test Case 或 + Add Test Scenario。在彈出的選擇視窗中，你可以在 Static 或 Dynamic 模式之間切換。

1. Static 模式

Static 模式用於精確指定要執行的測試項目。

🎯 核心邏輯

系統會記錄你所選取的特定測試案例 ID。即使來源分類中新增了測試案例，此套件的執行範圍也不會改變，確保測試結果的可控性。

🚀 最佳使用情境

錯誤修復驗證（Hotfix）：選取 3-5 個與錯誤高度相關的測試案例，組成一個「驗證包」，快速驗證修復結果，而不會浪費時間執行無關案例。

核心業務穩定化（Core Path）：針對像「下單-付款」這類極其核心且穩定的流程。我們不希望因為新人意外新增了一個未完成的測試案例而觸發監控警報。

舊版本相容性測試：選取一批舊端點測試案例，專門用於驗證舊版本用戶端相容性。

⚠️ 維護特性

高維護成本：如果需要將新案例納入此專門測試，必須手動新增。

2. Dynamic 模式

Dynamic 模式用於透過規則自動篩選要執行的測試項目。

🎯 核心邏輯

系統會儲存 「篩選規則」（Scope & Filter）。每次執行時，系統會即時掃描整個專案，並將所有符合條件的最新案例納入執行計畫。

🚀 最佳使用情境

模組級迴歸測試：將「交易中心」資料夾設定為來源資料夾。測試人員只需要在該資料夾中撰寫新案例，套件在執行時就會自動納入這些案例。

冒煙測試：建立一個規則為 Priority = P0 的動態套件。在每次發布前執行，以自動涵蓋所有標記為 P0 的關鍵案例。

版本迭代驗證：使用標籤功能，將規則設定為 Tag = v2.5.0。開發完成後，執行此套件以驗證此版本的所有新功能。

⚠️ 維護特性

零維護成本：規則設定完成後，之後無需維護套件本身，只需維護案例屬性（位置、標籤、優先級）。

調整執行順序

匯入的內容會以清單顯示，你可以拖曳清單項目來調整執行順序。

對於以「靜態」方式新增的項目，你可以使用 Edit 逐一刪除測試案例，或刪除整個群組。

對於以「動態」方式新增的群組，你只能刪除整個群組或編輯篩選條件，無法刪除群組內的單一項目。

進階設定

在測試套件設計頁面的右側，你可以展開 Advanced Config，以更細緻地控制測試套件的執行方式。

環境

定義：預設會繼承測試套件中已設定的執行環境。如果在此處指定環境，執行期間會優先使用該環境設定。

使用案例：適用於需要在不同環境中重複使用同一組測試步驟的情境。

測試資料

用於指定執行期間是否使用測試資料。

無測試資料：測試步驟只執行一次，不執行資料驅動測試。

使用測試資料：根據測試資料執行多次，常用於參數化測試。

發生錯誤時

設定測試應如何處理錯誤，可能包含斷言失敗、資料格式驗證失敗、端點請求例外、伺服器錯誤等。

忽略：發生錯誤時繼續執行後續步驟，不中斷目前執行。

繼續：發生錯誤時，跳過目前輪次的剩餘步驟，直接進入下一個執行輪次。

結束執行：一旦發生錯誤，立即終止後續步驟。

迭代次數

定義：每個執行緒循環執行所有步驟的次數。

使用案例：常用於穩定性驗證或簡單壓力測試情境。

延遲

定義：設定每個測試步驟完成後，要等待多少毫秒（ms）再執行下一個步驟。

使用案例：避免因請求頻率過高而觸發目標伺服器的限流或熔斷機制，確保測試順利執行。

儲存請求/回應

定義：控制測試報告是否包含請求與回應的詳細資料（例如 Header、Body 等）。

選項：

全部： 無論通過/失敗，都儲存所有步驟的完整詳細資料。資料量大，適合深度除錯。

僅失敗： 只儲存執行期間失敗步驟的詳細資料。建議使用，可節省儲存空間並便於快速找出失敗原因。

不儲存： 不儲存任何詳細資料；只記錄通過/失敗狀態與耗時。

環境/全域變數值

環境/全域變數值用於指定在此測試情境中要為環境/全域變數使用哪些實際值。有兩種選擇。詳細資訊可在此查看。選擇使用儲存在 Runner 中的變數值時，你需要進一步選擇要使用的變數範圍。

此範圍的目的是協助使用者依實際需求更好地分離變數，避免因某個排程任務執行導致變數變更，進而造成其他任務失敗。選擇範圍後，你也可以透過產品介面中出現的入口查看此範圍內的變數值。

Runner 中的變數範圍	讀取/寫入環境/全域變數	說明
僅在目前測試情境中共享	在目前指定的 Runner 中，此測試情境有一個專用檔案，用於持久化儲存其環境/全域變數。只有目前測試情境可以讀取和寫入此檔案中的變數。	最小的變數範圍，影響最小。適用於需要在此測試情境的下一次執行中使用上一次執行結果的情況。測試情境、任務和任務資料夾的變數檔案都儲存在 Runner 容器路徑 `/opt/runner/variables`。
在目前排程任務中的所有測試情境之間共享	在目前指定的 Runner 中，排程任務有一個檔案，用於儲存可供其所有測試情境使用的環境/全域變數。目前排程任務中的所有測試情境都可以讀取和寫入此檔案中的變數。	建議使用的變數範圍，影響程度適中。適用於需要在同一排程任務內的不同測試情境之間共享資料的情況。
在目前排程任務資料夾中的所有排程任務之間共享	在目前指定的 Runner 中，排程任務資料夾有一個檔案，用於儲存可供其所有排程任務和測試情境使用的環境/全域變數。目前資料夾內所有排程任務中的所有測試情境都可以讀取和寫入此檔案中的變數。	最大的變數範圍，影響最顯著。某個排程任務的執行可能會修改變數值，導致其他排程任務失敗。適用於需要在同一資料夾中的多個任務之間共享資料時。

匯入測試內容#

1. Static 模式#

2. Dynamic 模式#

調整執行順序#

進階設定#

環境#

測試資料#

發生錯誤時#

迭代次數#

延遲#

儲存請求/回應#

環境/全域變數值#