テストケースは、増えるほど「管理が難しくなる」のが悩みどころです。リリース先の地域や言語、稼働環境、想定ユーザーにより、入力値だけが異なるテストを行うために、都度ケースをコピーして作っていくと、気づけば同じシナリオが何十本にも分裂し、修正のたびに更新漏れや表記ゆれが発生してしまうことがあります。
さらに、仕様変更が重なったときには「テストケースが、いつ、誰の判断で変わったのか」を追えず、レビューや引き継ぎが属人化してしまいがちです。
そこで本記事では、テスト資産を“増やさずに広くカバーする”ためのテストケースのパラメータ化と、“変更箇所を分かりやすくする”ためのテストケースのバージョン管理を紹介します。
本記事は以下のような方におすすめです！
- 入力値だけ異なるテストケースが大量に増えている方
- 変更箇所の可視化によりテストケースのレビューを楽にしたい方
テストケースのパラメータ化とバージョン管理とは？（本記事の要約）
テストケースのパラメータ化は、テストケースの一部を変数化し、実行時にデータセットの値を挿入する機能です。入力値だけが異なる（国別・環境別など）同一手順のテストケースを複製せずに済み、修正箇所が減ることで効率的にテストケースをメンテナンスできます。
テストケースのバージョン管理は、テストケースの変更履歴を世代管理し、過去のバージョンへの復元や比較をする機能です。現在のテストケースと過去のテストケースを並べて比較できるため、テストケースを更新した際に差分が分かりやすい、誤入力があった場合も元のバージョンに戻せるなどのメリットがあります。
テストケースのパラメータ化とバージョン管理は、TestRail Enterprise限定の機能です。詳細は、以下のページをご参照ください。
テストケースのパラメータ化により期待できること
効果1: 類似のテストケースの削減とメンテナンス性の向上
例えば「配送先入力フォームの確認」を行うテストケースがあり、配送先の国によって入力ルールが異なる場合を想定します。パラメータ化をしない場合、「国が異なるだけ」「入力値の形式が異なるだけ」のテストでも、国ごとにテストケースを作成する必要が出てきます。そのため、配送先が日本、アメリカ、スペインの3か国の場合は、同じ「配送先入力フォームの確認」のテストケースが3件になります。
この状態だと、画面項目名の変更、手順の追加、期待する結果の修正などが入ったときに全ケースを横断して修正する必要があり、工数が増えるだけでなく、修正漏れにより「国によってテスト内容が微妙にズレる」問題が起きてしまうことがあります。
一方でパラメータ化しておけば、手順と観点（何を確かめるか）はテストケースに固定し、国別に変わる郵便番号や州、電話番号のような値の差分だけをデータセット側に分離できます。結果として、テストケースの修正が必要な場合は、テストケース1件の更新で済み、メンテナンス性が向上します。
効果2: 少ないテストケース数でのカバレッジ拡大と実行の柔軟性
パラメータ化を活用すると、同じテスト観点を「入力値のバリエーション」で広げられます。配送先入力なら、国別だけでも郵便番号の桁数・区切り記号・必須項目などが異なり、これをケースとして増やすとテストケースがどんどん増えていきます。
パラメータ化すると、テストケースは「配送先が登録できる」「郵便番号が不正なら弾かれる」のように観点ベースで整理し、国別・形式別のパターンはデータセットとして追加できます。
さらにテストラン（実施するテストのまとまり）作成時に「今回の配送対象は日本とアメリカだけ」「新規で配送先がスペインの場合も追加でテストする」といった切り替えができ、テストの実行計画が立てやすくなります。
結果として、テストケースを増やして管理が破綻するのを防ぎつつ、対象国追加や仕様変更にも素早く追従できるようになります。
テストケースのパラメータ化機能の使い方
パラメータ化機能の使い方を、以下の流れで説明します。
1. 権限の有効化
テストデータの管理を行うには、「テスト データおよび変数」の「追加/編集」、「削除」権限が必要です。「Admin」＞「ユーザーとロール」より適切なロールを選択し、権限を有効化して保存してください。
2. テストデータの用意
テストデータはプロジェクトごとに用意します。テストケース画面から 「テスト データの参照」ボタンをクリックします。
テストデータの管理画面が表示されます。「編集」をクリックします。
A列に変数名、B列以降にはデータセット名と値を入力します。今回は配送先を入力することを想定し、郵便番号と住所を変数にしています。
3. 変数を使ったテストケースの作成
作成した変数を使ってテストケースを作成します。テストケースの作成・編集画面の変数を入れたい箇所で変数ボタン（x）をクリックします。
変数一覧が表示されるため、適切なものを選択します。
「%」で囲まれた変数名が入力されます。
今回は下の画像のように変数を使ったテストケースを作成しました。
4. テストラン/テスト計画の作成
テストランの作成
テストデータを用いたテストランを作成するには、テストランの作成画面の「データセット」で適切なものを選択します。今回は「Spain」を選択します。
作成されたテストランのテストを見ると、変数が「Spain」の値に置き換わっています。
変数は緑色の文字で表示され、マウスオーバーすると「Variable: 変数名」と表示されるため、どの変数が利用されたのかを確認できます。
テスト計画の作成
テスト計画を利用すると、データセットごとに複数のテストランを作成できます。例えば、複数の国を配送対象とし、国ごとにテストランを作成する場合は、配送先ごとにデータセットを選択します。
テスト計画の作成画面で、各テストランの「説明、参照およびデータ」の「変更」をクリックします。
該当のデータセットを選択します。
選択したデータセットの値が、各テストランのテストに反映されます。
このように、テストケースのパラメータ化は、国別・環境別など「入力値だけが異なる」同一シナリオで特に効果的です。テスト手順と観点は1件のテストケースに集約し、郵便番号や住所などの差分はデータセットに切り出せるため、重複するケースの削減とメンテナンス負荷の低減につながります。
また、テストラン/テスト計画でデータセットを切り替えるだけで対象条件を変えられるので、配送国追加や要件変更があっても、少ないケース数のままカバレッジを広げて柔軟に運用できます。
テストケースのバージョン管理により期待できること
効果1: 変更箇所の可視化によるテストケースの品質向上
任意の2つのバージョンを並べて差分を確認でき、変更点がハイライトされるため、意図しない修正や抜け漏れを早期に発見できます。これにより、テストケースのレビューがしやすくなり、テストケースの品質の向上につながります。
効果2: 手戻り削減と運用効率の向上
過去のバージョンへ丸ごと復元、または特定フィールドのみ復元できるため、誤編集や表記揺れが起きても迅速に正常状態へ戻せます。
テストケースのバージョン管理機能の使い方
テストケースの「履歴」画面で「比較対象」を選択します。
下の図のように、現在のテストケースと指定したバージョンのテストケースを左右に並べて比較できます。差分がある項目は赤文字で表示されるため、更新箇所が一目で分かり、レビューがしやすくなります。
特定のバージョンに戻したい場合は、「復元」をクリックし、確認メッセージに同意します。
一部のフィールドの値だけ復元し、他のフィールドはそのままにしたい場合は、復元したいフィールドにチェックを入れてから「復元」をクリックします。
テストケースのバージョン管理は、テストケースの承認機能と併用すると効果的です。承認機能を使うと、テストケースに「設計」「レビュー」「使用可」などのステータスを設定し、承認権限を持つレビュアーを担当者に割り当ててレビュー依頼ができます。レビューを経て「使用可」となったテストケースのみをテスト対象とすることで、テストケースの品質担保につながります。詳しくは以下のページをご参照ください。
まとめ
本記事では、TestRailのパラメータ化とバージョン管理についてご紹介しました。2つの機能を活用すると、テストに関わるメンバーは以下のメリットを享受できます。
- テストケースの設計者
- パラメータ化で「値だけ異なる」テストケースの複製を減らし、1本に集約できる。
- パラメータ化により、手順・期待結果などの修正が1か所で済み、更新漏れや表記ゆれを防げる。
- レビュアー
- バージョン比較により変更点が可視化され、レビューを早く、漏れなく進めやすい。
- テストマネージャー/リーダー
- 類似のテストケースの増殖を抑え、資産管理と保守コストを最適化できる。
- データセット切替でテスト対象の範囲を柔軟に調整でき、計画変更に強くなる。
ぜひ活用をご検討ください。
関連する製品
テスト管理ツール TestRail
テストケースの管理やテスト結果の記録、チームでの情報共有など、Excelを使ったテスト管理の業務に限界を感じていませんか？TestRailはシンプルで使いやすいUIを提供し、テストにかかるさまざまな管理コストの削減に貢献します。
■ TestRailの特長 ■
- テストにさまざまな情報を関連づけて一元管理
- Webブラウザー上でテストケースを簡単に入力や編集可能
- テスト実施の準備と結果の共有が容易
- 進捗や比較などのレポートを提供
- 要件 / 課題管理ツールやテスト自動化ツールと連携
日本国内では、テスト管理にExcelを使っていたお客さまからの乗り換えが多く、Web上で完結するテスト管理を実現されています。
TestRail でテスト管理のお悩みを解決しませんか？
