Zephyr Squad からの移行

セクションの内容

このセクションでは、Zephyr Squad から TestRail にインポートできるテスト情報の種類、Zephyr Squad からデータをエクスポートする方法、データを準備して TestRail にインポートする手順を説明します。また、インポートできるデータとできないデータ、TestRail にデータをインポートできない場合の回避策についても説明します。

- Zephyr Squad 移行のサンプルファイル

エクスポート/インポートのサンプルファイルとして、この添付ファイルをダウンロードします。

機能と制限事項

TestRail は、ヘッダーフィールドやテンプレートフィールド、個別のテスト手順やカスタムフィールドなども含めたすべてのサポート対象フィールドを CSV 経由でインポートできます。

下の表は、CSV 経由でテストケースをインポートする場合にサポートされるデータと、制限事項を挙げたものです。TestRail は個々のテスト手順へのカスタムフィールドの追加をサポートしていませんが、それらのデータが失われることがないよう、「追加の手順情報」フィールドに値をインポートする方法を説明します。

サポート対象	制限事項
デフォルトフィールドカスタムフィールド事前条件テスト手順個別のテスト手順	添付ファイル – Zephyr には添付ファイルを一括でエクスポートする仕組みがありません。 BDD シナリオ – Zephyr は BDD シナリオの詳細をエクスポートしません。個別のテスト手順のカスタムフィールド – 下の回避策を参照してください。

カスタムフィールドがあるテストケースを Zephyr Squad から TestRail にインポートするには、まず、対応するカスタムフィールドを TestRail に作成する必要があります。

Zephyr Squad からのテストケースデータのエクスポート

Zephyr Squad の [Test Cases] 検索画面から、テストケースを Excel 形式でエクスポートできます。エクスポート対象のすべてのテストケースを選択し、[Export Test Cases] > [Export to Excel] をクリックします。Excel ファイルのエクスポートとローカルマシンへのダウンロードが開始されます。このファイルを使用して、TestRail にテストケースデータをインポートできます。

ダウンロードが完了すると、次のような構造を含むファイルが作成されます。

テストケースデータの処理

上で触れたとおり、TestRail は Zephyr Squad のような個別のテスト手順でのカスタムフィールドをサポートしていません。カスタム手順フィールドを使用している場合、フィールドのデータが失われないよう、下の表のようにカスタム手順フィールドのデータをマッピングすることを推奨します。

Zephyr Squad のフィールド	Zephyr Squad の Excel 列	TestRail のフィールド
TestStep	TestStep	Steps(Step)
Test Result	Test Result	Steps(Expected Result)
Test Data Custom Step Field 1 Custom Step Field 2 (…)	ADDITIONAL INFO	Steps(Additional Info)

前のステップでエクスポートした Excel ファイルには、“Custom Test Step Field 1” というフィールドがあります。このデータを保持し、下の表のマッピングにしたがってインポートするには、この列の値を “Test Data” 列およびその他のカスタムフィールドの情報とマージして新しい列に入力するとよいでしょう。それには、“ADDITIONAL INFO” という新しい列を作成し、下の図のような数式を使用して元の列タイトルおよび値でデータをマージするか、独自の数式を作成して最適な方法でデータをフォーマットします。

この作業が終わり、その他に必要な Excel ファイルへの変更が終わったら、後は TestRail にテストケースをインポートできるよう、Excel ファイルを CSV ファイルとして保存するだけです。

TestRail へのテストケースデータのインポート

TestRail へのテストケースデータのインポートは非常に簡単です。テストケースをインポートするプロジェクトに移動し、次の手順を行うだけです。

1. [テストケース] ページに移動します。
2. ページ上部の [ケースのインポート] アイコンをクリックし、[CSV からインポート] を選択します。
3. インポートダイアログの最初のページで次の操作を行います。
  1. インポート対象の CSV ファイルを選択します。
  2. インポート先のセクションを選択します。
  3. [CSV 区切り文字] でカンマ (またはファイル保存時に使用した区切り文字) を選択します。
  4. [開始行] に 1 を設定します。
  5. [テンプレート] に Test Case (Steps) を設定します。
  6. [次へ] をクリックします。
4. インポートダイアログの 2 ページ目で次の操作を行います。
  1. [行レイアウト] に [テストケースは複数行を使用する] を設定します。
  2. CSV の列を TestRail のフィールドにマッピングします (下の簡単な例を参照)。
  3. [タイトルがないテストケース/レコードを無視する] オプションをオンにします。
  4. [次へ] をクリックします。注意: Zephyr のテストケースにカスタムフィールドがなく、Excel ファイルに “Additional info” 列を作成していない場合、単に “Test Data” を “Steps(Additional Info)” にマッピングします。
5. インポートダイアログの 3 ページ目で次の操作を行います。
  1. すべてのフィールドで [CSV の値から HTML タグを除去] をオンにします。
  2. [次へ] をクリックします。
6. インポートダイアログの最後のページで次の操作を行います。
  1. 期待どおりに情報が処理されたことを確認します。
  2. [インポート] をクリックします。