Comprendere i Risultati

Dopo aver seguito le istruzioni per l'installazione del tuo toolkit, genererai risultati che verranno inviati a Developer Hub ogni volta che esegui la tua suite di test. In Developer Hub, puoi visualizzare nuovi e vecchi problemi di accessibilità e monitorare le tendenze nel tempo.

Comprendere la Struttura del Tuo Progetto

Developer Hub organizza i tuoi dati di accessibilità in modo diverso a seconda che i tuoi test end-to-end utilizzino Git per il controllo versione:

Se si utilizza Git, sarai in grado di visualizzare i diversi rami del tuo progetto e i singoli commit fatti su questi rami. La struttura è la seguente:
Progetto → Rami → Commit → Elenco Problemi → Dettagli Problemi

Se non si utilizza Git con il tuo progetto web, o se si visualizza un progetto mobile, vedrai esecuzioni di test individuali e potrai navigare verso i problemi trovati in ciascuna esecuzione. La struttura è la seguente:
Progetto → Esecuzioni Test → Elenco Problemi → Dettagli Problemi

Lavorare con i Tuoi Risultati

Quando apri un progetto, vedrai un elenco di rami (progetti Git) o esecuzioni di test (progetti senza Git).

I Tuoi Risultati a Colpo d'Occhio

Vedrai le seguenti informazioni restituite dal tuo test di accessibilità:

• Per progetti Git: Nome ramo, SHA dell'ultimo commit e messaggio di commit per il test end-to-end in esecuzione
• Per progetti senza Git: Timestamp dell'esecuzione del test
• Numero di problemi che superano il soglia di accessibilità
• Informazioni sul pacchetto e la versione per il toolkit di accessibilità che stai utilizzando
• Riepilogo comparativo che mostra il conteggio totale dei problemi e delle scansioni
• Un conteggio dei nuovi problemi introdotti e dei problemi risolti (solo progetti web)
• Punteggio di accessibilità (solo per progetti mobili): Una percentuale (0–100%) che mostra quanto siano state accessibili le scansioni della sessione, dettagliata di seguito in Punteggio di Accessibilità (Solo Progetti Mobili)
• Pulsante 'Visualizza Commit' (solo progetti Git) per approfondire i singoli commit
• Pulsante 'Visualizza Problemi' per vedere l'elenco completo dei problemi

Punteggio di Accessibilità (Solo Progetti Mobili)

Il punteggio di accessibilità è una percentuale (0–100%) mostrata sulle pagine di report delle sessioni mobili. Un punteggio più alto significa meno problemi di accessibilità gravi durante la sessione.

Il punteggio è calcolato in due passaggi:

1. Ogni scansione riceve un punteggio basato sul suo problema di accessibilità più grave:

   • 100% — solo problemi minori, o nessun problema
   • 80% — almeno un problema moderato; nessun problema grave o critico
   • 40% — almeno un problema grave; nessun problema critico
   • 0% — almeno un problema critico

2. Il punteggio della sessione è la media di tutti i punteggi delle scansioni.

Ad esempio, una sessione con tre scansioni, una con soli problemi minori, una con un problema grave e una con un problema critico, otterrebbe un punteggio di (100 + 40 + 0) / 3 ≈ 47%.

Le sessioni senza scansioni mostrano uno stato vuoto anziché 0%.

Per la specifica completa della formula, vedere Calcolare un Punteggio nella documentazione di Axe DevTools Mobile.

Rinominare le Sessioni

Per impostazione predefinita, le sessioni sono identificate dalle informazioni sul ramo e commit Git (progetti Git) o dall'orario (progetti senza Git). Puoi impostare un nome visualizzato personalizzato su qualsiasi sessione per renderne più facile l'identificazione durante le esecuzioni di scansione.

I nomi personalizzati appaiono in tutta Developer Hub ovunque una sessione sia menzionata: intestazioni di pagina, titoli dei pannelli, breadcrumb e etichette di confronto. L'identificatore originale Git o l'orario resta visibile in un'area metadata nella pagina dei problemi.

Per rinominare una sessione, apri la sua pagina dei problemi e fai clic sul pulsante di modifica nell'intestazione della pagina. Gli amministratori di progetto, Collaboratori e Amministratori dell'organizzazione possono rinominare qualsiasi sessione nel progetto.

Informazioni sul Pipeline

Per i team i cui test utilizzano i dati Git con Axe Watcher, tutte le esecuzioni possono essere confrontate con le esecuzioni CI/CD sul ramo predefinito, per garantire che il nuovo codice unito non introduca ulteriori problemi di accessibilità. Per impostare il confronto, un amministratore del progetto deve impostare Watcher per funzionare sul ramo predefinito del repository - questo è solitamente il main (o master) ramo. Questa istanza del toolkit deve essere configurata come esecuzione pipeline.

Una volta che i dati della scansione arrivano dall'esecuzione del pipeline designata sul ramo predefinito, i risultati verranno visualizzati in cima alla pagina. Gli utenti possono scegliere di visualizzare diversi set di risultati tramite chiave API e vedere come si confrontano con l'esecuzione del pipeline sul ramo predefinito.

Scopri di più sulla configurazione delle esecuzioni pipeline con Axe Watcher in Ambienti di Integrazione Continua (CI)

Comprendere i Confronti

Le informazioni di confronto fornite per i progetti web ti aiutano a capire cosa è cambiato:

• Per progetti Git:
  • Nella pagina che mostra tutti i rami del tuo progetto, puoi vedere come l'ultimo commit su ciascun ramo si confronta con l'ultima esecuzione della pipeline sul ramo predefinito.
  • Quando selezioni un ramo individuale da visualizzare, puoi vedere come ciascun unico commit su quel ramo si confronta con il commit precedente.
• Per i progetti Gitless: Ogni esecuzione di test è confrontata con l'esecuzione precedente.

Se non vedi alcun dato di confronto, è probabile che non sia disponibile alcuna scansione precedente per confrontarla o che una scansione della pipeline non sia ancora stata eseguita sul branch predefinito.

Scopri di più sull'uso dei confronti per monitorare le tendenze

Scopri di Più sui Problemi di Accessibilità

Dopo aver cliccato Visualizza Problemi da un ramo, commit o esecuzione di test, vedrai una pagina riassuntiva che elenca e raggruppa le violazioni dell'accessibilità per regola e livello di impatto.

Tabella di Confronto (Solo Progetti Web)

I progetti web visualizzano una tabella di confronto in cima che mostra:

• Problemi totali nelle scansioni attuali e di riferimento
• Nuovi problemi introdotti
• Problemi esistenti precedentemente
• Problemi che sono stati risolti
• Tutti questi sono raggruppati per gravità dell'impatto (Critico, Grave, Moderato, Minore)

Nota: I progetti mobili non includono questa tabella di confronto.

Elenco delle Regole

Sotto la sezione di confronto (o in cima per i progetti mobili), vedrai tutte le regole di accessibilità violate raggruppate per:

• Nome della regola (che puoi selezionare per visualizzare i singoli problemi)
• Livello di impatto
• Numero di violazioni trovate per quella regola

Filtraggio ed Esportazione

Con progetti web, usa i controlli del filtro per concentrarti su problemi specifici:

• Filtra per livello di impatto (Critico, Grave, Moderato, Minore)
• Mostra solo i nuovi problemi
• Seleziona stati specifici delle pagine

Con progetti mobili, usa il filtro per selezionare uno o più schermi nell'elenco e focalizzati su determinati risultati.

Esporta i tuoi risultati:

• Web
  • Esporta JSON per condividere facilmente risultati dettagliati in formato leggibile
  • Esporta CSV per fogli di calcolo e reportistica
• Mobile
  • Esporta formato JSON Axe Universal per integrazione con altri strumenti

Le esportazioni si allineeranno con i tuoi filtri attuali.

Pagina del Problema Singolo

Fai clic su qualsiasi nome di regola nell'elenco dei problemi per vedere informazioni dettagliate su ogni violazione.

Trovare Problemi nel Tuo Codice

I progetti web forniscono:

• Codice sorgente dell'elemento (frammento HTML)
• Selettore CSS per individuare l'elemento
• Espressione XPath come localizzatore alternativo
• Tutti con pulsanti di copia per un facile utilizzo nei tuoi strumenti di sviluppo

Progetti mobile forniscono:

• Screenshot con il problema evidenziato
• Vista dettagli: Fornisce contesto per l'elemento problematico
• Vista Ispezione Gerarchica: Mostra l'albero gerarchico per individuare l'esatta posizione e vedere le proprietà dettagliate dell'elemento

Guida alla Risoluzione

Ogni problema include:

• Descrizione della regola che spiega il problema di accessibilità
• Link a Deque University o pagine delle Regole Mobile per una guida completa ed esempi di codice
• Livello di impatto e tag di accessibilità (criteri WCAG, migliori pratiche)
• Navigazione per passare attraverso tutte le istanze di questa violazione (es: „1 di 5“)

Condivisione dei Problemi

Clicca Copia collegamento problema in cima alla pagina per condividere con il tuo team o aggiungere al tuo sistema di tracciamento problemi.

Permessi di condivisione: I link ai problemi rispettano le impostazioni di condivisione della tua organizzazione. I membri del team necessitano di permessi adeguati per visualizzare i problemi. Gli amministratori possono configurare le impostazioni di condivisione in:

• Configurazione Globale - Imposta i valori predefiniti di condivisione a livello di organizzazione
• Impostazioni progetto - Accedi e aggiorna le impostazioni per i singoli progetti in Axe Developer Hub