「画面キャプチャを残したのに、何を確認したか分からないと言われた」
「エビデンスが多すぎて、結果を探すのに時間がかかる」
テストエビデンスは、テストを実施した証拠であると同時に、期待結果と実際結果を比較して合否を説明するための記録です。
画面キャプチャが一枚あるだけでは、どの環境、利用者、入力値、事前データで実施したかが分からない場合があります。反対に、操作ごとに大量の画像を残すと、重要な判定箇所が埋もれます。
品質管理や顧客確認では、実施者以外が後から見ても、条件、操作、結果、判定根拠をたどれることが重要です。テストを再現できる情報と、合否に必要な証跡を絞って残します。
この記事では、伝わるエビデンスの構成、取得タイミング、ファイル管理、レビュー方法を解説します。
良いエビデンスは「条件・操作・結果・判定」をつなぐ
エビデンスの量ではなく、テストケースと証跡の対応が明確であることが大切です。何を証明する画像・ログ・DB結果なのかを示します。
個人情報、認証情報、本番データが含まれる場合は、マスキング、保存場所、閲覧権限、保管期間のルールを守ります。
| 要素 | 記録する内容 | 証跡例 |
|---|---|---|
| 条件 | 環境・版・利用者・権限・事前データ | ヘッダー、ケース票 |
| 操作 | 入力値と実施手順 | 入力画面、操作ログ |
| 結果 | 画面・DB・ログ・連携 | 結果画面、SELECT、ログ抜粋 |
| 判定 | 期待結果との比較と合否 | OK／NG、差異説明 |
| 追跡 | ケース・不具合・ファイルの対応 | ケースNo.、チケットNo. |
伝わるエビデンスを残す4ステップ
1．ケースごとに証明する内容を決める
テスト実施前に、期待結果のどの部分を、画面、DB、ログ、外部連携のどれで確認するか決めます。取得後に考えると、必要な時刻や処理前データを取り逃すことがあります。
一つのケースで複数の期待結果がある場合は、証跡ごとに対応を示します。
2．環境・版・日時・ケース番号を入れる
画像だけでは環境や実施日時が分からないため、ケース票やエビデンスのヘッダーに共通情報を記載します。デプロイ版やデータ版も必要に応じて残します。
PCの時計だけに頼らず、ログ時刻やシステム表示と関連付けます。
- テスト環境・接続先
- アプリ・モジュールの版
- 実施日時
- 実施者・確認者
- ケース番号
- 利用者・権限
- 事前データ・入力値
3．合否に必要な範囲を読みやすく残す
画面はタイトル、対象データ、結果メッセージが分かる範囲を取得します。DB結果はSQL、対象条件、件数、主要列が分かるようにします。ログは対象時刻と識別子、結果行の前後を残します。
強調枠や注記を使う場合は、原本の値を隠さないようにします。画像を加工しすぎると証跡性が下がります。
ケースNo.：T-015 期待結果：上限超過時にE1234を表示し、取引データを登録しない 証跡1：入力値とE1234が分かる画面 証跡2：対象取引が0件である事後SELECT 証跡3：外部送信が行われていないログ 判定：すべて期待結果と一致しOK
4．命名・保存・レビューを統一する
ファイル名にケース番号、連番、結果を含め、テスト仕様書からすぐ開ける構成にします。個人のデスクトップだけに置かず、指定された共有場所へ保存します。
レビューでは、実施者以外がエビデンスだけで合否を判断できるかを確認します。不鮮明、対象不明、結果不足があれば再取得します。
テストエビデンス管理テンプレート
ケースとエビデンスファイルの対応を一覧化します。
【共通情報】 環境・版： 実施日時： 実施者・確認者： 【ケース】 ケースNo.： 確認目的： 事前条件： 入力値・操作： 期待結果： 実際結果： 判定： 【エビデンス】 No.／ファイル名／証明する内容／取得時刻／機密情報確認 【不具合】 チケットNo.： 再テスト証跡：
スクリーンショットの自動取得やログ収集を使う場合も、ケースとの対応と判定根拠が分かるように設計します。
よくある失敗と改善方法
| 失敗 | 起こる問題 | 改善方法 |
|---|---|---|
| 画像だけを保存する | 条件と確認目的が分からない | ケース情報と対応付ける |
| 操作ごとに大量保存する | 判定箇所が埋もれる | 期待結果を証明する証跡へ絞る |
| 機密情報をそのまま共有する | 情報漏えいにつながる | マスキングとアクセス制御を行う |
若手SE向けチェックリスト
- ケースごとに証明する内容を決めた
- 環境・版・日時・ケース番号を記録した
- 事前条件と入力値が分かる
- 期待結果と実際結果を比較できる
- 画面・DB・ログ・連携の必要証跡がある
- ファイル名と保存場所を統一した
- 機密情報と第三者レビューを確認した
まとめ：エビデンスは実施者以外が判断できる形で残す
良いテストエビデンスは、画像の多さではなく、テスト条件と結果、判定根拠が短時間で分かるものです。
取得する証跡をテスト前に決め、ケース番号と対応付けるだけでも、レビューと後日の調査が大きく楽になります。
- 条件・操作・結果・判定をつなげる
- 期待結果を証明する証跡へ絞る
- 命名・保存・機密情報管理を統一する
コメント