5. テストケースのインポート

本章では、テストケースのインポートについて記載します。 これまで外部ファイルで管理していたテストケースを TestRail で管理するには、テストケースをインポートする必要があります。

インポート可能なフォーマットは以下の通りです。

• • XML：TestRail 固有のフォーマットに対応した XML ファイルからテストケースをインポートできます。
    • 「既存テストケースの更新 (テストケースIDで紐づけ)」、「新規テストケースの追加」いずれかを選択します。
    • TestRail のテストケースを外部で編集後、再インポートする場合に適してます。
  • CSV：CSV ファイルに定義されたテストケースを TestRail の項目とマピングしてインポートできます。
    • インポートするテストケースは新規テストケースとして追加されます。(既存のテストケースの更新は出来ません。)
    • Excel 等で管理されているテストケースを TestRail にインポートする場合に使用します。

5-1. テストケーステンプレートを決定する

テストケースをインポートする前に、既存のテストケースをどのテンプレートでインポートするかを決める必要があります。

CSV インポートでは 1 度に 1 つのテンプレートしか指定できません。異なるテンプレートのテストケースをインポートする場合は、CSV ファイルを分けてインポートしてください。

5-1-1. Test Case (Text) テンプレート

Test Case (Text) は １つの前提条件、テスト手順、期待する結果、および実際の結果を入力する場合に使用します。

5-1-2. Test Case (Steps) テンプレート

Test Case (Steps) は １つのテストケース内で複数の手順、手順毎に期待される結果、および結果の入力をする場合に使用します。

結果を登録する時は、各手順毎の結果を登録することができます。

5-1-3. Exploratory Session テンプレート

探索的テストの実施に合わせてミッションとゴールを登録できます。探索的テストを実施する場合に使用します。

5-1-4. カスタムテンプレート

TestRail に用意されている 3 つのテンプレートとは別に、ユーザー独自のテストケーステンプレートを作成することも可能です。

詳細は、カスタマイズの テンプレート をご確認ください。

5-2. 既存のテスト項目から不足しているフィールド、項目値を洗い出す

TestRail 上に既存のテストケースの項目と対応するフィールドが存在しない場合は、インポート操作の前にカスタムフィールドを用意してください。

テストケースの ケースタイプ と 優先度 の各フィールドは、いくつかの項目値が TestRail にあらかじめ用意されています。インポートする既存のテストケースの項目値と合わない場合は、項目値をカスタマイズしてください。

カスタムフィールドの追加、ケースタイプと優先度の変更については、 カスタマイズ をご確認ください。

5-3. テストケースインポート (CSV)

Excel ファイル、Google Docs/Spreadsheets ファイルで管理しているテストケースを TestRail にインポートするには、CSV インポート を利用します。

なお、日本語文字列を含むテストケースをインポートする場合は、CSV ファイルのエンコーディングを UTF-8 としてください。Shift-JIS の場合、インポートする文字列が文字化けします。

5-3-1. Excel ファイルを CSV 形式に変更する

Excel の [ファイル] > [名前を付けて保存] でファイルの種類を [CSV (カンマ区切り) (*.csv)] を指定して保存します。

これにより、テストケースを CSV ファイルとして保存し、TestRail にインポートできます。

TestRail がテストケースを認識できるように、Excel シートのレイアウトを単純化する必要がある場合があります。テストケースごとに 1 行または複数行の単純なレイアウトを使用することをお勧めします。

5-3-2. Google Docs/Spreadsheets ファイルを CSV 形式に変更する

Google Docs/Spreadsheets の [File] > [Download] をクリックし、.csv を選択すると、データを CSV ファイルにエクスポートし、TestRail にインポートできます。

5-3-3. テストケースをインポートする

テストケースをインポートするプロジェクトの テストケース または テストスイートとケース タブを開きます。

画面上部のアイコンが並んだところから、CSV インポート を選択します。

ダイアログ画面で設定を進めていきます。

1/4 画面

インポートするファイル、インポート時のオプションを設定します。

ファイル (10MBまで)

フォーマットとマッピング

詳細オプション

2/4 画面

CSV ファイルの列名と TestRail のフィールドをマッピングします。

行レイアウト

マッピング

タイトルがないテストケース/レコードを無視する(例：ファイル末尾の空のレコード)

• • チェックボックスをチェックすると、CSV 内で「タイトル」が空値の行は、テストケースとして認識せず、スキップします。これにより、CSV ファイルの末尾の空白行を無視することができます。
  • 行レイアウトの 新規テストケースの検出に使用する列： で “タイトル” を選択している場合、テストケースが正しくインポートできなくなります。新規テストケースの検出に使用する列： の選択値を “タイトル” 以外にするか、このチェックボックスを外してください。

3/4画面

2/4画面においてマッピングした TestRail のフィールドが、プルダウン、リスト、ラジオボタンなどの、値を選択するタイプのフィールドだった場合、CSV の値と、 TestRail のフィールド値をマッピングします。

• • マッピングが必要な項目数分設定します。
  • TestRail 側に適した値が無い場合は、ケースフィールドをカスタマイズしてください。

例) 下の画面では、CSV ファイルの 重要度 フィールドと、TestRail の 優先度 フィールドの値をそれぞれマッピングしています。

4/4画面

インポートするテストケースのプレビューを確認します。最大で 5 件のテストケースプレビューが表示されます。

• • プレビューで表示される内容が意図した内容ではない場合、前へ ボタンで前の設定画面に戻り、設定を見直してください。
  • インポートされるテストケース数が、正しいことを確認してください。

5-3-4. Test Case(Steps) テンプレートのテストをインポートする場合の注意事項

Test Case(Steps) テンプレートにテストケースをインポートするには、一つのテストケースに対して “手順” と “期待される結果” を複数行に分割して用意してください。

インポート操作時に以下の点にご注意ください。

ファイルおよび設定のロード (1/4 画面)

“テンプレート” で 「Test Case(Steps)」 を選択する

列と行のレイアウトをマッピング (2/4 画面)

• • “行レイアウト” で 「テスト ケースは複数行を使用する」 を選択する
  • “新規テスト ケースの検出に使用する列:” で次のテストケースの行であることを判別するための列を選択する
    • 上の CSV ファイルの画像では「タイトル」を選択することで、2～4行目が1テストケース目、5～7行目が2テストケース目と判断されます。
  • “タイトルがないテスト ケース/レコードを無視する (例: ファイル末尾の空のレコード)” チェックボックスを OFF にする (「タイトル」を次のテストケースの判別に使っていない場合は OFF にしなくても結構です。)

5-4. テストケースインポート (XML)

TestRail の XML フォーマットに合わせたテストケースを XMLインポート でインポートすることができます。

5-4-1. XML フォーマット例

TestRail にインポート可能な XML のフォーマットはテストケーステンプレートごとに異なります。

デフォルトのテストケーステンプレートごとの XML フォーマット例です。

カスタムフィールドの利用状況によってはインポートエラーになる場合があります。後述する カスタムフィールドの取扱いについて をご確認ください。

TestCase (Text)

<?xml version="1.0" encoding="UTF-8"?>
<sections>
  <section>
    <!-- テストケースをインポートするセクションの名前 -->
    <name>テストケースセクション</name>
    <cases>
      <case>
        <!-- テストケース タイトル -->
        <title>XMLテストケースインポートの確認</title>
        <!-- テストケース テンプレート -->
        <template>Test Case (Text)</template>
        <!-- テストケース タイプ -->
        <type>Usability</type>
        <!-- テストケース 優先度 -->
        <priority>Medium</priority>
        <!-- テストケース 見積もり -->
        <estimate>6000</estimate>
        <!-- テストケース 参照 -->
        <references>REQ-1, REQ-2</references>
        <custom>
          <!-- テストケース Automation Type -->
          <automation_type>
            <id>0</id>
            <value> None</value>
          </automation_type>
          <!-- テストケース Preconditions -->
          <preconds>* インポートメニューからテストデータをアプリケーションに反映させる。</preconds>
          <!-- テストケース Steps -->
          <steps>1. テスト用文書を開く
2. テスト対象機能のダイアログを表示し、テストデータ用の設定を行う。</steps>
          <!-- テストケース Expected Result -->
          <expected>* テスト対象ブラウザのテスト用解像度にて画面のレイアウトが崩れないこと</expected>
        </custom>
      </case>
    </cases>
  </section>
</sections>

TestCase (Steps)

<?xml version="1.0" encoding="UTF-8"?>
    <sections>
      <section>
        <!-- テストケースをインポートするセクションの名前 -->
        <name>Step</name>
        <cases>
          <case>
            <id>C115076</id>
            <!-- テストケース タイトル -->
            <title>Stepsテストケースのインポート</title>
            <!-- テストケース テンプレート -->
            <template>Test Case (Steps)</template>
            <!-- テストケース タイプ -->
            <type>Other</type>
            <!-- テストケース 優先度 -->
            <priority>Medium</priority>
            <!-- テストケース 見積もり -->
            <estimate>4000</estimate>
            <!-- テストケース 参照 -->
            <references>DH-22</references>
            <custom>
              <!-- テストケース Automation Type -->
              <automation_type>
                <id>0</id>
                <value> None</value>
              </automation_type>
              <!-- テストケース Preconditions -->
              <preconds>* 最新のマニュアルを準備すること。</preconds>
              <!-- テストケース 複数の手順と期待する結果 -->
              <steps_separated>
                <!-- 1 件目 -->
                <step>
                  <index>1</index>
                  <content>テスト用文書を開く</content>
                  <expected>テスト用文書が開かれること</expected>
                </step>
                <!-- 2 件目 -->
                <step>
                  <index>2</index>
                  <content>テスト対象機能のダイアログを表示し、テストデータ用の設定を行う。</content>
                  <expected>表示されるダイアログで、データ設定項目が正しく表示されていること</expected>
                </step>
              </steps_separated>
            </custom>
          </case>
        </cases>
      </section>
    </sections>

Exploratory Session

<?xml version="1.0" encoding="UTF-8"?>
   <sections>
     <section>
       <!-- テストケースをインポートするセクションの名前 -->
       <name>探索的</name>
       <cases>
         <case>
           <!-- テストケース タイトル -->
           <title>探索的テストケースのインポート</title>
           <!-- テストケース テンプレート -->
           <template>Exploratory Session</template>
           <!-- テストケース タイプ -->
           <type>Other</type>
           <!-- テストケース 優先度 -->
           <priority>High</priority>
           <!-- テストケース 見積もり -->
           <estimate>3600</estimate>
           <!-- テストケース 参照 -->
           <references>DH-17</references>
           <custom>
             <!-- テストケース Automation Type -->
             <automation_type>
               <id>0</id>
               <value> None</value>
             </automation_type>
             <!-- テストケース Mission -->
             <mission>○○であることを確認する</mission>
             <!-- テストケース Goals -->
             <goals>システム内全ての画面(全XX画面)で確認が完了している</goals>
           </custom>
         </case>
       </cases>
     </section>
   </sections>

5-4-2. カスタムフィールドの取扱いについて

カスタム フィールドは、custom タグの下にグループ化され、XML 識別子/タグとして ([管理] > [カスタマイズ] で設定した) システム名を使用します。

インポート形式と動作の詳細は、実際のカスタムフィールドのタイプによって異なります。

次の表は、さまざまなカスタムフィールドタイプのインポート形式の一覧です。

ヒント

インポート機能とエクスポート機能は同じファイル形式を使用しています。

ご利用環境でカスタムフィールドを利用しているなど、XML フォーマットが複雑な場合は、既存のテストスイートのエクスポート機能を利用して XML フォーマットを確認したり、エクスポートしたファイルに、テストケースを定義すると便利です。

※インポートする時、TestRail に元々存在していたテストケースを再追加しないようにご注意ください。

5-5. リンク

• • 前の章：4. カスタマイズ
  • 次の章：6. 高度な設定
  • 関連マニュアル：カスタム フィールドの設定
  • 関連マニュアル：テスト ケースとセクションのインポート (Excel/CSV)
  • 関連マニュアル：テスト ケースとセクションのインポート (XML)