QAテスト手順をスクリーンショットで記録する方法

このガイドでは、QAテストの実行に必要なスクリーンショットの証拠を集める方法を説明します。テストの目的を決め、前提条件とテストデータを記録し、確認できる手順を書きます。その後、証拠を撮影して結果を判定し、実行記録を完成させます。

要点: QA記録では、計画した各操作を期待結果と結び付け、その実行時に集めた証拠によって最終的なPass、Fail、Blockedの判定を裏付けます。

1つのテスト目的を決める

テスト目的には、確認する動作と成功条件を書きます。1つの記録を1つの結果に絞ると、失敗したときに製品のどの部分に問題があるか判断しやすくなります。

たとえば「FreeユーザーがAction CaptureのDocumentをPNGで書き出せることを確認する」ならテストできます。「Action Captureの書き出しをテストする」では、複数の形式、プラン状態、失敗経路が混ざるため、別々のケースに分けてください。

繰り返し実行するテストには、固定のテストケースIDを付けます。タイトルは後から編集されることがありますが、IDがあれば今後の実行、回帰テスト、不具合報告を同じケースに結び付けられます。

前提条件とテストデータを記録する

前提条件を残すと、同じ実行を再現できます。製品バージョン、OS、プランまたはアカウント状態、権限、機能フラグ、準備済みのDocument、手順1の前に必要なデータを一覧にしてください。

「有効な情報を入力する」のような曖昧な指示ではなく、正確なテストデータを使います。認証情報や顧客記録が見える可能性がある値は、安全なテスト用データに置き換え、その入手先を担当者向けに記載してください。

簡潔な準備情報は、次のように書けます。

環境：macOS 15.5、Shotomatic 1.8.2
アカウント状態：Free
権限：Screen Recordingを許可済み
テストデータ：3ページのAction Capture Document
開始画面：Documentエディタ、1ページ目を選択

操作と期待するチェックポイントを書く

各手順では、1つの操作と、担当者が確認する結果を組み合わせます。すべての判定を最後まで先送りせず、その場で確認できるようにするためです。

指示は直接的に書きます。

1. Exportメニューを開く。期待結果：PNGとJPGが表示される。
2. PNGを選ぶ。期待結果：保存ダイアログが開く。
3. テスト用フォルダを選んで保存する。期待結果：ページごとに1つのPNGファイルが作成される。
4. 書き出したファイルを開く。期待結果：ページがDocumentの順序どおりに並び、エディタの内容と一致する。

複数の操作を1つの手順にまとめないでください。まとめた手順が失敗すると、どの操作が原因だったのか分からなくなります。

役立つチェックポイントで証拠を撮る

役立つ証拠とは、テスト判定に関わる状態を示すものです。開始時の設定、プランによって変わる選択肢、最終出力、予期しない結果を撮影します。

クリックするたびにスクリーンショットを撮る必要はありません。利用できる形式を確認するテストならメニューを開いた画面は証拠になりますが、通常のフォルダを選ぶ画面は何も補足しないことがあります。

UI上の手順をたどるテストでは、Action Captureでクリックごとの流れを収集できます。撮影後にページを確認し、テスト結果を裏付ける状態だけを残してください。Freeのセッションでは5ステップまで保存でき、すべてのDocument書き出し形式を利用できます。Proではステップ数の制限がなくなり、Blur、Click Marker、Step Numbersが加わります。

実際の結果を書き換えない

実際の結果には、この実行で起きたことを書きます。失敗に合わせて期待結果を変えないでください。予定した手順を途中で変更した場合は、その変更を記録します。

判定は次の3つから選びます。

• Pass: 必須の結果がすべて期待どおりだった。
• Fail: 必須の結果が1つ以上、期待と一致しなかった。
• Blocked: 前提条件または別の不具合に妨げられ、判定まで進めなかった。

テストが失敗したら、期待と最初に食い違ったチェックポイントを書き、別のバグ報告へリンクします。バグ報告には、短くした再現手順、環境、発生頻度、診断用の証拠をまとめられるため、再利用するテストケースが複雑になりません。

このQA実行記録を使う

次の構成なら、再利用するテスト定義と、1回分の実行結果を分けて記録できます。

テストケースID：
目的：

環境：
前提条件：
テストデータ：

手順と期待結果：
1. 操作：
   期待結果：
2. 操作：
   期待結果：

実行日：
テスト担当者：
テスト対象ビルド：

実際の結果：
判定：Pass / Fail / Blocked
証拠：
関連する不具合：
補足または手順変更：

この構成は、現在使っているQAシステムへコピーできる文書用のひな型です。Shotomaticにプロジェクトテンプレートとして読み込む機能はありません。

証拠を確認して承認する

最後に、証拠が記載した実行時のものか確認します。別の人がリリース承認に使う前に、ビルド、アカウント状態、日付、ページ順、書き出した結果を確かめてください。

重複するスクリーンショットを削除し、非公開のテストデータを保護します。ファイルをテスト管理システムとは別に保存する場合は、ファイル名またはページタイトルをテストケースIDに結び付けてください。記録を共有する前に、最終確認と読者目線での通読を行います。

レビュー担当者が、何をテストしたかを把握し、同じ準備を再現し、期待結果と実際の結果を比較して、最終判定を理解できれば、QA記録は完成です。Action Captureを使うと、クリックに沿ったテスト手順を収集できます。計画したテストではなく、すでに見つかった問題の証拠を残す場合は、Macでバグをステップ形式のスクリーンショットに記録する方法をご覧ください。