バグレポートを作成する

失敗した実行からバグレポートへ

失敗した実行には、開発者に必要なものがすべてそろっています: そこに至るまでのステップ、期待されていたもの、代わりに表示されたもの、これまでに何回失敗したかです。バグレポートはそれらを、人が読むための 1 つの文書にまとめます。

作成する

1. 1

   実行の信頼度レポートを開く

   バナーのバグレポートをクリックするか、Ctrl+B を押します。あらゆるバグレポートはこの 1 つのボタンから作ります: フォームはファイルとして保存と Jira の課題を作成という 2 つの送信先タイルを表示して開きます。このページではファイルの場合を説明し、Jira は下で扱います。

2. 2

   フォームを確認して調整する

   すべてのフィールドはすでに入力されています。必要に応じて変更し、担当者を追加して、PDF か Excel を選びます。

   

   拡大

3. 3

   保存する

   「保存」をクリックするまでは何も書き込まれません。レポートは既定でテストの結果フォルダーに保存されます。

自動で入力される内容

得られるもの

チケットにそのまま添付できる PDF、またはステップと履歴をフィルターできるシートにまとめた Excel ブックです。その隣の zip ファイルにはエビデンスが入ります: 期待画像と実際の画像、差分、失敗した瞬間の画面です。

Jira に送る

プラグインなしで、同じレポートをファイルの代わりに Jira の課題にすることもできます: GUI Test Runner-Recorder が Jira サイトと直接やり取りします。信頼度レポートに Jira を一度接続すれば、失敗した実行のバグレポートはワンクリックでバックログに入ります。

1. 1

   一度だけ接続する

   実行の信頼度レポートで、バグレポートの横にある Jira に接続をクリックします (バグレポートのフォームの Jira の課題を作成にもあります)。Jira サイトの任意のページのアドレス、メールアドレス、API トークン (Jira Data Center では個人アクセストークン) を入力します。トークンは Windows アカウント用に暗号化して保存され、当社のサーバーを経由することはありません。接続が済むとこのボタンは消えます: 以後、バグレポートの送信先として Jira が選べるようになります。

2. 2

   送信先を選ぶ

   プロジェクト、課題タイプ、担当者、優先度は Jira サイトから読み込まれます。レポートの優先度はサイト側の優先度に対応付けられます。

3. 3

   課題を作成する

   Jira の課題を作成をクリックします。課題には、説明、再現手順、変化した箇所を赤で囲んだ期待画像と検出画像、PDF、エビデンスの zip が含まれます。SCRUM-12 のような課題キーが、レポートのバナーの Jira に接続があった場所に表示されます: クリックすると Jira で課題を開くか別の課題を作成でき、Ctrl+J でも同じことができます。

同じ欠陥で再び失敗したときは、重複を作らず、未解決の課題にコメントが追加されます。パイプラインでは、--jira on-failure を付けると gtr-cli がこれらすべてを自動で行います: 失敗を Jira に報告するを参照してください。

接続、アプリから作成した課題、失敗したビルドごとに TeamCity が課題を登録する様子など、流れ全体を画像付きで説明した記事がJira を信頼度レポートにつなぐです。