Begrijp Resultaten
Bekijk en beheer toegankelijkheidsproblemen met Axe Developer Hub
Na het volgen van de installatie-instructies van je toolkit, zal je resultaten genereren die naar Developer Hub worden gestuurd telkens je je test suite draait. In Developer Hub kun je nieuwe en bestaande toegankelijkheidsproblemen bekijken en trends door de tijd heen volgen.
Begrip van Je Projectstructuur
Developer Hub organiseert je toegankelijkheidsdata anders afhankelijk van of je end-to-end tests Git gebruiken voor versiebeheer:
Wanneer je Git gebruikt, kun je verschillende branches van je project bekijken en individuele commits die op deze branches zijn gemaakt. De structuur is als volgt:
Project → Branches → Commits → Probleemlijst → Probleemdetails
Git-data wordt automatisch verzameld voor Axe Watcher-projecten. Git-informatie komt overeen met de end-to-end test, wat mogelijk niet exact overeenkomt met de feitelijke code die wordt getest als de code zich in een andere repository bevindt dan de end-to-end test.
Gebruik onze API's om de verzameling van Git-data voor je Watcher-project uit te schakelen:
Als je Git niet gebruikt met je webproject, of als je een mobiel project bekijkt, zie je individuele testuitvoeringen en kun je navigeren naar de problemen gevonden in elke uitvoering. De structuur is als volgt:
Project → Testuitvoeringen → Probleemlijst → Probleemdetails
Werken met Je Resultaten
Wanneer je een project opent, zie je ofwel een lijst met branches (Git-projecten) of testuitvoeringen (Gitloze projecten).
Je Resultaten in Één Oogopslag
Je zult de volgende informatie te zien krijgen van je toegankelijkheidstesten:
- Voor Git-projecten: Branched naam, laatste commit SHA, en commitbericht voor de end-to-end test die wordt uitgevoerd
- Voor Gitloze projecten: Tijdstip van de testuitvoering
- Aantal problemen dat de toegankelijkheidsdrempel
- Pakket- en versie-informatie van de toegankelijkheidstoolkit die je gebruikt
- Vergelijkingssamenvatting met totaal aantal problemen en het aantal scans
- Een telling van nieuwe problemen geïntroduceerd en problemen die zijn opgelost (alleen webprojecten)
- Toegankelijkheidsscore (alleen mobiele projecten): Een percentage (0–100%) dat aangeeft hoe toegankelijk de scans van de sessie waren, hieronder gedetailleerd in Toegankelijkheidsscore (Alleen Mobiele Projecten)
- ‘Commits Bekijken’ knop (alleen Git-projecten) om in detail naar individuele commits te kijken
- ‘Problemen Bekijken’ knop om de volledige lijst van problemen te zien
Toegankelijkheidsscore (Alleen Mobiele Projecten)
De toegankelijkheidsscore is een percentage (0–100%) dat wordt getoond op de rapportpagina's van mobiele sessies. Een hogere score betekent minder ernstige toegankelijkheidsproblemen tijdens de sessie.
De score wordt in twee stappen berekend:
-
Elke scan krijgt een score op basis van het meest ernstige toegankelijkheidsprobleem:
- 100% — alleen geringe problemen, of helemaal geen problemen
- 80% — minimaal één matig probleem; geen ernstige of kritieke problemen
- 40% — minimaal één ernstig probleem; geen kritieke problemen
- 0% — minimaal één kritiek probleem
-
De sessiescore is het gemiddelde van alle scanscores.
Een sessie met drie scans, waarvan één alleen geringe problemen heeft, één met een ernstig probleem en één met een kritiek probleem, zou bijvoorbeeld een score van (100 + 40 + 0) / 3 ≈ 47% krijgen.
Sessies zonder scans tonen een lege staat in plaats van 0%.
Voor de volledige specificatie van de formule, zie Bereken een Score in de documentatie van Axe DevTools Mobile.
De toegankelijkheidsscore verschijnt alleen op pagina's van mobiele sessies.
Sessies Hernoemen
Standaard worden sessies geïdentificeerd door hun git-branch en commit-informatie (Git-projecten) of tijdstempel (Gitloze projecten). Je kunt een aangepaste weergavenaam instellen op elke sessie om het gemakkelijker te maken specifieke scanuitvoeringen te identificeren.
Aangepaste namen verschijnen overal in Developer Hub waar een sessie wordt genoemd: paginakoppen, paneeltitels, broodkruimels, en vergelijkingslabels. De originele git- of tijdstempelidentificatie blijft zichtbaar in een metadata-gedeelte op de probleempagina.
Om een sessie te hernoemen, open je de probleempagina en klik je op de bewerkknop in de paginakop. Project Admins, Bijdragers en Org Admins kunnen elke sessie in het project hernoemen.
Pipeline-informatie
Voor teams waarvan de tests Git-data gebruiken met Axe Watcher, kunnen alle uitvoeringen worden vergeleken met de CI/CD-uitvoeringen op de standaardbranch, om te garanderen dat nieuw toegevoegde code geen extra toegankelijkheidsproblemen introduceert. Om de vergelijking in te stellen, moet een projectbeheerder Watcher instellen om op de standaardbranch van de repository te draaien - dit is meestal de main (of master) branch. Deze instantie van de toolkit moet worden ingesteld als een pipeline-uitvoering.
Zodra scangegevens binnenkomen van de aangewezen pipeline-uitvoering op de standaardbranch, zullen de resultaten bovenaan de pagina worden weergegeven. Gebruikers kunnen ervoor kiezen om verschillende resultaatsets te bekijken op API-sleutel en zien hoe ze zich verhouden tot de pipeline-uitvoering op de standaardbranch.
Leer meer over het opzetten van pipeline-uitvoeringen met Axe Watcher in Continu Integratie (CI) Omgevingen
Inzicht in Vergelijkingen
De vergelijkingsinformatie die wordt geboden voor webprojecten helpt je te begrijpen wat er veranderd is:
- Voor Git-projecten:
- Op de pagina die alle branches van je project weergeeft, kun je zien hoe de laatste commit op elke branch vergelijkt met de nieuwste pijplijnuitvoering op de standaardbranch.
- Wanneer je een individuele branch selecteert om te bekijken, kun je zien hoe elke unieke commit op die branch zich vergelijkt met de commit die ervoor kwam.
- Voor Gitless-projecten: Elke testuitvoering wordt vergeleken met de vorige uitvoering.
Als je geen vergelijkingsgegevens ziet, is het waarschijnlijk dat er geen eerdere scan beschikbaar was om mee te vergelijken, of dat er nog geen pijplijnscan is uitgevoerd op de standaardbranch.
Lees meer over het gebruik van vergelijkingen om trends te volgen
Meer leren over toegankelijkheidsproblemen
Na het klikken op Problemen bekijken vanaf een branch, commit of testuitvoering, zie je een overzichtspagina die toegankelijkheidsproblemen weergeeft en groepeert op basis van regels en impactniveau.
Vergelijkingstabel (alleen voor webprojecten)
Webprojecten tonen bovenaan een vergelijkingstabel die het volgende toont:
- Totale problemen in huidige en baseline scans
- Nieuwe geïntroduceerde problemen
- Voorheen bestaande problemen
- Problemen die zijn opgelost
- Al deze zijn gegroepeerd op impacternst (Kritiek, Ernstig, Matig, Klein)
Opmerking: Mobiele projecten bevatten deze vergelijkingstabel niet.
Regellijst
Onder de vergelijkingssectie (of bovenaan voor mobiel) zie je alle geschonden toegankelijkheidsregels gegroepeerd op:
- Regelnaam (die je kunt selecteren om individuele problemen te bekijken)
- Impactniveau
- Aantal overtredingen gevonden voor die regel
Filteren en exporteren
Bij webprojectengebruik je de filterbedieningselementen om je te richten op specifieke problemen:
- Filteren op impactniveau (Kritiek, Ernstig, Matig, Klein)
- Toon alleen nieuwe problemen
- Selecteer specifieke paginastaten
Bij mobiele projectengebruik je de filter om één of meerdere schermen in de lijst te selecteren en je te richten op bepaalde resultaten.
Exporteer je resultaten:
- Web
- Exporteer JSON om gedetailleerde resultaten gemakkelijk in een voor mensen leesbaar formaat te delen
- Exporteer CSV voor spreadsheets en rapportages
- Mobiel
- Exporteer Axe Universal JSON-formaat voor integratie met andere tools
Exporten zullen in lijn zijn met je huidige filters.
Pagina Eén Probleem
Klik op een regeltje in de lijst met problemen om gedetailleerde informatie te zien over elke overtreding.
Problemen vinden in je code
Webprojecten bieden:
- Broncode van element (HTML-fragment)
- CSS-selector voor het lokaliseren van het element
- XPath-expressie als een alternatieve locator
- Alle met kopieerknoppen voor eenvoudig gebruik in uw ontwikkelingstools
Mobiele projecten bieden:
- Screenshot met het probleem gemarkeerd
- Detailsweergave: Geeft context voor het problematische element
- Inspectie Hiërarchie-weergave: Toont de hiërarchiebomen zodat u de exacte locatie kunt bepalen en gedetailleerde elementeigenschappen kunt zien
Begeleiding bij Herstel
Elk probleem bevat:
- Regelbeschrijving die het toegankelijkheidsprobleem uitlegt
- Links naar Deque University of Mobiele Regel-pagina's voor uitgebreide begeleiding en codevoorbeelden
- Impactniveau en toegankelijkheidstags (WCAG-criteria, best practices)
- Navigatie om alle gevallen van deze overtreding door te lopen (bijv. „1 van 5“)
Problemen Delen
Klik op Kopieer link van probleem bovenaan de pagina om te delen met uw team of toe te voegen aan uw probleemvolgsysteem.
Deelrechten: Probleemlinks respecteren de deeleinstellungen van uw organisatie. Teamleden hebben de juiste rechten nodig om problemen te bekijken. Beheerders kunnen de deelinstellingen configureren in:
- Globale Configuratie - Stel organisatiebrede standaardinstellingen voor delen in
- Projectinstellingen - Toegang en updates van instellingen voor individuele projecten in Axe Developer Hub
