Jiraインテグレーション

Jira用のmablインテグレーションを使えば、Jira課題を作成してmablのテストとリンクできます。Jiraインテグレーションを使用すると、次のことを行うことができます。

• mablテストおよびテスト結果をJira課題に添付して、トレーサビリティを改善できます。
• スクリーンショット、DOMスナップショット、ネットワークアクティビティなどの包括的な診断データを、mablテスト結果からJira課題に取り込むことができます。
• Jira課題に関連付けられているmablテストのうち、失敗したものや信頼性が低下したものを確認できます。
• テストしたい動作を記述したJira課題から、mablテストを作成できます。

この記事では、Jira連携の使用方法について説明します。内容は以下のとおりです。

• mablでの新規Jira課題の作成
• mablテストの既存のJira課題へのリンク
• Jira課題の管理
• Jira課題からのテストの作成

セットアップ手順については、Jira Cloudのセットアップの記事をご覧ください。

新規課題の作成方法

mablでのJira課題の作成プロセスは、[新規イシュー] フォームから始まります。[新規イシュー]フォームには、mablアプリケーションの次の場所からアクセスできます。

• テスト実行から: [テスト出力] ページで、[More actions] (...) > [Jira課題を作成...]をクリックします。
• テストから: [テストの詳細] ページで、[イシュー]タブを開き、[+ 新規イシュー] ボタンをクリックします。
• [イシュー] ページから: 左側のナビゲーションで [テスト] をクリックし、[イシュー]タブを選択し、[+ 新規イシュー] ボタンをクリックします。

テスト実行から問題を作成する

[新規イシュー] フォーム

[新規イシュー] フォームで、次の情報を入力します。

• イシュー管理: このプラグインに対するIssue Trackerを選択します
• [新規作成] を選択します
• Project: 課題を作成するJiraプロジェクトを選択します
• Type: 作成する課題のタイプを選択します

[新規イシュー] フォーム

次へボタンをクリックし、必要なフィールドに入力して新しいJiraの課題を作成します。失敗したテストの場合、mablは失敗分析から関連情報を概要と説明に自動的に事前入力します。

mablでの新規Jira課題の作成

[送信] ボタンをクリックして課題を作成します。成功のメッセージが、mablアプリケーション画面の下部に表示されます。リンクをクリックすると、Jira課題が新しいタブで直接開きます。

テスト実行から作成された課題には、失敗したステップから得られた次の診断情報が含まれます。

• 失敗分析
• スクリーンショット
• ステップトレース（実行がステップトレースを保持するよう設定されている場合）
• DOMスナップショット
• HARファイル

mablテストの診断情報を含むJira課題

既存の課題をリンクする方法

mablテストまたはテスト実行を既存のJira課題にリンクするには、[+ 新規イシュー] または [イシューを作成] ボタンをクリックし、次の手順を実行します。

• イシュー管理: このプラグインに対するIssue Trackerを選択します
• [既存のリンク] を選択します
• Project: リンク先の課題を含むプロジェクトを選択します
• 関連付けられるイシュー: 課題の名前またはJira課題IDで検索します
• 説明を追加（任意）：課題の説明に追加情報を加えたい場合は、説明を追加のチェックボックスをオンにして、詳細を入力してください。

[送信] をクリックして接続を完了します。成功のメッセージが、mablアプリケーション画面の下部に表示されます。リンクをクリックすると、Jira課題が新しいタブで直接開きます。

Jiraでは、関連するテストおよびテスト実行が、課題の [mabl] セクションに表示されます。

mablテストとテストケースの関連付け

あなたのチームが Xray for Jira または Zephyr を使用している場合、mabl のテストやテスト結果をテストケース ID に関連付けることもできます。

Jira 連携で mabl のテストやテスト実行をリンクしても、mabl のテストとあなたのテストケース ID の間で自動同期は確立されません。mabl とあなたのテストケース管理ツールの間で継続的なレポートを実現するには、次のいずれかの方法を使用してください:

• Jira 用 Xray： Xray の結果レポート
• TestRail： TestRail インテグレーション
• Zephyr： Zephyr インテグレーション

mablでのJira課題の管理方法

すべてのJira課題は、[イシュー] ページ ([テスト] > [イシュー]) または特定のテストの [イシュー]タブから確認できます。

• Jiraリンクをクリックすると、Jiraで関連する課題を確認し、更新をリクエストできます。
• mablテストを再実行して、課題を再現したり、修正を検証したりできます。

課題のリンク解除

Jiraチケットをmablテストに関連付ける必要がなくなった場合は、リンクを解除できます:

1. Jiraチケットに関連付けられているmablテストのテスト詳細ページに移動します。
2. 課題 タブをクリックします。
3. リンクを解除する課題を選択します。
4. ページ上部のUnlinkボタンをクリックします。
5. モーダルでアクションを確認します。

Jira課題からテストを作成する方法

ユーザーストーリー、バグレポート、要件など、テストしたい動作がJira課題にすでに記述されている場合は、新しいテストを作成するときや既存のテストを編集するときに、その課題をmablエージェントに渡すことができます。ワークスペースにJira Cloudインテグレーションがある場合、テスト作成 ページのプロンプトの下にある + メニューに Jiraの課題 オプションが表示されます。

1. テスト作成 に移動し、新規テスト タブまたは テストを編集 タブで、プロンプトの下にある + をクリックして Jiraの課題 を選択します。
2. インテグレーションの対象が複数のJiraプロジェクトにまたがる場合は、検索するプロジェクトを選択します。検索は一度に1つのプロジェクトが対象です。
3. 課題の要約または PROJ-123 のような課題キーで検索し、使用する各課題にチェックを入れます。1回の検索で複数の課題にチェックを入れることができ、合計で最大5件まで追加できます。
4. 完了 をクリックします。各課題が課題キーとともにプロンプトの下に表示されます。
5. テストデータや開始状態など、課題に含まれていない内容を記述して、プロンプトを送信します。

PROJ-123 のような課題キーや課題のURLがすでにわかっている場合は、検索ボックスに貼り付けてください。mablは接続済みのすべてのJiraサイトで課題を検索するため、先にプロジェクトを選択する必要はありません。

エージェントは、各課題の要約と説明を読み取ります。コメント、添付ファイル、カスタムフィールドは読み取りません。また、読み取れるのはインテグレーションで設定されたプロジェクトの課題のみです。チームが受け入れ基準をカスタムフィールドで管理している場合は、プロンプトに含めるか、要件ファイルを添付してください。