Generare Rapporti con Java

Questa guida descrive come aggiungere il reporter di Axe DevTools al tuo progetto di test che già utilizza Axe DevTools per il Web.

Prerequisiti

L'integrazione del reporter richiede un setup di test Axe DevTools per il Web in esecuzione. Se non stai già ricevendo risultati di scansione da Axe DevTools per il Web, leggi la guida su come configurare Axe DevTools con Java.

Devi anche ottenere l'eseguibile del reporter, che può essere scaricato da Reporter Binario nella pagina dei Download. Assicurati di leggere la sezione Preparare i Binari dopo il Download.

Configurazione del Reporter

Per utilizzare il reporter, deve essere importato in una sua dichiarazione. Sostituisci <binding> con selenium, hamcrest o cucumber a seconda del pacchetto che utilizzi nella tua configurazione di test.

import com.deque.html.axedevtools.<binding>.*;
import com.deque.html.axedevtools.<binding>.reporter.*;

Poi, sono necessarie alcune istruzioni di inizializzazione. Sostituisci <reporter-binary> con il nome del tuo eseguibile del reporter. Vedi Prerequisiti sopra per maggiori informazioni su come ottenere l'eseguibile del reporter. Il suo nome dipenderà dal sistema operativo.

static String reporter = new File("src/test/resources/<reporter-binary>").getAbsolutePath();

Poi, inizializza la configurazione del tuo report

private AxeReportingOptions _reportOptions = new AxeReportingOptions();

E infine, specifica il nome della tua suite di test e la directory di output del file di log

AxeConfiguration.configure()
    .testSuiteName("<suite-name>")
    .outputDirectory("<log-directory-location>");

Scrivere Test con il Reporter

Durante l'esecuzione delle scansioni e la scrittura dei test, il logger salva i risultati delle tue scansioni su file in modo che il reporter possa accedervi e compilarli. Per ogni scansione di cui vuoi creare un report, aggiungi il metodo chain .logResults(). Qui, puoi dare un nome al tuo report per riferimento futuro.

.logResults(_reportOptions.uiState("<scan-name>"))

Generazione dei Rapporti

Infine, con il reporter configurato e i risultati registrati, il reporter può accedere e trasformare i risultati. Generalmente, questo passaggio viene eseguito dopo che tutte le scansioni in una suite di test sono state completate. Questo snippet di codice esegue il binario del reporter. Il reporter richiede tre argomenti: la posizione dei risultati del logger configurati in AxeConfiguration, la destinazione desiderata per il/i report completato/i e il loro formato desiderato. Per i setup di test locali, consigliamo di selezionare html. Per l'uso in CI, l'opzione xml produce report xml JUnit compatibili con molti ambienti CI. Per l'esportazione in altri strumenti, utilizza csv.

Runtime rt = Runtime.getRuntime();
String command = reporter + " <log-directory-location> <desired-destination> --format <desired-format>";
rt.exec(command);

Risoluzione dei Problemi

Se i problemi con il reporter persistono, contatta direttamente il tuo rappresentante Deque, raggiungici tramite il nostro assistenza clienti o inviarci un'e-mail. Saremo felici di aiutarti.

Vedi Anche

• Caricamento dei risultati di accessibilità JSON su Axe Reports descrive come caricare i tuoi risultati su Axe Reports.
• Ottenere una chiave API per Axe Reports spiega come ottenere una chiave API per iniziare a utilizzare Axe Reports.
• Creazione e filtraggio dei report mostra come puoi creare report di accessibilità in formato CSV, XML o HTML dai tuoi risultati di accessibilità JSON. Puoi anche filtrare il tuo output per gravità utilizzando questo strumento.
• Come vengono memorizzati i risultati JSON sul disco descrive le convenzioni di denominazione dei file per i risultati di accessibilità JSON.
• Utilizzo della CLI per inviare i risultati di accessibilità a Axe Developer Hub mostra come puoi caricare i tuoi file di risultati .json su Axe Developer Hub.