Export von Mobile-JSON aus dem Axe Developer Hub

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

Laden Sie vollständige Scandaten herunter, einschließlich Screenshots und Ansichtshierarchie, für die Verwendung mit Reporter CLI oder Deque-Support

Not for use with personal data

Mobile Projekte im Axe Developer Hub können eine Sitzung als Mobile-JSON exportieren: ein ZIP-Archiv, das eine JSON-Datei pro Ergebnis enthält, wobei jeder Screenshot und die Ansichtshierarchie des Ergebnisses beigefügt sind. Dies ist dasselbe Format, das vom Axe DevTools Mobile-Dashboard erzeugt wird, und es ist das Format, das Axe DevTools Reporter CLI als Eingabe erwartet.

Diese Exportoption ist nur für mobile Projekte verfügbar. Webprojekte verwenden stattdessen JSON- und CSV-Export.

Welches Format sollte ich verwenden?

Das Exportmodal bietet zwei Formate an:

Mobile-JSON (standardmäßig ausgewählt) enthält alles, was während des Scans erfasst wurde: die Barrierefreiheitsergebnisse, Screenshots und die vollständige mobile Ansichtshierarchie für jedes Ergebnis in der Sitzung.
Axe Universal JSON enthält nur die Barrierefreiheitsergebnisse, im selben Schema, das in allen Axe-Produkten verwendet wird, ohne Screenshots oder Ansichtshierarchie.

Wählen Sie Mobile-JSON, wenn Sie die Ergebnisse mit Reporter CLI öffnen möchten, wenn der Deque-Support Sie um einen Scan-Export zur Fehlerbehebung bittet oder wann immer Sie den Screenshot oder die Ansichtshierarchie für ein Ergebnis benötigen. Wählen Sie Axe Universal JSON, wenn Sie Ergebnisse in ein Tool einspeisen, das JSON im axe-core-Stil erwartet und die mobil-spezifischen Felder nicht verwendet, oder wenn Sie eine konsistente Ausgabeform für Ihre Web- und Mobilprojekte wünschen.

Für den vollständigen Vergleich siehe Welches Format sollte ich verwenden? in der Axe DevTools Mobile-Dokumentation — der Hilfelink in der Exportanzeige zeigt ebenfalls dorthin.

Export einer Mobil-Sitzung

Navigieren Sie zu einem mobilen Projekt und öffnen Sie die Sitzung (Liste der Probleme), die Sie exportieren möchten.
Klicken Sie auf Exportieren.
Wählen Sie im Formattyp-Auswahlmenü Mobile-JSON aus (oder lassen Sie es ausgewählt, da es die Standardeinstellung ist).
Klicken Sie auf Exportieren, um zu bestätigen.

note

Während der Export verarbeitet wird, zeigt das Modal einen blockierenden Fortschrittsstatus und kann nicht geschlossen werden, bis der Download abgeschlossen oder fehlgeschlagen ist. Wenn er fehlschlägt, erscheint im selben Modal eine Fehlermeldung mit einer Erneut versuchen-Option, die den Download mit demselben bereits ausgewählten Format erneut versucht — Sie müssen den Formatwähler nicht erneut öffnen.
Sobald der Download abgeschlossen ist, entpacken Sie die Datei. Extrahieren Sie sie in einen Ordner, bevor Sie ein Tool (wie Reporter CLI) auf die Ergebnisse verweisen — das ZIP selbst ist keine gültige Eingabe.

Was ist im Download enthalten?

Das ZIP wird nach der Sitzung benannt, zum Beispiel My-Session_2026-04-27T14-30-15.zip (ein generischer Scan-Report_<timestamp>.zip-Name wird verwendet, wenn die Sitzung keinen Anzeigenamen hat). Jedes Zeichen im Sitzungsnamen, das kein Buchstabe, keine Ziffer, kein Unterstrich, Punkt oder Bindestrich ist (einschließlich Leerzeichen), wird durch einen Bindestrich ersetzt; aufeinanderfolgende Bindestriche werden zu einem zusammengefasst und führende oder abschließende Bindestriche werden entfernt.
Es enthält eine JSON-Datei pro Ergebnis in der Sitzung, jede nach der internen Kennung dieses Ergebnisses benannt und nicht nach etwas Menschlichem.
Die Datei jedes Ergebnisses enthält den entsprechenden Screenshot und die Ansichtshierarchie, es sei denn, Ihre Instanz hat keine verfügbaren Screenshots (siehe die On-Prem-Anmerkung unten).
Der Export enthält immer jedes Ergebnis in der Sitzung — er berücksichtigt keine derzeit auf die Problemliste angewendeten Filter (wie ausgewählte Bildschirme).

note

On-Prem-Instanzen ohne aktivierten ML-Screenshot-Dienst kann immer noch Mobile-JSON exportieren, aber die Dateien enthalten keine Screenshots. Dies ist kein Fehler — es ist eine erwartete anmutige Verschlechterung. Die Ansichtshierarchie und die Barrierefreiheitsergebnisse bleiben unberührt.

Die Exportfunktion verwenden

Mit Reporter CLI: entpacken Sie das ZIP in ein Verzeichnis und führen Sie dann Reporter CLI gegen dieses Verzeichnis aus, um einen Bericht zu erstellen:

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

Siehe Reporter CLI mit automatisierten Tests verwenden für die vollständige Befehlsreferenz und andere Ausgabeformate.

Mit Deque-Support: Wenn ein Support-Ingenieur Sie um einen Scan-Export zur Fehlerbehebung bittet, senden Sie ihm das Mobile-JSON-ZIP — es ist das Format, das ihre Tools erwarten.

Wer kann exportieren?

Jeder, der bereits Ergebnisse für ein mobiles Projekt anzeigen und exportieren kann, kann Mobile-JSON exportieren — keine zusätzliche Berechtigung oder Lizenz ist erforderlich.

Fehlerbehebung

Der Formatwähler bietet JSON/CSV statt Mobile-JSON/Axe Universal JSON an: Sie befinden sich in einem Webprojekt. Der Mobile-JSON-Export erscheint nur auf Seiten von Mobilprojekten.
Der Export schlägt fehl oder wird bei einer sehr großen Sitzung zeitlich überschritten: der Export ist auf 30 Sekunden begrenzt. Wenn das ZIP bis dahin nicht bereit ist, wird die Anfrage abgebrochen und der Export schlägt fehl. Größere Sitzungen sind eher von diesem Limit betroffen. Wenn es ständig fehlschlägt, versuchen Sie es später erneut oder kontaktieren Sie den Deque-Support.

Was kommt als Nächstes?

Kehren Sie zu Verstehen Ihrer Ergebnisse zurück, um mehr über das Filtern, Vergleichen und den Rest der Problemliste zu erfahren, oder sehen Sie sich Axe DevTools Reporter CLI an, um aus Ihrem Export teilbare Berichte zu erzeugen.