Xray からの移行（Server および Datacenter）

セクションの内容

このドキュメントでは、Xray (Server および Datacenter) から TestRail にインポートできるテスト情報の種類、Xray からデータをエクスポートするプロセス、データを準備し TestRail にインポートするために必要な手順について説明します。また、インポートできるデータとできないデータ、TestRail にデータをインポートできない場合の回避策についても説明します。

機能と制限事項

TestRail は、ヘッダーフィールドやテンプレートフィールド、個別のテスト手順やカスタムフィールドなども含めたすべてのサポート対象フィールドとともに CSV 経由でテストケースをインポートできます。下の表は、CSV 経由でテストケースをインポートする場合にサポートされるデータおよび制限事項を挙げたものです。

サポート対象	制限事項
デフォルトフィールドカスタムフィールド事前条件個別のテスト手順	添付ファイル – TestRail の CSV インポートは添付ファイルをサポートしていません。

カスタムフィールドを持つテストケースを Xray から TestRail にインポートする場合、インポート処理の前に、対応するカスタムフィールドを TestRail に作成する必要があります。

※このチュートリアルでは、Manual タイプの Xray テストを移行する方法だけを説明します。

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

Xray データのエクスポートのレイアウトおよびフォーマットを完全に制御するには、Xray Document Generatorを使用します。この機能により、独自のカスタムテンプレートを作成し、Jira データ (主に Xray no課題、要件、欠陥) を反映したドキュメントを生成できます。

Xray から TestRail にインポート可能な形式でテストケースをエクスポートするために、以下の手順を説明します。

- Xray Document Generator を使用して新しいテンプレートを作成する
- 新しいテンプレートを使用して Xray からテストケースをエクスポートする

Xray Document Generator を使用して新しいテンプレートを作成する

- テストのエクスポート元プロジェクトに移動します。
- [Project Settings] に移動します。
- 左側のナビゲーションパネルにある [Document Generator] リンクをクリックします。
- [Add] ボタンをクリックします。
- [Create Template] 画面で以下の情報を入力します。
  - Name: 名前フィールドは、テンプレートストアでテンプレートを保存するために使用されます。この名前は、データをエクスポートする際にテンプレートの選択ドロップダウンに表示される名前でもあります。このチュートリアルでは、TestRailMigrationTemplate という名前を使用します。
  - Scopes: スコープは、新しく作成されたテンプレートにアクセスできる Jira 内の特定の領域またはセクションを指します。今回の場合、[Issue Navigator] および [Issue Details] でテンプレートにアクセスする必要があります。
  - Entities: テンプレートがアクセスできる Jira エンティティです。このチュートリアルでは、Xray から TestRail にテストをエクスポートすることが目的であるので、Test エンティティに制限します。
  - Upload File: エクスポートテンプレートコンフィギュレーションを含むファイルです。TestRail と互換性のある形式でテストケースをエクスポートするには、 XrayTestReportTestRail.xlsx テンプレートファイルを使用します。
  - Output Formats / Default Output Formats: ファイルをアップロードすると、これらのフィールドがテンプレート設定に従って自動的に XLSXに設定されます。
- [Create] ボタンをクリックすると、新しいテンプレートが Document Generator の下に表示されます。

新しいテンプレートを使用して Xray からテストケースをエクスポートする

- Jira の課題ナビゲーターで、フィルターを使用してエクスポート対象のテストケースを検索します。以下の条件を指定することを推奨します。
  - 対象のプロジェクトでフィルタリングします。
  - issueetype には Test を指定します。
  - Test Type には Manual を指定する必要があります。
- Export ボタンをクリックし、 Doc Generator を選択します。
- [Xray – Document Generator] ダイアログで [Template] として [TestRailMigrationReport] を、[Output Format] として [XLSX] を選択し、[Export] ボタンをクリックします。
- issues.xlsx のような XLSX ファイルが生成されるはずです。
- TestRail のインポートウィザードと互換性がある CSV 形式で XLSX ファイルを保存します。

テストケースを TestRail にインポートする

すべてのテンプレートに共通するフィールドは、下の表に従って TestRail のフィールドにマッピングできます。デフォルトでは TestRail に存在しないフィールドについては、マッピング先として新しくカスタムフィールドを作成できます。

Xray Excel の列	TestRail のフィールド
Summary	タイトル
アクション	手順(手順)
Data	手順 (追加の手順)
Expected Result	手順(期待される結果)
Precondition	事前条件
Component	カスタムフィールド
説明	カスタムフィールド

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

- [テストケース] ページに移動します。
- ページ上部の [ケースのインポート] アイコンをクリックし、[CSV からインポート] を選択します。
- インポートダイアログの最初のページで次の操作を行います。
  - インポート対象の CSV ファイルを選択します。
  - インポート先のセクションを選択します。
  - ファイルエンコーディングとして Windows-1252(Latin)-Excel default を選択します。これは、Excelが使用するデフォルトのファイルエンコーディングです。(日本語文字列を含むテストケースをインポートする場合は、UTF-8 エンコーディング)
  - [CSV 区切り文字] でカンマ (またはファイル保存時に使用した区切り文字) を選択します。
  - [開始行] に 1 を設定します。
  - インポートする Excelシートにヘッダー行が含まれているため、[ヘッダー行] チェックボックスをオンにします。
  - [テンプレート] に Test Case (Steps) を設定します。
- [次へ] をクリックします。
- インポートダイアログの 2 ページ目で次の操作を行います。
  - [行レイアウト] に [テストケースは複数行を使用する] を設定します。
  - [新規テストケースの検出に使用する列] に [サマリー] を設定します。つまり、含まれているさまざまなサマリーに基づいて新しいテストケースが検出されます。
  - CSV の列を TestRail のフィールドにマッピングします (下の図の簡単な例を参照)。
  - [タイトルがないテストケース/レコードを無視する] オプションをオンにします。
  - [次へ] をクリックします。
- インポートダイアログの 3 ページ目で次の操作を行います。
  - すべてのフィールドで [CSV の値から HTML タグを除去] をオンにします。
  - [次へ] をクリックします。
- インポートダイアログの最後のページで次の操作を行います。
  - 期待どおりに情報が処理されたことを確認します。
- [インポート] をクリックします。
- インポートが完了すると、次の画面ショットのような確認ダイアログが表示されます。