TestRail - 匯入測試用例 CSV

使用者可以使用 CSV 或 XML 檔案一次建立多個測試用例。CSV 檔案是逗號分隔的文字檔案。從 Excel 匯入資料需要兩個步驟。

• CSV 檔案規則
• 將檔案匯入系統

CSV 檔案規則

建立 CSV 檔案時，必須考慮以下幾點

• CSV 檔案應僅包含第一個工作表中的資料。

• 第 1 行應在不同的列中包含標題名稱，接下來的行應表示每一列。

• 請注意，匯入時，第 1 行將與測試用例表單的不同欄位進行對映。

• Excel 檔案中的一列只能與測試用例表單中的一個欄位進行對映。

• 必須將必填欄位與CSV 表格的列進行對映，並且不應為空。否則，系統將生成匯入失敗的錯誤訊息。

• 可選欄位可以不進行對映或資料可以為空。匯入時，這些欄位將為空或使用專案設定中定義的預設值。

匯入 CSV 檔案

• 轉到“測試用例”選項卡。

• 點選右側的匯入測試用例圖示，然後選擇“從 CSV 匯入”選項。以下螢幕截圖顯示了匯入測試用例圖示和 CSV 選擇

• “從 CSV 匯入”嚮導開啟。它包含 4 個步驟。

• 在第一步中，瀏覽 CSV 檔案並上傳。上傳成功後，檔名將顯示在嚮導中。

• 在“格式和對映”部分，選擇“為第一個檔案配置新的對映”。使用者可以在下次下載配置檔案後使用相同的配置。要使用此選項，請選擇“從配置檔案載入對映”。

• 在“高階選項”部分應進行以下選擇

  • 匯入 - 選擇應將測試用例匯入到的部分

  • 檔案編碼 - 用於選擇檔案的編碼規則，以便 TestRail 可以正確解碼檔案。CSV 檔案、Excel/Windows 使用Windows-1252（拉丁語）用於 CSV 檔案，而大多數其他工具（包括 Google Spreadsheets）更喜歡 Unicode 相容的 UTF-8 編碼。

  • CSV 分隔符 - 使用者可以定義 , 或 ; 或 \t 來分隔欄位。

  • 起始行 - 使用者可以將標題行和資料行分隔開，從哪裡開始。並且，可以使用複選框確定是否為標題行。

  • 模板 - 使用者可以選擇它是完整的測試用例、步驟還是探索性會話。

• 進行這些選擇後，點選“下一步”按鈕。以下螢幕截圖顯示了匯入測試用例過程的第一步

• 使用者可以簡單地將 CSV 列對映到 TestRail 的測試用例欄位。如果使用者對單個測試用例使用多行，TestRail 還支援匯入單獨的測試步驟和預期結果。這稱為列對映，可以在 CSV 匯入嚮導的第 2 步中配置。

• TestRail 區分 CSV 檔案的單行和多行用例佈局。在單行佈局中，每個測試用例都由 CSV 檔案中的一行或記錄表示。這是大多數 CSV 檔案的標準佈局。

• TestRail 支援多行佈局。在這種情況下，使用者選擇檢測新測試用例開始的列（例如，每個測試用例唯一的 ID 或名稱/標題列）。此佈局通常用於具有多個步驟和預期結果的測試用例。

• 最後，有一個複選框，指示 TestRail 是否應忽略沒有有效非空標題列的 CSV 行/記錄。建議選中此複選框，以篩選 CSV 檔案開頭/測試用例之間/結尾處的空行。

• 現在，點選“下一步”按鈕。以下螢幕截圖顯示了匯入測試用例過程的第二步

• 此步驟用於將 CSV 值對映到 TestRail。例如，如果使用者在 CSV 檔案中具有中等優先順序值，則此步驟允許將其對映到 TestRail 中的低或普通優先順序。在此步驟中，使用者可以選中複選框以避免將任何 HTML 標記作為匯入資料。

• 之後，點選“下一步”按鈕。以下螢幕截圖顯示了匯入測試用例過程的第三步

• 在第四步中，使用者可以檢視 TestRail 在 CSV 檔案中找到的測試用例。使用者還可以檢視檔案選項以及在先前步驟中配置的列和值對映。使用者可以使用“上一步”和“下一步”按鈕在檔案選項、列或值對映之間來回切換以進行更改。一旦使用者對預覽滿意，點選“匯入”按鈕。

• 最後一個嚮導步驟顯示匯入的章節和測試用例的數量。它允許下載配置檔案。此檔案可以在第一個嚮導步驟中載入，並自動預配置所有嚮導步驟和匯入選項。當使用相同佈局匯入多個 CSV 檔案時，這很有用。使用者也可以與其他團隊成員共享此配置檔案。