Xray結果レポート

Xray の結果レポートを使うと、チームは Xray プロジェクトに mabl のテスト実行を継続的かつ最新の記録として公開できます。規制の厳しい業界のチームにとって、この連携は業界標準への準拠を確実にし、監査のための重要な証跡を文書化し、テストプロセスの可視性を高めるのに役立ちます。

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

• インテグレーションを設定する
• mabl のテストを Xray に関連付ける

セットアップ

Xray のクレデンシャルを準備する

mabl を Xray と連携するには、Xray で必要なクレデンシャル（クライアント ID とクライアントシークレット）を用意してください。

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

クライアントIDとクライアントシークレットをコピーして保存してください。後のセットアップのステップでmablに必要になります。

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

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

統合のセットアップページで、次の接続情報を入力してください。

• 名前 - 複数のXrayプロジェクトと連携する予定がある場合は、一意の名前を付けてください
• Xray クライアント ID - Xray のクレデンシャルのクライアント ID
• Xray クライアントシークレット - Xray のクレデンシャルに含まれるクライアントシークレット
• プロジェクトキー - プロジェクトの一意の短縮識別子です。たとえば、課題が「PROJ-789」や「PROJ-790」の場合、プロジェクトキーは「PROJ」です。プロジェクトキーは大文字と小文字を区別します。

同期する結果を選択

最低限として、mabl は実行メタデータを報告します。これには、ステータス（成功/失敗）と実行の開始・終了時刻が含まれます。結果の同期セクションで、連携を設定して次の追加詳細を報告できます:

• 失敗したステップのみ同期 - すべての結果を送信するか、失敗したステップの結果のみをmablに送信するかを指定します。
• マップステータスとステップの証拠 - mabl テストステップのアーティファクトを Xray のステップレベルのエビデンスに同期します。この設定を有効にする場合は、ステップレベル同期の推奨ワークフローに従ってください。
• アーティファクトの種類 - どのステップレベルのアーティファクトを Xray に送信するかを指定します

統合を保存すると、Xray プロジェクトにテストを関連付けられます。なお、Results sync の設定をその後に更新しても、新しい接続にのみ適用されます。既存の Xray チケットとの関連付けの設定は変更されません。

mabl のテストを Xray に関連付ける

統合を設定したら、Xray プロジェクトに mabl のテストを関連付けられます。次の表は、mabl のエンティティが Xray のエンティティにどのように対応するかを示します。

既存のテストを関連付ける

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

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

結果を同期

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

テスト実行を同期すると、結果はあなたのXrayプロジェクトに公開されます。

関連するテスト実行で公開された mabl の結果を含む Xray テストケース