Xray (Cloud) からの移行

セクションの内容

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

機能と制限事項

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

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

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

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

Xray (クラウド) からのテストケースデータのエクスポート

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

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

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

Xray (Cloud) で新しいテンプレートを作成する

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

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

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

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

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

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

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

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