Dépannage

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

Conseils pour résoudre les problèmes que vous pouvez rencontrer lors de l'utilisation de Axe Developer Hub

Not for use with personal data

L'ouverture d'un projet affiche « Pas de données de scan disponibles »

Si vous avez déjà effectué des scans d'accessibilité et que vous vous attendez à voir des résultats, vous devriez vérifier la configuration du projet.

Vérifiez votre clé API

Votre clé API personnelle doit être compatible avec le type de projet. Pour les projets intégrant Axe Watcher, les API Web ou la CLI, vous devez utiliser une clé API de l'Axe Developer Hub. Pour les projets mobiles, vous devez utiliser une clé API Axe DevTools for Mobile. Pour créer une clé API, vous devez avoir une licence active pour Axe Developer Hub et/ou Axe DevTools for Mobile. Une fois que vous avez accès, visitez Clés API pour ajouter une nouvelle clé.

Cliquez sur le bouton + AJOUTER UNE NOUVELLE CLÉ API, et vous verrez une fenêtre pop-up comme celle illustrée ci-dessous :
Sélectionnez Axe Developer Hub ou Axe DevTools for Mobile sous le menu déroulant Produit.
Donnez un Nom à la clé API.
Cliquez sur Enregistrer.

Après quelques secondes, la page Gérer les clés API mise à jour sera affichée ainsi qu'un message indiquant que la clé API a été ajoutée avec succès.

Dans la colonne Actions pour vos clés API, cliquez pour copier une clé API dans le presse-papiers. Vous devriez alors voir un message indiquant que la clé API a été copiée avec succès.

Lorsque vous avez configuréla configuration de votre projet,, vous avez peut-être copié et collé du code dans vos tests de bout en bout. Vérifiez ce code et assurez-vous d'avoir remplacé API_KEY par la clé API correspondante.

Vérifiez votre ID de projet

Pour trouver votre ID de projet, accédez aux instructions d'installation depuis la page Projets. Ouvrez le menu déroulant des paramètres de votre projet et sélectionnez Configurer le Projet. Vous verrez l'ID de projet, que vous pouvez cliquer et copier dans le presse-papiers. Vérifiez le code que vous avez copié et collé dans vos tests de bout en bout pendant la configuration du projet et assurez-vous d'avoir remplacé toutes les occurrences de PROJECT_ID par l'ID de projet correspondant.

Vérifiez que la sortie du scan n'affiche pas d'erreurs

Dans la fenêtre exécutant votre test, vous pouvez avoir des erreurs qui ont empêché les résultats d'être envoyés à Axe Developer Hub. Examinez attentivement ces erreurs et résolvez-les.

Vérifiez que le test s'est terminé avec succès

Si votre test est toujours en cours, vos résultats peuvent ne pas avoir été envoyés à Developer Hub. Attendez que votre test soit terminé avec succès, puis actualisez la page pour voir vos résultats.

Ne voyez pas les résultats pour tous les scans

Si vous analysez plusieurs fois le même commit (même SHA de commit), les résultats peuvent être "écrasés" pour n'afficher que le dernier. Lorsque les données Git sont utilisées, vous devez créer un nouveau commit pour voir de nouvelles analyses. Si vous ne souhaitez pas créer un nouveau commit à chaque exécution du test et que ce projet n'est pas encore verrouillé par Git, utiliser des tests sans Git évite le problème.

Pour obtenir une vue sans Git d'une suite de tests, envoyez ses résultats à un projet distinct, verrouillé sans Git, plutôt que d'essayer de modifier la forme des données d'un projet existant. Une fois qu'un projet s'est verrouillé à Git lors de sa première session réussie, supprimer le dossier .git ou désactiver la collecte de données Git ne produit plus une session sans Git : l'exécution est rejetée à la place. Voir Exécution rejetée : La forme des données ou le dépôt ne correspond pas au projet pour savoir à quoi ressemble le rejet et comment le résoudre.

Comme bonne pratique, vous devriez exécuter la suite de tests chaque fois qu'un nouveau commit est créé.

Les données Git ne correspondent pas au code

Si des tests de bout en bout sont exécutés dans un dépôt séparé du code que vous testez, les données Git affichées seront pour le test, pas le code que vous testez. Si cela cause de la confusion et que ce projet n'est pas encore verrouillé par Git, utiliser des tests sans Git l'évite.

Comme bonne pratique, nous vous recommandons de conserver les tests de bout en bout dans le même dépôt que le code que vous testez.

Exécution rejetée : La forme des données ou le dépôt ne correspond pas au projet

Une fois qu'un projet a ingéré sa première session réussie, sa forme de données (Git ou sans Git) et, pour les projets Git, son dépôt, sont verrouillés. Une exécution qui ne correspond pas au verrouillage est rejetée lors de l'ingestion, et les résultats ne sont pas sauvegardés. Le message de rejet indique ce que le projet attend, ce que l'exécution a envoyé et ce qu'il faut faire à ce sujet, par exemple :

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.

Causes courantes et comment les résoudre :

Un deuxième dépôt ou une suite de tests est pointé sur le même projet. Envoyez-le à son propre projet au lieu de celui déjà verrouillé sur un dépôt différent.
Un clonage superficiel, un état HEAD détaché, ou un origin distant manquant retire l'URL du dépôt, la branche, ou le SHA de commit de l'intégration continue, rendant une exécution Git semblable à une sans Git. Vérifiez que votre configuration CI fournit des informations Git complètes. Voir Axe Watcher dans les environnements d'intégration continue (CI) pour des conseils spécifiques à la CI.
La collecte de données Git a été désactivée sur un projet déjà verrouillé sur Git. Envoyer une exécution avec git: false ou avec le dossier .git supprimé ne convertit plus le projet en sans Git ; l'exécution est rejetée. Envoyez les exécutions sans Git vers un projet sans Git séparé à la place.

Aide

Visitez support.deque.com pour accéder à des articles de la base de connaissances, aux rapports de statut des produits SaaS de Deque, et à d'autres supports produits. Si vous ne parvenez pas à résoudre votre problème, veuillez nous envoyer un email afin que nous puissions vous aider.