Problemen oplossen

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

Gids om problemen op te lossen die je kunt tegenkomen bij het gebruik van Axe Developer Hub

Not for use with personal data

Een project openen toont „Geen scandata beschikbaar“

Als je al toegankelijkheidsscans hebt uitgevoerd en je verwacht resultaten te zien, moet je de projectconfiguratie controleren.

Controleer je API-sleutel

Uw persoonlijke API-sleutel moet compatibel zijn met uw projecttype. Voor projecten die Axe Watcher, Web-API's of CLI integreren, moet u een Axe Developer Hub API-sleutel gebruiken. Voor mobiele projecten moet u een Axe DevTools voor Mobile API-sleutel gebruiken. Om een API-sleutel aan te maken, moet u een actieve licentie hebben voor Axe Developer Hub en/of Axe DevTools voor Mobile. Zodra u toegang hebt, bezoek API-sleutels om een nieuwe sleutel toe te voegen.

  1. Klik op de + NIEUWE API-SLEUTEL TOEVOEGEN knop, en u ziet een pop-upvenster zoals hieronder afgebeeld: Een NIEUWE API-SLEUTEL TOEVOEGEN-modus, die het product toont als „Axe DevTools voor Mobiel“
  2. Selecteer Axe Developer Hub of Axe DevTools voor Mobile in het Product keuzemenu.
  3. Geef de API-sleutel een Naam.
  4. Klik op Opslaan.

Na enkele seconden wordt de bijgewerkte pagina Beheer API-sleutels weergegeven, samen met een bericht dat de API-sleutel succesvol is toegevoegd.

Klik in de Acties kolom van uw API-sleutels om een API-sleutel naar het klembord te kopiëren. U zou dan een bericht moeten zien dat de API-sleutel succesvol is gekopieerd.

Wanneer u je project instelt instelt, heeft u mogelijk code gekopieerd en geplakt in uw end-to-end tests. Bekijk deze code en zorg ervoor dat u API_KEY hebt vervangen door de bijbehorende API-sleutel.

Controleer je project-ID

Om uw Project-ID te vinden, navigeer naar de Installatie-instructies vanaf de Projectenpagina. Open het Instellingenmenu voor uw project en selecteer Project configureren. U zult de Project-ID zien, die u kunt aanklikken en naar het klembord kunt kopiëren. Bekijk de code die u hebt gekopieerd en geplakt in uw end-to-end tests tijdens de projectinstallatie en zorg ervoor dat u alle instanties van PROJECT_ID hebt vervangen door de bijbehorende Project-ID.

Controleer of scanuitvoer geen fouten toont

In het venster waarin je test wordt uitgevoerd, kunnen er fouten zijn opgetreden waardoor de resultaten niet naar Axe Developer Hub zijn verzonden. Bekijk deze fouten zorgvuldig en los ze op.

Controleer of de test succesvol is voltooid

Als je test nog aan het draaien is, zijn je resultaten mogelijk nog niet naar Developer Hub verzonden. Wacht tot je test succesvol is voltooid en ververs dan de pagina om je resultaten te zien.

Geen resultaten voor alle scans

Als u meerdere keren dezelfde commit scant (dezelfde commit-SHA), kunnen de resultaten "overschreven" worden om alleen de laatste te tonen. Wanneer er gebruik wordt gemaakt van Git-gegevens, moet u een nieuwe commit aanmaken om nieuwe scans te kunnen zien. Als u niet elke keer een nieuwe commit wilt aanmaken wanneer u de test uitvoert, en dit project is nog niet Git-locked, kunt u het probleem vermijden door Gitloze tests te gebruiken.

Om een Gitless-weergave van een testsuite te krijgen, stuur de resultaten naar een apart, Gitless-vergrendeld project in plaats van te proberen de gegevensvorm van een bestaand project te wijzigen. Zodra een project bij de eerste succesvolle sessie op Git is vergrendeld, leidt het verwijderen van de .git-map of het uitschakelen van het verzamelen van Git-gegevens niet meer tot een Gitless-sessie: de run wordt in plaats daarvan geweigerd. Zie Run geweigerd: gegevensvorm of repository komt niet overeen met het project voor hoe de weigering eruitziet en hoe deze op te lossen.

Als goede gewoonte moet u de testset uitvoeren telkens wanneer een nieuwe commit wordt aangemaakt.

Git-data komt niet overeen met code

Als end-to-end tests worden uitgevoerd in een repository die gescheiden is van de code die u test, worden de getoonde Git-gegevens voor de test weergegeven, niet de code die u test. Als dit verwarring veroorzaakt en dit project is nog niet Git-locked, vermijdt u dit door Gitloze tests te gebruiken.

Om een Gitless-weergave van een testsuite te krijgen, stuur de resultaten naar een apart, Gitless-vergrendeld project in plaats van te proberen de gegevensvorm van een bestaand project te wijzigen. Zodra een project bij de eerste succesvolle sessie op Git is vergrendeld, leidt het verwijderen van de .git-map of het uitschakelen van het verzamelen van Git-gegevens niet meer tot een Gitless-sessie: de run wordt in plaats daarvan geweigerd. Zie Run geweigerd: gegevensvorm of repository komt niet overeen met het project voor hoe de weigering eruitziet en hoe deze op te lossen.

Als goede gewoonte raden we aan om de end-to-end tests in dezelfde repository te houden als de code die u test.

Run afgewezen: Gegevensvorm of repository komt niet overeen met het project

Zodra een project zijn eerste succesvolle sessie heeft opgenomen, zijn de gegevensvorm (Git of Gitloos) en, voor Git-projecten, de repository vergrendeld. Een run die niet overeenkomt met de vergrendeling wordt bij de opname afgewezen en de resultaten worden niet opgeslagen. Het afwijzingsbericht noemt wat het project verwacht, wat de run heeft verstuurd en wat eraan te doen is, bijvoorbeeld:

This project is locked to a different repository. Project expects {lockedRepo}; this run sent {incomingRepo}. The results were not ingested. Send this run to its own Axe Developer Hub project, or check that CI is providing git information for the locked repository.

Veelvoorkomende oorzaken en hoe deze op te lossen:

  • Een tweede repository of testset is gericht op hetzelfde project. Stuur het naar een eigen project in plaats van naar het project dat al vergrendeld is aan een andere repository.
  • Een ondiepe kloon, een losgekoppelde HEAD-status of een ontbrekende origin remote verwijdert de repository-URL, de branch of de commit-SHA uit de CI waardoor een Git-run eruitziet als een Gitloze run. Controleer of uw CI-configuratie volledige Git-informatie levert. Zie Axe Watcher in Continuous Integration (CI)-omgevingen voor CI-specifieke richtlijnen.
  • Het verzamelen van Git-gegevens was uitgeschakeld op een project dat al aan Git was vergrendeld. Het versturen van een run met git: false of met de map .git verwijderd, zet het project niet langer om naar Gitloos; de run wordt afgewezen. Stuur Gitloze runs naar een afzonderlijk Gitloos project.

Uitvoering Geweigerd: Webclient Stuurde Resultaten naar een Mobiel Project

Axe Watcher en de Axe DevTools CLI kunnen resultaten alleen naar een webproject sturen. Als de project-ID in je testconfiguratie bij een mobiel project hoort, wordt de sessie geweigerd bij het starten en worden er geen resultaten opgeslagen. De foutmelding luidt:

This is a mobile project. Axe Watcher and the axe DevTools CLI can only send results to a web project.

Om dit op te lossen, controleer je project-ID en vervang deze door de ID van een webproject, waarbij je er een kunt aanmaken indien nodig. Mobiele projecten ontvangen alleen resultaten van de Axe DevTools mobiele tools.

Hulp

Bezoek support.deque.com om artikelen uit de kennisbank, statusrapporten van Deque's SaaS-producten en andere productondersteuning te raadplegen. Als u uw probleem niet kunt oplossen, neem dan alstublieft stuur ons een e-mail contact met ons op zodat we u kunnen helpen.