Xray結果レポート

Xray結果レポート機能を使用すると、mablテストの最新結果をXrayプロジェクトに直接公開できます。規制の厳しい業界のチームにとって、この統合により業界標準への準拠を確保し、監査のための重要な証拠を文書化し、テストプロセスの可視性を向上させることができます。

この記事では、mablでXrayの結果レポートを設定する方法について説明します。

• 統合を設定する
• mablテストとプランをXrayに関連付ける
• Xrayに結果を公開する

統合を設定する

Xrayクレデンシャルを収集する

mabl を Xray に接続するには、Xray から必要なクレデンシャルをコピーして保存する必要があります。mabl での後続のセットアップステップには、以下が必要になります:

• クライアントID
• クライアントシークレット

これらのクレデンシャルを取得するには、XrayプロジェクトのJira管理者が最初にAPIキーを作成する必要があります。APIキーは、Xrayプロジェクトを閲覧し、関連するXrayプロジェクト内で課題を作成、編集、リンクするための十分な権限を持つXrayユーザーに関連付けられている必要があります。

mabl でインテグレーションを追加する

mabl アプリで、インテグレーションページに移動します：ワークスペース > インテグレーション。 mablとインテグレーション セクションで、Xray 連携用の + セットアップ ボタンをクリックします。

統合設定ページで、以下の接続詳細を入力してください:

• 名前 - mabl側の統合に対する説明的な名前
• Xray クライアント ID - Xray クレデンシャルのクライアント ID
• Xrayクライアントシークレット - Xrayクレデンシャルのクライアントシークレット
• プロジェクトキー - プロジェクトの一意の短縮識別子です。たとえば、課題が「PROJ-789」と「PROJ-790」の場合、プロジェクトキーは「PROJ」です。

同期する結果を選択

最低限、mablは実行メタデータ（成功/失敗のステータスや実行の開始/終了時刻を含む）をレポートします。結果の同期セクションでは、追加の詳細をレポートするようにインテグレーションを設定できます:

• 失敗したステップのみを同期 - mablがすべての結果を送信するか、失敗したステップの結果のみを送信するかを指定します。
• ステップのステータスとエビデンスをマッピング - mablテストステップのアーティファクトをXrayのステップレベルのエビデンスに同期します。この設定には追加のセットアップ手順が必要です。詳細については、Xrayステップレベル同期に関する記事を参照してください。
• アーティファクトタイプ - Xrayに送信するステップレベルのアーティファクトを指定します

統合を保存すると、Xrayプロジェクトとテストの関連付けを開始できます。

注意: 統合の同期設定に加えた変更(アーティファクトタイプの切り替えなど)は、変更後に作成された同期にのみ適用されます。以前に同期された結果のアーティファクトを更新するには、統合設定を更新した後、mablテストまたはプラン実行の出力ページから結果を再同期してください。

mabl プランとテストを Xray に関連付ける

統合を設定した後、mablプランとテストをXrayプロジェクトに関連付けることができます。次の表は、mablエンティティがXrayエンティティにどのようにマッピングされるかを示しています:

厳密な命名が必要

結果を正常に同期するには、Xrayプロジェクトで「Test Plan」と「Test」という正確な課題タイプ名を使用する必要があります。Jiraインスタンスでこれらの名前が異なる場合、mablでの関連付けに使用できません。

確認するには、Xrayプロジェクトの課題アイコンにカーソルを合わせてください。同期が機能するには、ツールチップに課題タイプとして「Test Plan」または「Test」が明示的に表示される必要があります。

結果を同期するための推奨ワークフロー

Xrayで関連するmablプランの完全な結果を取得するには、mablプランと、mablプラン内のすべてのテストを、同じプロジェクト内の対応するXrayエンティティに関連付ける必要があります。mablテストが関連付けられていない場合、その結果はXrayテスト実行レポートから除外されます。

Xrayで完全なカバレッジを確保するために、次の2ステップの関連付けワークフローをお勧めします:

1. mablプランをXray Test Planに関連付ける
2. プラン内のすべてのmablテストを、同じプロジェクト内のそれぞれのXrayテストケースに関連付けます

プランを関連付ける

mabl プランを Xray テストプランに関連付けるには、新規/編集プランページの Xray ボタンをクリックします。Xray プロジェクトと Xray テストプラン ID を入力してください。

テストを関連付ける

既存のmablテストをXray Test Caseに関連付けるには、mablのテスト詳細ページに移動し、鉛筆アイコンをクリックして情報を更新してください。

テスト情報を更新モーダルで、Xrayボタンをクリックし、XrayプロジェクトとXrayテストケースIDを入力します。カスタムテストケース管理フィールドは、カスタムテストケース管理統合の設定を目的としており、Xrayの結果レポートには使用しないでください。

結果を公開

関連するmablテストとプランの実行が完了したら、結果をTest ExecutionとしてXrayに公開できます。mablのテスト実行またはプラン実行の出力ページで、Xray IDの横にある更新アイコンをクリックしてください。

プラン実行

プランの実行を同期すると、結果が新しいTest ExecutionとしてXray Test Planに公開されます。mablプランの実行に対するTest Executionには、同じプロジェクト内のXray Test Caseにリンクされているmablテストの結果のみが含まれます。Xrayプロジェクトに関連付けられていないmablプラン内のテストは、Test Executionレポートから除外されます。

たとえば、Xrayテストプランに関連付けられ、5つのテストを実行するmablプランを考えてみましょう。

• 3つのテストがXrayテストケースにリンクされている場合、それらのテストの結果はTest Executionレポートに公開されます。
• 2つのテストがXrayテストケースにリンクされていない場合、それらの結果はXrayから除外され、mablでのみ表示されます。

テスト実行

単一のテストで課題をトラブルシューティングしている場合は、テスト実行の出力ページから結果を同期できます。結果は、テストケースIDに関連付けられた新しいテスト実行として公開されます。