從端點/端點案例同步資料有什麼差異？

對於從端點/端點案例匯入的測試步驟，其請求資料可以與關聯的端點規格/案例同步。

將端點/端點案例匯入測試步驟時，你可以選擇手動或自動模式。

手動模式適用於多人協作的情境，也就是在專案中，端點規格、開發與測試流程都有明確的分工，且每個流程都有專人負責。這些流程需要資料獨立性，以避免非預期的變更互相影響。在確保端點規格/案例資料穩定後，測試人員可以手動將其同步到測試步驟。

自動模式適用於小型團隊或獨立開發者，也就是在專案中，端點規格、開發與測試流程都由同一個角色處理，以提升端點維護與測試的效率。當「端點管理」中的端點/端點案例發生變更時，測試步驟中的端點/端點案例資料也會相應調整，確保「端點管理」與「自動化測試」之間的資料一致性。

同步關係

測試步驟匯入方式	關聯資料	測試步驟同步模式	同步內容
從端點匯入 - 手動模式	端點規格	手動模式（在測試步驟中點擊「更新」按鈕）	✅ 「參數名稱」、「Path」、「Method」、「前置/後置動作」等變更。 ❌「參數值」。
從端點匯入 - 自動模式	端點規格	自動模式（端點規格更新並儲存時）	✅ 「參數名稱」、「Path」、「Method」、「前置/後置動作」等變更。 ❌「參數值」。
從端點案例匯入 - 複製	端點規格	手動模式（在測試步驟中點擊「更新」按鈕）	✅ 「參數名稱」、「Path」、「Method」、「前置/後置動作」等變更。 ❌「參數值」。
從端點案例匯入 - 參照	端點案例	自動模式（端點案例更新並儲存時）	✅ 參照端點案例資料，端點案例中的任何變更都會影響此測試步驟的內容。

選擇手動模式時，關聯按鈕會顯示為「藍色」。當「端點管理」中的端點規格有任何變更時，測試步驟中的資料不會即時更新。測試人員可以在「測試步驟」詳細資料中手動點擊「更新」按鈕，將端點/端點案例的變更同步到測試步驟。

此模式適用於測試人員需要對大量請求參數進行微調的測試情境，可避免這些測試資料受到非預期影響，並確保測試資料與開發中端點的資料彼此隔離。

在手動模式中，關聯按鈕的下拉式選單也支援手動篩選資料同步範圍。

對於透過匯入 Endpoint → Manual update 或從端點案例匯入 → 複製所產生的測試步驟，關聯內容是端點規格。這些測試步驟可以透過點擊頁面上的「立即同步」按鈕，與端點規格內容同步。

觸發手動同步後，測試步驟會從端點規格同步資料，包括「參數名稱」、「前置/後置腳本」等。請注意，同步物件是端點規格；如果端點規格中的請求參數未設定範例值，則同步後的內容將不包含「參數值」。

儲存並更新「端點規格」中的資料不會影響關聯的測試步驟。

在測試步驟中點擊「更新」按鈕會觸發資料同步機制，且按鈕會顯示「已同步」。確認同步後的資料正確後，你需要點擊右上角的「儲存」按鈕來儲存測試步驟。

如果目前測試步驟中的大部分資料都使用手動模式，且測試人員已確認這些端點規格/案例中的資料正確，並希望快速將資料同步到測試步驟，則可以點擊測試步驟頁面上的「更新」按鈕來執行批次同步操作。

關聯按鈕會顯示為橘色。如前所述，此模式可協助獨立開發者自行控制流程並追蹤流程狀態。

對於與端點規格關聯的測試步驟，當同步模式設定為自動同步時，如果端點規格發生變更並儲存，資料將會即時更新到測試步驟中。同步的內容與前述手動同步模式一致。

在自動模式中，測試步驟中的資料與端點規格之間的任何不一致都會被醒目標示。測試人員可以選擇「還原」以保持與端點規格完全一致，也可以選擇「儲存到文件」，這會使用測試步驟中的資料覆寫端點規格中的資料，以維持一致性。

為了確保在管理測試步驟中被參照的端點案例資料時具備一致性與唯一性，應在「端點管理」系統中調整被參照的端點案例，使端點案例與測試步驟都使用相同的請求資料。

在測試步驟頁面的提示中點擊「編輯」按鈕後，你將被帶往關聯的端點案例頁面進行調整。端點案例變更後，測試步驟會自動同步資料，包括「參數名稱」、「參數值」、「前置/後置腳本」以及所有其他請求內容。