メインコンテンツにスキップ

バグレポートの添付ファイル

バグレポートを提出する際には、どのような添付ファイルが必要ですか?

対応者:Nikola Jonic

すべてのバグは、少なくとも1つの添付ファイルで記録する必要があります。添付ファイルは、そのバグがあなたのデバイス、オペレーティングシステム、および/またはブラウザで発生していることを示す証拠となります。

注: 添付ファイルは、バグレポート内の文章による説明の代わりにはなりません。添付ファイルは問題を視覚的に示し、そのバグが発生していることを証明するためのものです。

スクリーンショットとスクリーンキャスト、どちらを使用すべきですか?

一般的に、機能バグはスクリーンキャストを使用した方が、より適切かつ効果的に説明できます。テスト指示または Team Leader から特定の添付ファイルについて指示がない限り、スクリーンショットとスクリーンキャストのどちらが必要かは、次の目安に従って判断してください。

  • バグを発生させるために操作が必要な場合、または一連の操作を示す必要がある場合は、スクリーンキャストをアップロードしてください。静止画であるスクリーンショットでは、根本的な原因を示すことはできません。そのため、機能バグには必ずスクリーンキャストが必要です。

  • バグの性質が静的なものである場合(例:静的なGUIの問題)は、スクリーンショットで十分であり、動画よりも適した表現方法です。コンテンツバグやビジュアルバグでは、通常、スクリーンショットで十分です。

添付ファイルの一般要件

  • 新しい添付ファイルは、バグレポートまたは再現確認ごとに新しく作成する必要があります。

  • 他のバグレポートまたは再現確認から添付ファイルをコピーすることは禁止されています。

  • 添付ファイルには、証拠として必要なすべての関連情報が表示されていなければなりません。

  • すべての添付ファイルは、テストサイクルで指定された言語で作成する必要があります。必要に応じて、スクリーンショットやスクリーンキャストを撮影する前に、デバイスおよび/またはブラウザの言語を変更してください。例えば、テストサイクルの言語が英語(多くの場合そうです)の場合は、スクリーンショット、スクリーンキャスト、システム情報、およびデバイス設定も英語で表示されている必要があります。

  • バグを報告する際は、デバイスまたはブラウザを1つだけ選択し、そのデバイスまたはブラウザの添付ファイルのみをアップロードしてください。他のデバイスやブラウザでもバグを再現できる場合は、その内容を Actual Result に記載してください。

  • Test IO に関連する他のお客様の情報(例:招待メールやブラウザタブ名など)は表示しないでください。他のお客様のアプリがインストールされていることが分かる状態は問題ありません。

  • 個人情報や、画像・動画・不適切な単語の自動変換候補などのプロフェッショナルではない情報を表示しないでください。添付ファイルは他のテスター、Test IO スタッフ、およびお客様が閲覧できるため、表示する内容には十分注意してください。

  • Webサイトのテストでは、添付ファイルにURL欄が表示されている必要があります。

  • テキストや画面要素を容易に識別できる十分な解像度である必要があります。

  • 必ず画面全体を録画してください。

  • アプリのクラッシュに関するバグレポートおよびクラッシュの再現確認では、クラッシュログの添付が必須です。クラッシュを記録した動画と添付したクラッシュログは一致している必要があります。つまり、タイミングに矛盾があってはいけません。

スクリーンショットには何を含める必要がありますか?

スクリーンショット固有のルール:

  • スクリーンショットは、JPG または PNG ファイル形式である必要があります。

  • スクリーンショット上でバグを強調表示してください。

スクリーンショットの推奨ツールおよびベストプラクティスについては、次の記事をご覧ください。スクリーンショット

よくある間違いについては、次の記事をご覧ください。

添付ファイルでよくある間違い

スクリーンキャストには何を含める必要がありますか?

スクリーンキャストは、可能な限り短く、必要な限り十分な長さである必要があります。これは、バグの原因とならない手順は省略する必要があることを意味します。例えば、Webショップの商品詳細ページにある「カートに追加」ボタンに不具合がある場合、その商品詳細ページに到達するまでにWebショップ内をどのように移動したかは、通常は関係ありません。通常、最後のナビゲーション手順、バグを引き起こす手順、およびバグ自体が関係します。

例 1:

デスクトップデバイスでテストしたWebサイト上のバグ

例 2:

モバイルデバイスでテストしたアプリ内のバグ

スクリーンキャストを作成する手順:

  1. バグが発生するページへ行ってください。

  2. 録画を開始してください。

  3. ページを更新してください。

  4. バグを引き起こす操作を行ってください。

  5. バグが発生するまで待ってください。

  6. 録画を停止してください。

スクリーンキャストを作成する手順:

  1. アプリを起動し、バグが発生するページに到達するまであと1つのナビゲーション手順だけが必要なページへ行ってください。

  2. 録画を開始してください。

  3. 正しいページに到達するために、最後のナビゲーション手順を実行してください。

  4. バグを引き起こす操作を実行してください。

  5. バグが発生するまで待ってください。

  6. 録画を停止してください。

チームリーダーは、外部録画または追加の録画を依頼する情報提供リクエストを送る場合があります。これは、バグをよりよく理解するため、またはバグが再現できず疑問がある場合に行われます。

スクリーンキャスト固有のルール:

  • スクリーンキャストはMP4ファイル形式である必要があります。

  • 添付ファイルの最大サイズは25 MBです。

  • バグレポートのスクリーンキャストの最大時間は60秒です。ただし、バグで読み込み処理や必要な長時間の手動入力を示す必要がある場合は除きます。

  • ReproductionsおよびUser Storiesの添付ファイルのスクリーンキャストの最大時間は15秒です。これは、バグを引き起こした最後の操作のみを示す必要があるためです。

  • 録画は一度で行ってください。途中で一時停止したり、中間部分を切り取ったりしてはいけません。スクリーンキャストが長すぎて編集したい場合は、ファイルの最初または最後だけを切り取ってください。

  • スクリーンキャストの再生速度を上げることは許可されていません。許可された時間より長く録画した場合は、不要な手順をスクリーンキャストに含めていないか確認してください。

  • 雑音(赤ちゃんの泣き声、会話、テレビ、音楽、ペットの鳴き声など)は録音しないでください。

推奨する録画ツールおよびベストプラクティスについては、次の記事を参照してください: スクリーンキャスト

ほとんどの一般的な間違いについては、次の記事を参照してください:
添付ファイルでよくある間違い

ストリーミングデバイス向けのスクリーンキャスト固有のルール:

  • テレビ画面全体を必ず録画してください。

  • スクリーンキャストは高解像度で高品質である必要があります。

  • 周囲の明るさが暗くならないようにしてください。

  • テレビのリモコンはスクリーンキャスト内に映っている必要があります。また、リモコン全体がはっきりと見える必要があります。

  • バグレポートの場合、スクリーンキャストの最大時間は60秒です。一方、Bug ReproductionsおよびUser Story Attachmentsの場合、最大時間は15秒です。

  • 雑音(赤ちゃんの泣き声、会話、テレビ、音楽、ペットの鳴き声など)は録音しないでください。

  • スクリーンキャストは常にプロフェッショナルな見た目である必要があります。脚、散らかったテレビ台、またはそれに類するものを録画しないでください。

キーボードバグのスクリーンキャストを録画する方法

場合によっては、コンピューターのキーボードキーを使用してWebサイトを操作した際に発生するバグがあります。

このような場合は、スクリーンキャストでバグを引き起こす操作を示す必要があるため、キーボード入力を表示することが必須です。

以下は、キーボード入力を表示したスクリーンキャストの作成方法を示す優れた例です。

すべてのデバイス向けのマスタースクリーンキャスト添付ファイル

添付ファイル内の個人情報をぼかす方法

ブラウザータブに表示されるブックマーク、アカウント名、保存されたメールアドレスなどの個人情報を保護するために、それらをぼかすことができます。

添付ファイルに個人情報を含める必要があるものの、それを表示したくない場合は、以下の例に従って適切に隠すことができます。メールアドレス、ユーザー名、ブックマークが表示される可能性のあるブラウザータブの名前が隠されていることに注意してください。

URLは引き続き表示されている必要があり、Webサイトの要素を隠してはいけないことに注意してください。

プロフェッショナルな理由から、以下の例のように、添付ファイル内の情報を手書きや雑な方法で隠すことは避けることが重要です。

こちらの回答で解決しましたか?