Esportare il JSON Mobile da Axe Developer Hub

I progetti Mobile in Axe Developer Hub possono esportare una sessione come JSON Mobile: un archivio zip contenente un file JSON per ogni risultato, con lo screenshot e la gerarchia delle visualizzazioni di ogni risultato allegato. Questo è lo stesso formato prodotto dalla dashboard di Axe DevTools Mobile, ed è il formato che il Axe DevTools Reporter CLI si aspetta come input.

Questa opzione di esportazione è disponibile solo per i progetti mobili. I progetti web usano invece Esportazione JSON e CSV.

Quale formato dovrei usare?

Il modulo di esportazione offre due formati:

• JSON Mobile (selezionato di default) include tutto ciò che è stato catturato durante la scansione: i risultati di accessibilità, gli screenshot e l'intera gerarchia delle visualizzazioni mobili per ogni risultato nella sessione.
• JSON Universale Axe contiene solo i risultati di accessibilità, nello stesso schema utilizzato in tutti i prodotti Axe, senza screenshot o gerarchia delle visualizzazioni.

Scegli JSON Mobile quando vuoi aprire i risultati con Reporter CLI, quando il supporto Deque ti chiede un'esportazione della scansione durante la risoluzione dei problemi, o ogni volta che hai bisogno dello screenshot o della gerarchia delle visualizzazioni per un risultato. Scegli JSON Universale Axe quando stai inserendo i risultati in uno strumento che si aspetta JSON nello stile axe-core e non utilizza i campi specifici per i dispositivi mobili, o quando vuoi una forma uniforme di output per i tuoi progetti web e mobili.

Per il confronto completo, vedi Quale formato dovrei usare? nella documentazione di Axe DevTools Mobile — anche il link di aiuto nell'applicazione del modulo di esportazione punta qui.

Esportare una sessione mobile

1. Naviga fino a un progetto mobile e apri la sessione (elenco dei problemi) che desideri esportare.

2. Clicca su Esporta.

3. Nel selettore Tipo di formato, seleziona JSON Mobile (o lascia selezionato, dato che è il predefinito).

4. Clicca su Esporta per confermare.

   note

   Mentre l'esportazione è in corso, il modulo mostra uno stato di progressione che blocca e non può essere eliminato finché il download non è completo o fallisce. Se fallisce, un messaggio di errore appare nello stesso modulo con un'opzione Riprova che riprova il download con lo stesso formato già selezionato — non è necessario riaprire il selettore del formato.

5. Una volta completato il download, decomprimi il file. Estrailo in una cartella prima di puntare qualsiasi strumento (come Reporter CLI) ai risultati — lo zip stesso non è un input valido.

Cosa c'è nel download

• Lo zip è nominato dopo la sessione, ad esempio My-Session_2026-04-27T14-30-15.zip (viene utilizzato un nome generico Scan-Report_<timestamp>.zip se la sessione non ha un nome visualizzato). Qualsiasi carattere nel nome della sessione che non sia una lettera, cifra, trattino basso, punto o trattino (incluse le spaziature) viene sostituito con un trattino; i trattini consecutivi si riducono in uno solo, e i trattini all'inizio o alla fine vengono eliminati.
• Contiene un file JSON per ogni risultato della sessione, ciascuno nominato con l'identificatore interno di quel risultato piuttosto che con qualcosa di leggibile dall'uomo.
• Il file di ogni risultato ha il suo screenshot e la gerarchia delle visualizzazioni allegati, a meno che la tua istanza non abbia screenshot disponibili (vedi la nota on-prem qui sotto).
• L'esportazione include sempre ogni risultato nella sessione — non rispetta alcun filtro (come gli schermi selezionati) attualmente applicato alla lista dei problemi.

Utilizzare l'export

Con Reporter CLI: estrai lo zip in una directory, poi esegui Reporter CLI contro quella directory per generare un rapporto:

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

Vedi Utilizza Reporter CLI con il Test Automatizzato per la guida completa ai comandi e altri formati di output.

Con il supporto Deque: se un ingegnere del supporto ti chiede un'esportazione della scansione durante la risoluzione di un problema, inviagli il file zip JSON Mobile — è il formato che i loro strumenti si aspettano.

Chi può esportare

Chiunque possa già visualizzare ed esportare i risultati per un progetto mobile può esportare il JSON Mobile — non è richiesta alcuna autorizzazione o licenza aggiuntiva.

Risoluzione dei problemi

• Il selettore di formato offre JSON/CSV invece di JSON Mobile/JSON Universale Axe: sei in un progetto web. L'esportazione JSON Mobile appare solo nelle pagine del progetto mobile.
• L'esportazione fallisce o scade in una sessione molto grande: l'esportazione è limitata a 30 secondi. Se lo zip non è pronto entro quel tempo, la richiesta viene annullata e l'esportazione fallisce. È più probabile che sessioni di grandi dimensioni raggiungano questo limite. Se fallisce costantemente, prova di nuovo più tardi o contatta il supporto Deque.

Che cosa fare dopo?

Torna a Comprendi i tuoi risultati per scoprire di più su filtraggio, confronti, e il resto dell'elenco dei problemi, oppure consulta Axe DevTools Reporter CLI per generare rapporti condivisibili dal tuo export.