Axe Developer HubからモバイルJSONをエクスポートする

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Reporter CLIやDequeサポートで使用するための、スクリーンショットやビュー階層を含む完全なスキャンデータをダウンロードする

Not for use with personal data

Axe Developer Hubのモバイルプロジェクトでは、セッションをモバイルJSONとしてエクスポートできます。これは、結果ごとに1つのJSONファイルを含むzipアーカイブで、各結果にスクリーンショットとビュー階層が付属しています。この形式は、Axe DevTools Mobile ダッシュボードによって生成されるものと同じであり、Axe DevTools Reporter CLIが入力として期待する形式です。

このエクスポートオプションはモバイルプロジェクトでのみ利用可能です。ウェブプロジェクトでは代わりにJSONとCSVのエクスポートを使用します。

どの形式を使用すべきか?

エクスポートモーダルでは2つの形式を提供しています:

  • モバイルJSON(デフォルトで選択されています)は、スキャン中にキャプチャされたすべてのデータを含みます:アクセシビリティ結果、スクリーンショット、そしてセッション内のすべての結果に対する完全なモバイルビュー階層です。
  • AxeユニバーサルJSONには、アクセシビリティ結果のみが含まれ、他のAxe製品で使用されるスキーマと同じものを使用していますが、スクリーンショットやビュー階層は含まれていません。

Reporter CLIで結果を開きたいとき、Dequeサポートがトラブルシューティングのためにスキャンエクスポートを要求したとき、または結果に対するスクリーンショットやビュー階層が必要なときはモバイルJSONを選択してください。axe-coreスタイルのJSONを期待するツールに結果を入力する場合、またはウェブとモバイルプロジェクトで一貫した出力形状が欲しい場合はAxeユニバーサルJSONを選択してください。

完全な比較については、Axe DevTools Mobileのドキュメントにあるどの形式を使用すべきか?をご覧ください — エクスポートモーダルのアプリ内ヘルプリンクもそこにポイントしています。

モバイルセッションをエクスポートする

  1. モバイルプロジェクトに移動し、エクスポートしたいセッション(問題リスト)を開きます。

  2. エクスポートをクリックします。

  3. 形式タイプピッカーでモバイルJSONを選択します(デフォルトなのでそのままでもOKです)。

  4. エクスポートをクリックして確認します。

    note

    エクスポートが処理されている間、モーダルはブロッキング状態を表示し、ダウンロードが完了するか失敗するまで解除できません。失敗した場合、同じモーダルにエラーメッセージが表示され、再試行オプションで同じ形式を再試行できます — フォーマットピッカーを再度開く必要はありません。

  5. ダウンロードが完了したら、ファイルを解凍します。ツール(Reporter CLIなど)を結果に向ける前に、フォルダに解凍してください — zip自体は有効な入力ではありません。

ダウンロードの内容

  • zipはセッションの名前が付けられています。例えばMy-Session_2026-04-27T14-30-15.zip(セッションに表示名がない場合は、一般的なScan-Report_<timestamp>.zip名が使用されます)。セッション名内の文字で、文字、数字、アンダースコア、ドット、ハイフン(スペース含む)以外のものはハイフンで置き換えられます。連続するハイフンは一つに縮小され、先頭または末尾のハイフンは削除されます。
  • セッション内の各結果に対する1つのJSONファイルが含まれており、それぞれが人間には読めない内部識別子に基づいて命名されています。
  • 各結果のファイルにはスクリーンショットとビュー階層が添付されていますが、スクリーンショットが利用できない場合(オンプレミスの注意事項を参照)を除きます。
  • エクスポートには常にセッション内のすべての結果が含まれています — 現在適用されているフィルター(選択されたスクリーンなど)を考慮しません。
note

MLスクリーンショットサービスが無効なオンプレミスインスタンスでもモバイルJSONをエクスポートできますが、ファイルにスクリーンショットは含まれません。これはエラーではなく、期待される優雅な機能低下です。ビュー階層とアクセシビリティ結果は影響を受けません。

エクスポートの使用方法

Reporter CLIを使用する場合: zipをディレクトリに解凍し、そのディレクトリに対してReporter CLIを実行してレポートを生成します:

./reporter-cli-<your-system> <extracted-results-directory> <output-directory> --format=html

完全なコマンドリファレンスやその他の出力形式についてはReporter CLIを使った自動化テストを参照してください。

Dequeサポートで使用する場合: サポートエンジニアがトラブルシューティング中にスキャンエクスポートを要求した場合、Mobile JSON zipを送信してください — 彼らのツールが期待する形式です。

エクスポートできる人

既にモバイルプロジェクトの結果を閲覧・エクスポートできる人は誰でも、モバイルJSONをエクスポートできます — 追加の権限やライセンスは必要ありません。

トラブルシューティング

  • フォーマットピッカーにはJSON/CSVが表示され、モバイルJSON/AxeユニバーサルJSONは表示されません:ウェブプロジェクトにいます。モバイルJSONエクスポートはモバイルプロジェクトページのみで表示されます。
  • 非常に大きなセッションでエクスポートが失敗またはタイムアウトする: エクスポートは30秒で上限がかけられています。zipがそれまでに準備されていないと、リクエストは中断され、エクスポートは失敗します。大きいセッションほどこの制限に達する可能性が高いです。失敗が続く場合は、後で再試行するか、Dequeサポートに連絡してください。

次は何をする?

結果を理解するに戻ってフィルタリング、比較、その他の問題リストについて学ぶか、エクスポートから共有可能なレポートを生成するAxe DevTools Reporter CLIを参照してください。