大容量導入或匯出測試案例

Azure DevOps 服務

Azure Test Plans 支援使用 CSV 或 Microsoft Excel （XLSX） 檔案格式大量匯入和匯出測試案例。 您可以在測試套件中建立新的測試案例，或在匯入期間提供測試案例 ID 來更新現有的測試案例。 匯出操作將測試案例儲存為 CSV 或 XLSX 檔案，以供外部編輯或共用。

您可以使用下列選項來大規模管理測試案例：

• 批量操作： 使用 CSV/XLSX 文件導入和導出進行大規模更改
• 門戶網站工具： 直接在瀏覽器中複製、克隆和更新測試用例以進行較小的更改

如需網站入口替代選項的詳細資訊，請參閱 複製或製作副本測試計劃、測試套件和測試案例。

如需測試物件和術語的概觀，請參閱 測試物件和詞彙。

先決條件

類別	要求
專案存取	Project 成員。
存取層級	若要要求或提供意見反應：至少 項目關係人 存取權。
權限	- 若要新增或修改 Bug 或其他工作專案類型：在此節點中編輯工作專案 許可權設定為 [允許 對應 區域路徑下。 - 若要新增標籤：建立標籤定義 權限設定為 Allow。 如需詳細資訊，請參閱 設定測試的許可權和存取權。

匯出測試案例

1. 從 [測試計劃]>頁面，選擇包含您要匯出之測試案例的測試套件的測試計劃。

2. （選擇性）選取 [數據行選項]，以新增要包含在下載檔中的欄位。

3. 若要匯出測試套件的所有測試案例，請選取 [將測試案例匯出至 CSV]，或 [將測試案例導出至 XLSX]。

   

4. 若要匯出測試套件的測試案例子集，請選取要導出的測試案例、選擇 [其他選項]，然後選取 [將測試案例導出至 CSV 或 [將測試案例匯出至 XLSX]。

   

   導出的 CSV 檔案會出現在您的 下載 資料夾中。

匯入測試案例

備註

新增強的導入體驗具有更智能的自動映射、可與您的團隊共享的可重複使用的模板以及更直觀的界面。 此功能正在逐步向所有用戶推出。 如果您尚未看到新介面，您可以繼續使用現有的匯入功能，並取得相同的結果。

1. 從 [Test Plans>] [測試計劃] 頁面中，選取包含您要匯入測試案例之測試套件的測試計劃。

2. 選取 從 CSV/XLSX 匯入測試案例 圖示 。

   

3. 若要檢閱自動匹配和必填欄位，請將檔案拖放，或選取瀏覽，然後選擇要匯入的檔案。 精靈會自動處理數據，並使用模糊比對來對應偵測到的欄位，以符合您的 Azure DevOps 測試案例欄位。

4. 查看建議的欄位映射。 匯入需要九個必填欄位才能繼續：

   • ID - 為新的測試案例保留空白，提供現有的 ID 來更新測試案例
   • 工作項目類型
   • 標題
   • 測試步驟
   • 步驟動作
   • 預期步驟
   • 區域路徑
   • 指派給
   • 州

   

5. （選用）若需變更欄位對應：

   • 選取您要更新之欄位的下拉式清單，然後從清單中選擇正確的 Azure DevOps 欄位 （視需要使用搜尋） 。

   

   • 若要完全略過欄位，請取消勾選欄位的下拉式選單中的目前對應，以顯示「選取欄位...」選項。

   

6. （選用）將目前的對應匯出為可重複使用的範本，以便與團隊分享，或儲存以供未來匯入時使用，特別是當涉及類似的欄位結構時。

7. （選用）如果您要匯入包含多個工作表的 XLSX 檔案，請選擇要匯入的工作表。 您一次只能匯入一張紙。

   

8. 選擇 Import （匯入） 以完成程序。 對於已提供 ID 的現有測試案例，某些元素可能會在匯入期間被覆寫。

使用對應範本和系統記憶體

當您第一次匯入具有特定資料行結構的檔案時，請檢閱欄位對應，以確保所有欄位都正確對應至 Azure DevOps 測試案例欄位。

Azure Test Plans 會將欄位對應記錄下來，以便在有相同資料行結構的後續匯入中使用，因此您不需要重新設定它們。 不過，請務必在完成匯入之前檢閱這些對應。

對於團隊生產力：

• 將您目前的地圖匯出為可重複使用的範本，以便與團隊成員共用
• 這消除了每個團隊成員單獨配置映射的需要

為了個人效率：

• 為您經常使用的不同檔案結構建立並儲存對應模板

• 匯入適當的範本和您的資料，避免每次都必須重新設定映射配置。

  

範本變更通知： 當您匯入範本後修改對應時，系統會提醒您，有助於防止意外變更已建立的團隊標準。

小提示

地圖範本是選用的生產力功能。 當它們有助於簡化您的匯入工作流程或保持整個團隊的一致性時，請使用它們。

更新現有的測試案例

1. 若要更新工作專案，請建立包含您要匯出且可能編輯之所有數據行的數據行檢視。 將相關數據行套用至檢視后，即可將測試案例匯出至 CSV 或 XLSX 檔案。 選取 [[匯出至 CSV] 或 [匯出至 XLSX]，將檔案儲存至本機計算機。

   

2. 對測試案例進行編輯。 您不得變更 識別碼 和 工作項目類型 欄位。 您想要包含的任何其他欄位都是選擇性的。

3. 儲存檔案並將其匯回測試套件（請參閱 匯入部分。）

匯入自動化測試案例 （TCM）

若要將自動化測試案例匯入至測試套件，請使用 tcm testcase /import。 您必須為包含測試的測試元件指定 .dll 檔案。

tcm testcase /import /collection:teamprojectcollectionurl /teamproject:project
             /storage:path
             [/maxpriority:priority]
             [/minpriority:priority]
             [/category:filter]
             [/syncsuite:id [/include]]
             [/login:username,[password]]

參數	描述
/storage：path	指定測試元件的路徑和名稱，其中包含您要匯入的自動化測試。
/maxpriority：priority	自選。 根據測試方法的最高優先順序指定要匯入的測試。 例如，如果 參數是 /maxpriority:1，則只有測試方法的優先順序屬性小於或等於 1 的測試會從元件匯入為測試案例。
/minpriority：priority	自選。 根據測試方法的最小優先順序指定要匯入的測試。 例如，如果 參數是 /minpriority:2，則只有測試方法的優先順序屬性等於或大於 2 的測試會從元件匯入為測試案例。
/類別：filter	自選。 根據測試元件中每個測試方法的類別，指定要匯入的測試。 您可以將此參數與 /syncsuite 一起使用，將具有特定類別的測試匯入特定測試套件。 如需測試類別的詳細資訊，請參閱 使用測試總管執行單元測試。
/syncsuite：id	自選。 指定測試計劃中要新增所匯入測試案例的測試套件套件識別碼。 此套件不能是動態套件或查詢型套件。 如果您指定要同步處理以更新測試的測試套件，則不支援的測試會從測試套件中移除，但不會從測試計劃本身移除。

常見問題

問：我可以在同一檔案中建立新的測試案例並更新現有的測試案例嗎？

答：沒錯！ 對這兩項操作使用單個 CSV/XLSX 文件：

• 新的測試案例：將 ID 欄位保留空白
• 現有的測試案例：包含測試案例識別碼和工作專案類型

問：如何識別和解決匯入檔案中的錯誤？

答：匯入精靈會驗證您的檔案，並在多個階段顯示錯誤：

檔案上傳期間：

• 精靈會立即偵測檔案格式問題、不支援的檔案類型或損毀的檔案

在欄位映射流程中：

• 缺少的必要標頭會以紅色高亮顯示
• 無效的欄位對應會顯示警告指示器
• 未映射的必填欄位會阻止匯入繼續進行

匯入完成前：

• 最終驗證檢查可識別資料格式問題、無效字元或限制違規
• 必須先解決所有錯誤，才能繼續匯入

常見錯誤及解決方法：

• 缺少必填標題： 添加具有精確拼寫的所需列標題
• 無效的資料格式：檢查日期格式、數值和文字長度限制
• 不正確的欄位對應：確認資料行對應至正確的 Azure DevOps 欄位
• 不支援的字元：移除欄位值中不支援的特殊字元
• 空必填欄位：確保所有必填欄位都包含有效資料

若要解決錯誤：

1. 請注意精靈中顯示的特定錯誤訊息。
2. 如有需要，請取消目前匯入。
3. 修復 CSV/XLSX 檔案中的問題。
4. 重新上傳更正的檔案，並檢閱欄位映射。
5. 一旦所有驗證檢查都通過，請完成匯入。

問：匯入作業支援哪些工作專案類型？

答：測試案例匯入功能僅支援 測試案例 工作專案。

對於共用步驟：

• 現有共享步驟： 您可以通過在 CSV/XLSX 文件中包含其 ID 來引用現有共享步驟

• 新的共用步驟：匯入不會建立新的共用步驟。 您必須先使用網頁介面建立它們：

  1. 在 UI 中開啟測試案例。
  2. 選取 [建立共用步驟]。
  3. 建立後，請在匯入檔案中參考共用步驟 ID。

  

備註

如果您在相同的 CSV/XLSX 列中同時包含共用步驟參照和步驟詳細資料，則匯入會更新現有的共用步驟工作項目。 若要只參考共用步驟而不修改它們，請勿在匯入檔案中包含步驟詳細資料。

針對其他工作項目類型，例如使用者故事、工作或錯誤，請使用 Azure Boards 大量匯入功能。 如需詳細資訊，請參閱 批量匯入或更新（CSV）。

Q：匯入 CSV/XLSX 檔案的必填標頭是什麼？

答：在每個匯入檔案中包含下列標頭，並具有精確的拼字：

• 識別碼：測試案例的工作專案識別碼。 為新的測試用例保留空白;提供現有的 ID 以更新測試案例。
• 工作專案類型：必須是 '測試案例' 或 '共用步驟' （使用這些確切的關鍵字） 。
• 標題：測試案例名稱 （可以包含字母、數字及特殊字元）。
• 測試步驟：序列中每個測試步驟的訂單編號。
• 步驟動作：測試人員在此步驟中執行的動作。
• 預期步驟：完成動作後的預期結果。

Q：進出口操作有哪些限制？

答：匯入或匯出測試案例時，請考慮下列限制：

• 測試案例狀態：匯入期間，測試案例必須處於設計狀態
• 標題長度：測試案例標題不能超過 128 個字元
• 檔案大小：在匯入和匯出期間建立的 JSON 物件有 20 MB 的限制。 如果匯入失敗，請嘗試匯入較小的測試案例子集
• 許可權：您必須具有要匯入或匯出之測試計劃和測試套件的區域和反覆專案路徑的許可權
• 相關連結：如果測試案例有超過 1,000 個相關連結，則作業會失敗

後續步驟

執行手動測試

相關內容

• 建立測試計劃和測試套件
• 建立測試案例
• 測試案例之間的共享步驟
• 測試不同的組態
• 使用不同的數據重複測試
• 測試對象和詞語
• 根據建置和測試整合字段建立查詢