Generare report con Java

Questa guida spiega come aggiungere il generatore di rapporti axe DevTools al tuo progetto di test che sfrutta già axe DevTools for Web.

Prerequisiti

Per integrare il generatore di rapporti è necessario che sia in esecuzione axe DevTools per la configurazione dei test Web. Se non stai ancora ottenendo i risultati della scansione di axe DevTools per Web, leggi la guida su come configurare axe DevTools con Java.

È inoltre necessario ottenere l'eseguibile del reporter, che può essere scaricato da Binary Reporter nella pagina Download. Assicurati di consultare la sezione Preparazione dei file binari dopo il download.

Impostazione del reporter

Per utilizzare il reporter, è necessario importarlo in una propria dichiarazione. Sostituire <binding> con selenio, hamcrest o Cucumber a seconda del pacchetto utilizzato nella configurazione di test.

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

Sono quindi necessarie alcune istruzioni di inizializzazione. Sostituire <reporter-binary> Con il nome del tuo reporter file eseguibile. Per ulteriori informazioni su come ottenere l'eseguibile del reporter, vedere Prerequisiti sopra. Il suo nome dipenderà dal sistema operativo.

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

Quindi, inizializza la configurazione del reporting

private AxeReportingOptions _reportOptions = new AxeReportingOptions();

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

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 scansioni su file, in modo che il reporter possa accedervi e compilarli. Per ogni scansione di cui vuoi creare un report, aggiungere il metodo a catena .logResults(). Qui puoi dare un nome al tuo report per riferimento futuro.

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

Generazione di report

Infine, una volta configurato il reporter e registrati i risultati, il reporter può accedervi e trasformarli. In genere, questo passaggio viene eseguito dopo il completamento di tutte le scansioni in una suite di test. Questo frammento di codice esegue il binario del reporter. Il reporter accetta tre argomenti: la posizione dei risultati del logger impostata in AxeConfiguration, la destinazione desiderata per i report completati e il formato desiderato. Per le configurazioni di test locali, consigliamo di selezionare html. Per l'utilizzo di CI, l'opzione xml produce report XML JUnit compatibili con molti ambienti CI. Per esportare verso altri strumenti, utilizzare 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, contattaci tramite il nostro support desk o inviaci un'e-mail. Saremo lieti di aiutarti.

Vedere anche

• Caricamento dei risultati di accessibilità JSON su axe Reports descrive come caricare i 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 di report mostra come creare report di accessibilità in formato CSV, XML o HTML a partire dai risultati di accessibilità JSON. Utilizzando questo strumento puoi anche filtrare l'output in base alla gravità.
• Come vengono archiviati i risultati JSON su disco descrive le convenzioni di denominazione dei file per i risultati di accessibilità JSON.