Jira を信頼度レポートにつなぐ: 失敗したすべてのエンドツーエンドテストが自動的に Jira のバグになる

Jira サイトを GUI Test Studio に一度接続すれば、不合格になったエンドツーエンドテストはどれも自動的に Jira の課題にできます: 信頼度レポートからワンクリックで、または TeamCity などの CI/CD パイプラインから --jira on-failure で登録します。

誰も書かなくてよいバグレポート

エンドツーエンドテストが不合格になると、誰かが開発者に伝えなければなりません: 何が、どこで壊れたか、そこへどうたどり着くか、本来どう見えるべきか。それをきちんと書くには時間がかかり、画像や手順が抜けていたり曖昧だったりすることもよくあります。

この記事では、Jean が開発者、Pierre がテストの作成者、James が Jira のバックログの管理者、John が TeamCity の運用者です。ショップとそのテストは小さなデモですが、画像はすべて実際の実行のものです。

必要なもの

手順 1: 信頼度レポートに Jira を接続する

1. 1

   API トークンを作成する

   Atlassian アカウントでセキュリティ、API トークンを開き、トークンを作成します。コピーしておいてください: 表示されるのは一度だけです。Jira Data Center では、代わりに Jira のプロファイルで個人アクセストークンを作成します。

2. 2

   GUI Test Runner-Recorder を接続する

   実行の信頼度レポートで、バグレポートの横の Jira に接続をクリックします (バグレポートのフォームでも、Jira の課題を作成の下で接続できます)。Jira サイトの任意のページのアドレス、メールアドレス、トークンを貼り付けます。ウィンドウがすぐにそれらを確認し、誰として接続しているかを表示します。それ以降、どの信頼度レポートからでもバグレポートを Jira に登録できます。

   

   拡大

手順 2: 不合格の実行をアプリから Jira に送る

不合格になった実行の信頼度レポートを開き、バグレポートをクリックします (または Ctrl+B キーを押します)。Jira の課題を作成を選びます。すべてが実行から入力済みです: 確認するだけで済みます。

拡大

Jira の課題を作成をクリックします。課題のキーとリンクがすぐに表示され、レポートがそれを記憶します: 以降、レポートの Jira ボタンはその課題を開きます。フォーム自体についてはバグレポートを作成するで説明しています。

手順 3: 失敗したビルドのたびに TeamCity に任せる

パイプラインでは誰もレポートを開かないので、gtr-cli が自分で課題を作成します。すべてのビルドでエンドツーエンドテストを実行するのコマンドから始めて、Jira のオプションを追加します:

gtr-cli run tests --countdown 0 --format teamcity --artifacts ci-out\artifacts ^
  --jira on-failure --jira-project SCRUM --jira-assignee "James" ^
  --jira-labels gui-test-studio,ui-regression

接続情報は 3 個の環境変数から読み取られるので、トークンがコマンドやビルドログに現れることはありません:

拡大

テストが不合格になると、ビルドログにどの課題になったかがリンク付きで記載され、課題からもビルドへリンクが張られます。

拡大

Jira の課題に含まれるもの

失敗したビルドが作成した課題を、James がバックログで見るとおりに示します。

拡大

再現手順

失敗したステップまでの、番号付きの実行自身のステップです。開発者は推測なしに手作業で追うことができます。

拡大

テストが見たもの

不合格になった各アサーションについて: テストが期待する画像、見つけた画像、そして各変化を赤で囲んだ見つけた画像がもう一度示されます。最後のものは信頼度レポートの「パルス」ビューです: 変化した箇所に目がまっすぐ向かいます。

拡大

PDF のバグレポートとすべての画像の zip が添付されるので、全容を知りたい人や保管したい人が利用できます。

1 件の欠陥に 1 件の課題

拡大

Jira や TeamCity を使っていない場合は?

Jira と TeamCity は例であって、必須ではありません。

1. 1

   任意の CI ツール

   gtr-cli は Jenkins、GitHub Actions、GitLab、Azure DevOps、独自のスクリプトでも同じように動作し、--jira on-failure はそのすべてで使えます。パイプラインでテストを実行するをご覧ください。

2. 2

   任意のトラッカー

   Jira がなくても、--bug-report pdf (または excel、both) で、同じ入力済みのバグレポートとそのエビデンスがファイルとして書き出され、任意のトラッカーのチケットにすぐ添付できます。--json の結果ファイルには、スクリプトが代わりに登録するのに必要なものがすべて含まれています。

3. 3

   パイプラインがない場合

   アプリからは、選んだ任意の実行について、「バグレポート」でレポートを PDF または Excel ブックとして保存するか、Jira に送ることができます。

要点

• 1不合格になった実行は、バグレポートに必要なすべてをすでに知っています: ステップ、期待画像と見つかった画像、そして以前にどれだけ不合格になったかです。
• 2API トークンで Jira を一度接続してください: それ以降は、信頼度レポートの「バグレポート」がワンクリックで課題を登録します。
• 3パイプラインでは、--jira on-failure が代わりに登録し、トークンはパスワードパラメーターに隠されます。
• 41 件の欠陥に 1 件の課題です: 再び見つかった失敗は未解決の課題にコメントを追加し、重複を作ることはありません。
• 5Jira と TeamCity は例であって、必須ではありません: どの CI ツールでも動作し、PDF や Excel のレポートはどのトラッカーにも使えます。

よくある質問

次に読むもの