Testrail-import-testcases-csv
提供：Dev Guides
TestRail-TestCases CSVのインポート
ユーザーは、CSVまたはXMLファイルを使用して、一度に複数のテストケースを作成できます。 CSVファイルはコンマ区切りのテキストファイルです。 Excelからデータをインポートするには、プロセスに必要な2つのステップがあります。
- CSVファイルのルール
- ファイルをシステムにインポートします
CSVファイルのルール
次の点を考慮する必要があるCSVファイルを作成するとき
- CSVファイルには、最初のシートにのみデータが含まれている必要があります。
- 1 ^ st ^行には異なる列にヘッダー名があり、次のデータは各列を表す必要があります。
- インポート中に1 ^ st ^行がテストケースフォームの異なるフィールドにマッピングされることに注意してください。
- Excelファイルの1列は、テストケースフォームの1フィールドのみにマッピングできます。
- 必須フィールドは* CSVシート*の列にマッピングする必要があり、空白にしないでください。 そうしないと、システムはインポートに失敗したというエラーメッセージを生成します。
- 必須でないフィールドはマッピングせずに残すか、データを空白にすることができます。 インポート中、これらのフィールドは空白になるか、プロジェクトの設定で定義されているデフォルト値になります。
CSVファイルをインポート
- [テストケース]タブに移動します。
- 右側のテストケースのインポートアイコンをクリックして、CSVからインポートオプションを選択します。 次のスクリーンショットは、テストケースのインポートアイコンとCSVの選択を示しています
- CSVからのインポートウィザードが開きます。 4段階のプロセスがあります。
- 1 ^ st ^ステップで、CSVファイルを参照してアップロードします。 アップロードに成功すると、ウィザードにファイル名が表示されます。
- [形式とマッピング]セクションで、[1 ^ st ^ファイルの新しいマッピングを構成する]を選択します。 ユーザーは、構成ファイルをダウンロードした後、次回から同じ構成を使用できます。 このオプションを使用するには、構成ファイルからマッピングをロードを選択します。
- [詳細オプション]セクションで次の選択を行う必要があります
- インポート-テストケースをインポートするセクションを選択します
- ファイルエンコーディング-TestRailがファイルを適切にデコードできるように、ファイルのエンコーディングルールを選択するために使用されます。 CSVファイルのファイルエンコーディングであるExcel/WindowsはCSVファイルに_Windows-1252（ラテン）_を使用しますが、他のほとんどのツール（Googleスプレッドシートを含む）はUnicode互換のUTF-8エンコーディングを好みます。
- CSV Delimiter -ユーザーが定義できる、または;または\ tでフィールドを区切ります。
- 開始行-ユーザーは、開始位置からヘッダー行とデータ行を分離できます。 また、チェックボックスを使用して、ISヘッダー行かどうかを決定できます。
- テンプレート-ユーザーは、完全なテストケース、ステップ、または探索セッションのいずれかを選択できます。
- これらを選択したら、[次へ]ボタンをクリックします。 次のスクリーンショットは、テストケースのインポートプロセスの1 ^ st ^ステップを示しています
- ユーザーは、CSV列をTestRailのテストケースフィールドに簡単にマッピングできます。 TestRailは、ユーザーが単一のテストケースで複数の行を使用する場合、個別のテストステップと期待される結果のインポートもサポートします。 これは列マッピングと呼ばれ、CSVインポートウィザードのステップ2で構成できます。
- TestRailは、CSVファイルの単一行と複数行のケースレイアウトを区別します。 単一行レイアウトでは、すべてのテストケースはCSVファイルの単一行またはレコードで表されます。 これは、ほとんどのCSVファイルの標準レイアウトです。
- TestRailは*複数行*レイアウトをサポートします。 この場合、ユーザーは新しいテストケースの開始を検出する列を選択します（たとえば、テストケースごとに一意のIDまたは名前/タイトル列）。 このレイアウトは、複数のステップと期待される結果を伴うテストケースで一般的に使用されます。
- 最後に、TestRailが有効で空でないタイトル列のないCSV行/レコードを無視するかどうかのチェックボックスがあります。 CSVファイルの開始/テストケース間/終了で空の行をフィルタリングするには、チェックボックスをオンにすることをお勧めします。
- 次に、[次へ]ボタンをクリックします。 次のスクリーンショットは、テストケースのインポートプロセスの2 ^ nd ^ステップを示しています
- この手順では、CSV値をTestRailにマップします。 たとえば、ユーザーがCSVファイルで Medium の優先度値を持っている場合、このステップにより、これをTestRailで_Low_または Normal の優先度にマッピングできます。 このステップでは、ユーザーはチェックボックスをチェックして、インポートされたデータとしてのHTMLタグを回避できます。
- その後、「次へ」ボタンをクリックします。 次のスクリーンショットは、テストケースのインポートプロセスの3 ^ rd ^ステップを表示します
- 4番目のステップでは、TestRailがCSVファイルで検出したテストケースを確認できます。 ユーザーは、ファイルオプションと、前の手順で構成された column＆value マッピングを確認できます。 ユーザーは、[前へ]ボタンと[次へ]ボタンを使用して、ファイルオプション、列、または値のマッピングを変更できます。 ユーザーがプレビューに満足したら、[インポート]ボタンをクリックします。
- ウィザードの最後のステップには、インポートされたセクションとテストケースの数が表示されます。 構成ファイルをダウンロードできます。 このファイルは最初のウィザードステップでロードでき、すべてのウィザードステップとインポートオプションを自動的に事前設定します。 これは、同じレイアウトで複数のCSVファイルをインポートする場合に便利です。 ユーザーは、この構成ファイルを他のチームメンバーと共有することもできます。
