De CLI gebruiken om toegankelijkheidsresultaten naar Axe Developer Hub te sturen

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Bespreekt de verschillende manieren waarop je je toegankelijkheidsresultaten naar Axe Developer Hub kunt uploaden met behulp van de CLI

Not for use with personal data

De CLI stelt je in staat om je toegankelijkheidsresultaten naar Axe Developer Hub te sturen. Je kunt:

Resultaten uploaden van eerdere testuitvoeringen naar Axe Developer Hub. Deze optie maakt gebruik van de devhub CLI-subopdracht en stelt je in staat om resultaten van het analyseren van webpagina's met de web-API's of van eerdere CLI-uitvoeringen (waar je afzonderlijke pagina's hebt geanalyseerd of spec-bestanden hebt uitgevoerd en de resultaten hebt opgeslagen) te uploaden.
Individuele pagina's analyseren en stuur resultaten direct naar Axe Developer Hub (zonder eerst resultatenbestanden op te slaan).
Specificatiebestanden uitvoeren en stuur de resultaten direct naar Axe Developer Hub (zonder eerst resultatenbestanden op te slaan).

Vereisten

Om de CLI met Axe Developer Hub te gebruiken, heb je het volgende nodig:

Een Axe-account en een abonnement voor Axe Developer Hub. Zie Aan de slag met Axe Developer Hub voor meer informatie.
Een Axe Developer Hub-project waar je resultaten kunt uploaden. Zie Een nieuw Axe Developer Hub-project aanmaken voor informatie over het aanmaken van een nieuw project. Wanneer je een project aanmaakt, geef je aan dat het project de CLI als invoer- of gegevensbron zal gebruiken. Je hebt deze waarden nodig om resultaten te uploaden:
- Je persoonlijke API-sleutel (getoond in je Axe-account onder API-sleutels)
- Je project-ID (getoond in de instructies wanneer je een nieuw Axe Developer Hub-project aanmaakt)
(Optioneel) Als u tests heeft die de web-API's gebruiken, moet u uw tests aanpassen om een resultatenbestand of bestanden te produceren. Een resultatenbestand is een .json-bestand met de resultaten van uw testrun, en de procedure voor het maken van resultatenbestanden verschilt afhankelijk van de API die u gebruikt. Voor meer details, zie Resultatenbestanden maken. U gebruikt het devhub subcommand om resultatenbestanden te uploaden.

Resultaten naar Axe Developer Hub sturen

Normaal gesproken voert de CLI tests uit op websites en genereert het resultaten alleen wanneer je de -s optie gebruikt om resultaten op te slaan (wat .json bestanden zijn met informatie over toegankelijkheidsfouten in de geteste websites). Je kunt je resultaten naar Axe Developer Hub sturen door een API-sleutel op te geven op de opdrachtregel met de --axe-devhub-api-key opdrachtregeloptie (of door de AXE_DEVHUB_API_KEY omgevingsvariabele in te stellen) en een project-ID met de --axe-devhub-project-id (of door de AXE_DEVHUB_PROJECT_ID omgevingsvariabele in te stellen).

Standaard uploadt de CLI ook Git-informatie als de directory waarin u de CLI uitvoert deel uitmaakt van een Git-repository. Zie Git versus Gitless-modus voor informatie over hoe het uploaden van Git-informatie werkt.

De CLI koppelt de huidige Git-branch en commitgeschiedenis aan uw toegankelijkheidsresultaten.

important

Wanneer je de CLI uitvoert vanuit een directory binnen een Git-repository, zullen de resultaten die je naar Axe Developer Hub stuurt eventuele eerdere resultaten van dezelfde commit overschrijven (bepaald door de SHA ervan). (Slechts één set resultaten kan worden geassocieerd met elke commit.) Je moet elke keer dat je de CLI uitvoert een nieuwe commit maken of afzien van het rapporteren van Git-resultaten door de --no-git-data optie te gebruiken. Zie Git versus Gitless-modus voor meer informatie.

Resultaten uploaden

Als je eerder tests hebt uitgevoerd en resultatenbestanden hebt (.json bestanden, doorgaans met namen zoals axe-result-2025-09-03T14 02 32-0700.json), kun je deze resultaten uploaden naar Axe Developer Hub met de devhub subopdracht. Je kunt resultaten opslaan door de -s opdrachtregeloptie te gebruiken bij het testen van pagina's of het uitvoeren van spec-bestanden:

axe https://example.com -s

tip

Bij het analyseren van een pagina of het uitvoeren van een specificatiebestand, hoeft u de resultaten niet eerst op te slaan en vervolgens te uploaden. Door een API-sleutel en project-ID op te geven, zal de CLI de resultaten uploaden zodra uw paginanalyse is voltooid of wanneer uw specificatiebestand klaar is met uitvoeren. Zie Individuele pagina's analyseren en Spec-bestanden uitvoeren.

Het vorige voorbeeld maakt een resultatenbestand aan dat je vervolgens naar Axe Developer Hub kunt uploaden, zoals hieronder getoond:

axe devhub <results-dir(s)-or-file(s)> --axe-devhub-api-key <your-API-key> --axe-devhub-project-id <your-project-ID>

U kunt . (punt) gebruiken als de resultaten-dir(s)-of-bestand(en) om alle .json resultatenbestanden in de huidige directory te uploaden. U kunt ook meerdere directories of bestanden specificeren om te uploaden.

Resultatenbestanden maken met de web-API's

Als je de web-API's gebruikt, moet je je API-tests aanpassen om resultatenbestanden te schrijven die je vervolgens kunt uploaden naar Axe Developer Hub met behulp van de devhub subopdracht. De volgende tabel bevat links naar informatie over het maken van resultatenbestanden, en deze API's gebruiken de rapportage- of log-API's die worden verstrekt om resultaten als .json bestanden naar de schijf te schrijven.

API	Linknaam
Node.js	Axe DevTools Logger
C#	JSON-compatibele rapporten maken
Java	Rapporten genereren met Java
Python	JSON-compatibele rapporten maken
Ruby	Rapporteeropties

Individuele pagina's analyseren

Je kunt afzonderlijke webpagina's scannen en de resultaten naar Axe Developer Hub sturen door een API-sleutel en de project-ID voor het project dat de resultaten moet ontvangen op te geven:

axe https://google.com --axe-devhub-api-key <your-API-key> --axe-devhub-project-id <your-project-ID>

In dit voorbeeld voert de CLI toegankelijkheidstests uit op de site van Google en stuurt vervolgens de resultaten naar het Axe Developer Hub-project dat door het opgegeven project-ID wordt aangegeven.

Je kunt ook meerdere pagina's op de commandoregel opgeven om te testen:

axe https://example.com/page1.html https://example.com/page2.html --axe-devhub-api-key <your-API-key> --axe-devhub-project-id <your-project-ID>

Bezoek het project op Axe Developer Hub om je resultaten te zien. Zie Overzicht van het bekijken van toegankelijkheidsproblemen.

Spec-bestanden uitvoeren

Je kunt de resultaten van het uitvoeren van je spec-bestanden verzenden met behulp van de --axe-devhub-api-key en --axe-devhub-project-id commandoregelopties.

axe spec my-spec-file.yml --axe-devhub-api-key <your-API-key> --axe-devhub-project-id <your-project-ID>

Dit voorbeeld voert het YAML-spec-bestand my-spec-file.yml uit en uploadt de toegankelijkheidsresultaten naar Axe Developer Hub. Zie Workflow Specificaties en Workflow Acties voor meer informatie over spec-bestanden.

tip

Als je in je spec-bestand moet overslaan door testen van pagina's over te slaan, kun je de --resume-from <page> commandoregeloptie gebruiken om je tests te hervatten vanaf een specifieke pagina in je spec-bestand. Zie Hervatten van voor meer informatie.

Git versus Gitless-modus

Standaard associeert Axe Developer Hub je toegankelijkheidsresultaten met de laatste Git-commit op de huidige branch wanneer je de CLI uit een directory binnen een Git-repository uitvoert, waardoor je toegankelijkheidsfouten gemakkelijk aan Git-commits kunt koppelen. Een bijwerking van dit gedrag is echter dat wanneer je resultaten rapporteert aan Axe Developer Hub, nieuwe resultaten alle andere uitvoeringen overschrijven op dezelfde commit (gebaseerd op de SHA ervan). Daarnaast, als je naar een andere branch schakelt, zullen alle resultaten die je naar Axe Developer Hub stuurt worden geassocieerd met de laatste commit op die branch.

Als het standaardgedrag van Axe Developer Hub niet je voorkeur heeft:

Je kunt de CLI in een directory buiten een Git-repository gebruiken.
Je kunt de --no-git-data commandoregeloptie gebruiken om het rapporteren van Git-informatie aan de server over te slaan, werkend in wat wordt genoemd Gitless modus waarin elke keer dat je resultaten naar de server rapporteert, een nieuwe testrun wordt aangemaakt en geïdentificeerd door tijd en datum van de uitvoering in plaats van de branch en commit zoals bij het uitvoeren in Git modus.

Zie De pagina's van je project en De Test Uitvoeringen-pagina voor informatie over hoe Git- en Gitless-resultaten zijn georganiseerd en gepresenteerd in Axe Developer Hub.

Commandoregelopties

De CLI accepteert deze commandoregelopties:

--axe-devhub-api-key Hiermee kun je je persoonlijke API-sleutel instellen, gelijk aan de AXE_DEVHUB_API_KEY omgevingsvariabele. Vereist
--axe-devhub-project-id Stelt de project-ID voor je Axe Developer Hub-project in, gelijk aan de AXE_DEVHUB_PROJECT_ID omgevingsvariabele. Vereist
--axe-devhub-server-url Hiermee kun je een andere server dan de standaard gebruiken (https://axe.deque.com), gelijk aan de AXE_DEVHUB_SERVER_URL omgevingsvariabele. Stel dit in als je organisatie een regionale instantie, private cloud of on-premise implementatie van Axe Developer Hub gebruikt. Optioneel
--no-git-data Voorkomt het rapporteren van Git-informatie aan de server. Zie Git versus Gitless-modus voor meer informatie. Heeft geen overeenkomstige omgevingsvariabele. Optioneel

Omgevingsvariabelen

Je kunt omgevingsvariabelen instellen om te voorkomen dat je de API-sleutel, het project-ID of de server-URL op de commandoregel hoeft op te geven, wat wordt aanbevolen bij gebruik van de API-sleutel in continue integratie om deze geheim te houden.

tip

Door AXE_DEVHUB_API_KEY en AXE_DEVHUB_PROJECT_ID in te stellen zal altijd resultaten sturen naar Axe Developer Hub wanneer je een pagina analyseert of een spec-bestand uitvoert. Als je bijvoorbeeld deze omgevingsvariabelen hebt ingesteld en een pagina analyseert met:

axe https://somewebsite.com

De resultaten zullen worden verzonden naar Axe Developer Hub. Dit gedrag geldt wanneer je de CLI gebruikt om een pagina analyseren of een spec-bestand uitvoeren.

AXE_DEVHUB_API_KEY Geeft je persoonlijke API-sleutel aan, gelijk aan de --axe-devhub-api-key commandoregeloptie.
AXE_DEVHUB_PROJECT_ID Geeft de project-ID voor je Axe Developer Hub-project op, gelijk aan de --axe-devhub-project-id opdrachtregeloptie.
AXE_DEVHUB_SERVER_URL Geeft de Axe Developer Hub server-URL aan (standaard is https://axe.deque.com), gelijk aan de --axe-devhub-server-url commandoregeloptie. Stel dit in als je organisatie een regionale instantie, private cloud of on-premise implementatie van Axe Developer Hub gebruikt.