Rapporten Genereren met Java
De Axe DevTools for Web reporter gebruiken met Java
Deze gids beschrijft het toevoegen van de Axe DevTools-reporter aan uw testproject dat al gebruikmaakt van Axe DevTools for Web.
Vereisten
Het integreren van de reporter vereist een draaiende Axe DevTools for Web testopstelling. Als u nog geen Axe DevTools for Web-scanresultaten ontvangt, lees dan de handleiding over hoe u Axe DevTools instellen met Java.
U moet ook het uitvoerbare bestand van de reporter verkrijgen, dat kan worden gedownload van Binaire Reporter op de Downloadpagina. Zorg ervoor dat u de sectie Binaries Voorbereiden na Downloaden bekijkt.
De Reporter Instellen
Om de reporter te gebruiken, moet het worden geïmporteerd in een eigen instructie. Vervang <binding> door selenium, hamcrest of cucumber afhankelijk van welk pakket u gebruikt in uw testopstelling.
import com.deque.html.axedevtools.<binding>.*;
import com.deque.html.axedevtools.<binding>.reporter.*;Vervolgens zijn een paar initialisatie-instructies vereist. Vervang <reporter-binary> door de naam van uw uitvoerbare reporterbestand. Zie Vereisten hierboven voor meer informatie over het verkrijgen van het uitvoerbare reporterbestand. De naam is afhankelijk van het besturingssysteem.
static String reporter = new File("src/test/resources/<reporter-binary>").getAbsolutePath();Vervolgens, initialiseer uw rapportageconfiguratie
private AxeReportingOptions _reportOptions = new AxeReportingOptions();En ten slotte, specificeer de naam van uw testpakket en het uitvoerbestandspad voor de logbestanden
AxeConfiguration.configure()
.testSuiteName("<suite-name>")
.outputDirectory("<log-directory-location>");Tests Schrijven met de Reporter
Tijdens het uitvoeren van scans en het schrijven van tests, slaat de logger uw scanresultaten op in een bestand zodat de reporter ze kan openen en samenstellen. Voor elke scan waarvan u een rapport wilt maken, voegt u de .logResults() ketenmethode toe. Hier kunt u uw rapport een naam geven voor toekomstig gebruik.
.logResults(_reportOptions.uiState("<scan-name>"))Rapporten Genereren
Tenslotte, met de reporter geconfigureerd en resultaten gelogd, kan de reporter de resultaten openen en omzetten. Over het algemeen wordt deze stap uitgevoerd nadat alle scans in een testpakket zijn voltooid. Dit codefragment voert de binaire reporter uit. De reporter neemt drie argumenten: de locatie van de resultaten van de logger ingesteld in de AxeConfiguration, de gewenste bestemming voor de voltooide rapport(en), en hun gewenste formaat. Voor lokale testopstellingen raden we aan om html te selecteren. Voor CI-gebruik produceert de xml optie JUnit xml-rapporten die compatibel zijn met veel CI-omgevingen. Voor export naar andere tools, gebruik csv.
Runtime rt = Runtime.getRuntime();
String command = reporter + " <log-directory-location> <desired-destination> --format <desired-format>";
rt.exec(command);Problemen Oplossen
Als problemen met de reporter aanhouden, neem dan direct contact op met uw Deque-vertegenwoordiger, bereik ons via onze ondersteuningsdesk, of stuur ons een e-mail. We helpen u graag.
Zie Ook
- Uploaden van JSON-toegankelijkheidsresultaten naar axe Reports beschrijft hoe u uw resultaten kunt uploaden naar axe Reports.
- Verkrijgen van een axe Reports API-sleutel legt uit hoe u een API-sleutel kunt verkrijgen om te beginnen met het gebruik van axe Reports.
- Rapporten maken en filteren laat zien hoe u toegankelijkheidsrapporten kunt maken in CSV, XML of HTML op basis van uw JSON-toegankelijkheidsresultaten. U kunt uw output ook filteren op ernst met dit hulpmiddel.
- Hoe JSON-resultaten op schijf worden opgeslagen beschrijft de naamgevingsconventies voor JSON-toegankelijkheidsresultaten.
- De CLI gebruiken om toegankelijkheidsresultaten naar axe Developer Hub te sturen laat zien hoe u uw
.jsonresultatenbestanden kunt uploaden naar axe Developer Hub.
