メインコンテンツへスキップ

テスト実行アーティファクトのXrayへのエクスポート

Molly Exten
  • 更新

mablのXray互換エクスポートオプションを使用すると、mablブラウザテスト実行の テスト実行アーティファクトをXrayテスト実行に追加できます。インポートされたmablのテスト結果には、ステップの説明、期待される結果、実際の結果、およびスクリーンショット（利用可能な場合）が含まれます。

Xray 結果のレポート

mabl から Xray への直接同期を設定するには、Xray 結果レポートの連携をご覧ください。

Xrayでmablの結果を追跡することで、業界標準への準拠、監査への対応、テストプロセスの可視性の向上を実現できます。

この記事では、mablのテスト結果をXrayにエクスポートするプロセスについて説明します。

mabl_test_in_xray

Xrayでのmablの実行結果の表示

セットアップ

テスト結果のエクスポートを始める前に、次の準備作業を行って、mablのテスト結果をXrayに適合したものにします。

Xrayでの作業

Xrayプロジェクトの管理者に、mablテスト実行用の新しいテストタイプオプションを作成するよう依頼してください。オプションフィールドに、「mabl」などのテストタイプ名を入力します。種類を「Steps」に設定します。

Xrayの新しいテストタイプモーダル

mablでの作業

mablで、インテグレーションページにXrayインテグレーションを設定します：ワークスペース > インテグレーション。

  • プロジェクトキーフィールドに、mablテストをインポートするXrayプロジェクトキーを入力します。
  • テストタイプフィールドに、Xrayで作成したテストタイプオプションを入力し、Xrayインテグレーションを設定します。

これらを設定することで、mablからのJSONエクスポートに、Xrayプロジェクトにインポートする必須フィールドが含まれるようになります。 

mablにXray統合を追加する

テスト実行アーティファクトのエクスポート

統合を設定した後、mablアプリ、CLI、またはAPIからXray互換のJSON形式でmablの実行アーティファクトをエクスポートできます。

mablアプリケーションからのエクスポート

mablアプリケーションからXray互換のテスト結果をエクスポートするには、次の手順を実行します。

  1. [More actions (...)] > [テスト実行のアーティファクトをエクスポート] をクリックします。
  2. Xray JSONボックスをチェックする
  3. [エクスポート] をクリックしてファイルをダウンロードします。

アプリでテスト実行アーティファクトをエクスポートする

テスト出力ページでのテスト実行アーティファクトのエクスポート

mabl CLIからのエクスポート

mabl CLIからXray互換のテスト結果をエクスポートするには、mabl test-runs exportコマンドを実行します。{TEST-RUN-ID}を実際のテスト実行ID（-jrで終わるもの）に置き換え、--typeフラグを使用してxray_jsonを指定します：

mabl test-runs export {TEST-RUN-ID} --type xray_json

エクスポートがzipファイルとしてダウンロードされます。

mabl APIからのエクスポート

mabl APIからXray互換の結果をエクスポートするには、レポーティングAPIの「run artifacts」エンドポイントを使用します。

  • テスト実行アーティファクトの作成エンドポイントにPOSTリクエストを送信します。リクエストボディのパラメータ内にある"artifact_types"フィールドの配列に"xray_json"を含めてください。POSTリクエストは-exで終わるエクスポートIDを返します。
  • このエクスポートIDを使って、GETリクエストをテスト実行アーティファクトエクスポートの取得エンドポイントに送信します。このmabl APIは、エクスポートのzipファイルにアクセスできるURLを返します。

Xrayへの実行結果のインポート

mablからJSONファイルをエクスポートした後、実行結果としてXrayのテスト実行に追加します。

  1. 結果を追加するテスト実行をクリックします。
  2. 上部にある…（More）メニューボタンまたはXray固有のアクションボタンをクリックします。
  3. Import Execution Resultsを選択します。
  4. mablからのファイルをXray JSONファイルとしてアップロードします。
  5. ファイルをインポートします。
Xrayへの実行結果のインポート

インポートされたmablのテスト結果には、ステップの説明、期待される結果、実際の結果、およびスクリーンショット（利用可能な場合）が含まれます。

Xrayでのmablからのスクリーンショットの表示

Xrayでのmablからのスクリーンショットの表示

制限事項

Xrayエクスポートの統合は、mablのワークスペースごとに1つのXrayプロジェクトに対してのみ設定できます。複数のXrayプロジェクトにわたるレポートを管理するには、代わりにXray Sync統合を使用してください。

Xray JSON形式は画像を文字列としてエンコードするため、エクスポートされた画像は大きなエクスポートファイルを作成する可能性があります。エクスポートが大きくなりすぎないようにするため、Xray JSONエクスポートタイプを使用する場合、画像のエクスポートはテスト実行中の最初の1000枚の画像に制限されます。テスト実行中に1000枚以上の画像がある場合、それ以降の画像はエクスポートに表示されません。

関連記事