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 diversi rami del tuo progetto e i singoli commit effettuati 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 singole esecuzioni di test e potrai navigare ai problemi trovati in ciascuna esecuzione. La struttura è la seguente:
Progetto → Esecuzioni di 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 del ramo, ultimo SHA del commit e messaggio di commit per il test end-to-end in esecuzione
• Per progetti senza Git: Data e ora dell'esecuzione del test
• Numero di problemi che superano la 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 progetti mobili): Una percentuale (0–100%) che mostra quanto erano 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 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 stia introducendo ulteriori problemi di accessibilità. Per impostare il confronto, un amministratore di progetto deve impostare Watcher per funzionare sul ramo predefinito del repository - di solito si tratta del main (o master) ramo. Questa istanza del toolkit deve essere configurata come esecuzione del 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.

Per saperne di più su come configurare le esecuzioni del 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, sei in grado di vedere come l'ultimo commit su ciascun ramo si confronta con l'ultima esecuzione della pipeline sul branch predefinito.
  • Quando selezioni un branch individuale da visualizzare, puoi vedere come ogni singolo commit su quel branch si confronta con il commit che lo ha preceduto.
• Per i progetti Gitless: Ogni esecuzione di test viene 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 fatto clic su Visualizza Problemi da un branch, commit o esecuzione di test, vedrai una pagina riepilogativa che elenca e raggruppa le violazioni di 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 di 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 focalizzarti 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

Fare clic su Copia collegamento problema nella parte superiore della pagina per condividere con il tuo team o aggiungere al tuo sistema di tracciamento delle problematiche.

Permessi di condivisione: I collegamenti ai problemi rispettano le impostazioni di condivisione della tua organizzazione. I membri del team devono avere i permessi appropriati per visualizzare i problemi. Gli amministratori possono configurare le impostazioni di condivisione in:

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