Azure Boards インテグレーションを使用すると、失敗した mabl のテスト実行から作業項目を作成したり、テストを既存の作業項目にリンクしたり、作業項目を使って新しい mabl テストを作成したりできます。この記事では、これらの操作を mabl アプリで行う方法を説明します。先に mabl を Azure Boards に接続するには、Azure Boards インテグレーションをご覧ください。
作業項目を作成・リンクする
mabl アプリの次の場所から、作業項目を作成・リンクできます。
- 失敗したテスト実行から: テスト出力ページで、失敗分析の下、または失敗したステップの イシューを作成 をクリックします。
- テストから: テストの詳細ページでイシュータブを開き、+ 新規イシュー をクリックします。
- イシューページから: 左側のナビゲーションで テスト をクリックし、イシュータブを開いて + 新規イシュー をクリックします。
失敗した実行から作業項目を作成する
新規イシュー フォームで、次の情報を入力します。
- イシュー管理 ドロップダウンで、Azure Boards インテグレーションを選択します。
- 「新規作成」を選択します。
- Project（プロジェクト）と Work item type（作業項目の種類）を選択します。一覧にはプロジェクトのプロセスにあるすべての種類が含まれるため、長くなることがあります。インテグレーションのデフォルトの種類が先頭に表示されます。
- 次 をクリックします。その種類で表示するように設定したフィールドが、デフォルト値が入力された状態で表示されます。失敗した実行から作成する作業項目では、mabl がタイトルに失敗分析のタイトルを、説明に失敗分析の残りの内容をあらかじめ入力します。どちらも編集できます。
- その他のフィールドを入力し、送信 をクリックします。
画面の下部に成功メッセージが表示されます。リンクをクリックすると、Azure Boards の作業項目が新しいタブで開きます。
失敗したテストに対して使用する種類は、ほとんどの場合 Bug か、Bug のない Basic プロセスでは Issue です。mabl はプロジェクトのバグの種類をあらかじめ選択しており、管理者はインテグレーションでデフォルトを変更できます。修正を Task として登録するチームもあります。種類の一覧を絞り込むことはできませんが、管理者はフィールドの設定で種類ごとのフォームを調整できます。
作成された作業項目に含まれる内容
失敗した実行から作成された作業項目には、開発者が問題に着手するために必要なものがすべて含まれます。
- タイトル: 失敗分析のタイトル、またはフォームで変更した内容。
- 説明: 失敗分析の残りの内容、実行終了時のページのスクリーンショット、そして View the failed test run in mabl（mabl で失敗したテスト実行を表示）と Open the test in mabl（mabl でテストを開く）の 2 つのリンクを含むフッター。説明は markdown で記述されます。
- 添付ファイル: 失敗した実行の最終状態のスクリーンショット、DOM スナップショット、HAR ファイル、および失敗した実行がステップトレースを保持するよう設定されている場合は Chrome トレース。
- リンク: 作業項目の他のリンクと並んで表示される、mabl のテスト実行と mabl のテストへのハイパーリンク。
添付ファイルはベストエフォートで追加されます。25 MB を超えるファイルはスキップされ、アップロードできないファイルがあっても、作業項目はそのファイルなしで作成されます。
既存の作業項目にリンクする
mabl のテストまたはテスト実行を既存の作業項目にリンクするには、新規イシュー フォームを開いて次の手順を行います。
- イシュー管理 ドロップダウンで、Azure Boards インテグレーションを選択します。
- 「既存のリンク」を選択します。
- プロジェクト を選択します。
- 関連付けられるイシュー で、作業項目をタイトルで検索するか、ID を入力します。
- 送信 をクリックします。
画面の下部に成功メッセージが表示され、テストの Issue タブに作業項目が表示されます。
mabl で作業項目を管理する
リンクされたすべての作業項目は、イシューページ（テスト > Issue）または特定のテストの Issue タブで確認できます。作業項目のリンクをクリックして Azure Boards で開いたり、mabl のテストを再実行して問題を再現したり修正を検証したりできます。
mabl は作業項目を「Open」または「Closed」のいずれかで表示します。mabl は約 10 分ごとに、リンクされた各作業項目を確認します。Azure Boards で作業項目をクローズ、再オープン、削除、復元すると、次回の確認時に mabl のイシューが更新されます。
テストから作業項目を削除するには、テストの詳細ページで Issue タブを開き、削除するイシューを選択して Unlink をクリックし、確認します。作業項目自体は Azure Boards に残ります。
作業項目からテストを作成する
テストしたい動作が作業項目にすでに記述されている場合は、新しいテストを作成するときや既存のテストを編集するときに、その作業項目を mabl エージェントに渡すことができます。受け入れ基準のあるユーザーストーリー、プロダクトバックログ項目、要件のほか、再現手順のあるバグや Azure Test Plans のテストケースが適しています。ワークスペースに有効な Azure Boards インテグレーションがある場合、テスト作成 ページのプロンプトの下にある + メニューに Azure Boardsの作業項目 オプションが表示されます。
- テスト作成 に移動し、新規テスト タブまたは テストを編集 タブで、プロンプトの下にある + をクリックして Azure Boardsの作業項目 を選択します。
- ワークスペースに複数の Azure Boards インテグレーションがある場合は、検索するインテグレーションを選択します。
- タイトルで検索するか、
123やAB#123のような作業項目 ID を入力するか、作業項目の URL を貼り付けます。使用する各作業項目にチェックを入れます。1 回の検索で複数の作業項目にチェックを入れることができ、合計で最大 5 件まで追加できます。 - 完了 をクリックします。各作業項目が ID とともにプロンプトの下に表示されます。カーソルを合わせるとタイトルが表示されます。
- テストデータや開始状態など、作業項目に含まれていない内容を記述して、プロンプトを送信します。
エージェントは、その種類の作業項目で動作を記述しているフィールドを読み取ります。ユーザーストーリーではタイトル、説明、受け入れ基準を、バグでは再現手順を、テストケースでは共有ステップを含むステップと期待される結果を読み取ります。コメント、履歴、添付ファイル、カスタムフィールドは読み取りません。会話の中では、エージェントは作業項目を AB#123 の形式の ID で参照します。
検索と ID
検索は Azure DevOps の作業項目検索インデックスに依存しています。接続したばかりの組織では、ピッカーに検索のインデックス作成中であると表示されることがあります。その場合は、作業項目の ID または URL を入力してください。同じ ID が接続済みの複数の組織に存在する場合、ピッカーはどちらを指しているかを確認します。
自動リンク
作業項目を 1 件だけ使って新しいテストを作成し、その作業項目の種類が Test Case である場合、エージェントがテストを保存するときに、mabl はその Test Case をテストのテストケースセクションに追加します。インテグレーションで Azure Test Plans に結果を記録している場合、それ以降のプラン実行ではその Test Case に結果が記録されます。ユーザーストーリーやバグなど、その他の種類の作業項目も参照として使用できますが、mabl は新しいテストからそれらへのリンクを作成しません。ストーリーやバグをテストと一緒に追跡するには、既存の作業項目にリンクするの手順に従って、テストのイシュータブからリンクしてください。
複数の作業項目を参照して新しい mabl テストを作成した場合、そのうちの 1 件が Test Case であっても、mabl はいずれもリンクしません。テスト情報ダイアログのテストケースセクションで、Test Case を自分で追加してください。