Importation des problèmes automatisés, IGT et manuels

Les utilisateurs d'axe Auditor peuvent importer des problèmes manuellement (exportés sous forme de fichier JSON à l'aide de l'extension axe DevTools Pro) et via une intégration automatisée au niveau de l'unité de test, leur permettant d'importer des problèmes automatisés, IGT (explain or translate) et manuels en une seule opération.

Remarque 1 - Importation automatique de la capture d'écran avec le problème manuel : lorsque vous importez un problème manuel, la capture d'écran associée est automatiquement importée à l'aide de la balise ScreenshotURL dans le fichier JSON.

Remarque 2 - Comparaison uniquement des versions majeures lors de l'importation : Axe Auditor vous permet d'importer des problèmes générés par l'extension axe DevTools Pro à condition qu'ils utilisent la même version majeure d'axe-core. Cela signifie qu'axe Auditor empêchera uniquement l'importation d'un fichier généré par une extension si le numéro de version majeur (le premier chiffre du numéro de version) diffère entre l'exécution de test et l'extension. Dans le cas où les versions mineures sont différentes, axe Auditor fournira uniquement un avertissement à l'utilisateur, indiquant que la version axe-core en cours d'importation ne correspond pas à la version axe Auditor et qu'il peut y avoir des variations dans les données de test. Ces variations sont principalement liées aux différences potentielles dans les points de contrôle Deque associés aux problèmes dans axe Auditor.

Remarque 3 - Importation de problèmes depuis axe DevTools Mobile pour Android mobile natif et iOS mobile natif - Lors de l'importation de problèmes depuis axe DevTools Mobile pour les types d'actifs numériques natifs basés sur mobile, axe Auditor n'importe pas les problèmes expérimentaux et nécessitant une révision. De plus, axe Auditor ignore les problèmes liés aux règles AAA, car il ne prend pas en charge les règles AAA.

Remarque 4 - Utilisation de l'option Test et problèmes enregistrés : utilisez l'option « Test et problèmes enregistrés » lors de l'exportation de problèmes à partir de l'extension axe DevTools.

Remarque 5 - Importation de fichiers JSON sans aucun problème : lors de l'importation de fichiers JSON à l'aide de DevTools Pro sans aucun problème, axe Auditor affiche les points de contrôle qui ont été testés dans le cadre des TGI pour lesquels aucun problème n'a été signalé. Cela vous permet d'obtenir une liste plus complète des points de contrôle qui ont été testés dans le cadre des tests avec axe DevTools Pro et axe Auditor, vous permettant de vous concentrer uniquement sur les points de contrôle qui restent à tester.

Remarque 6 - Plusieurs exécutions de TGI dans les importations axe DevTools : si vous utilisez la fonctionnalité multi-exécution dans l'extension axe DevTools (fonctionnalité Pro) et utilisez l'exportation à importer dans axe Auditor Test Run, elle peut être importée dans axe Auditor avec les problèmes importés correspondant au total de tous les problèmes sur plusieurs exécutions (après avoir supprimé manuellement les doublons).

Utilisation du bouton Importer les problèmes

Les trois types différents de problèmes qu'une unité de test peut inclure sont :

• Problèmes automatisés - depuis Auditor ou depuis un fichier JSON téléversé par l'utilisateur.
• Problèmes IGT - Tous les problèmes que l'extension axe DevTools Pro peut détecter lors de l'exécution de tests IGT à partir d'un fichier JSON téléversé par l'utilisateur sont marqués comme des problèmes IGT.
• Problèmes manuels - depuis Auditor ou depuis un fichier JSON téléversé par l'utilisateur.

Sur la page Présentation de l'unité de test, utilisez la section intitulée État des tests pour importer des problèmes automatisés, IGT et manuels. Cette section contient :

• La date et l'heure de début de l'importation des problèmes,
• L'état des tests indiquant l'état de l'importation ainsi que la date et l'heure à laquelle il a été terminé,
• Un bouton Importer les problèmes qui permet à l'utilisateur de téléverser un fichier JSON dans un format prédéfini fourni par Deque Systems.

Cliquer sur le bouton Importer les problèmes fait apparaître la boîte de dialogue de confirmation Importer les problèmes, dans laquelle vous pouvez importer les trois types de problèmes à l'aide d'un fichier JSON. Pour générer le fichier JSON, utilisez l'option JSON dans l'extension axe DevTools (Exporter → Tests et problèmes enregistrés → option JSON).

Lorsque vous importez un problème, la capture d’écran associée est automatiquement importée à l’aide de la balise ScreenshotURL dans le fichier JSON. Si la balise ScreenshotURL est vide, aucune capture d'écran n'est ajoutée au problème.

Remarque 1 : lors de la réimportation des problèmes, vous pouvez choisir de conserver les problèmes existants ou de les remplacer par des problèmes dans le fichier, si l'unité de test contient déjà ces problèmes. Axe Auditor supprime et remplace uniquement les problèmes manuels importés à l'aide d'un fichier JSON. Les problèmes manuels ajoutés manuellement par l'utilisateur restent inchangés et ne sont pas supprimés ou réimportés.

Remarque 2 : lorsque le type de ressource numérique n'est pas Web de bureau ni Web mobile, ni toutes les normes WCAG et de testeur de confiance, vous ne pouvez pas exécuter de tests automatisés ni importer des problèmes IGT et manuels. Les boutons de la page Présentation de l'exécution des tests affichent « Non applicable » au lieu de « Exécuter des tests automatisés » et « Importer des problèmes » pour les types d'actifs qui ne sont pas des types Web de bureau ou Web mobile.

Remarque 3 : axe Auditor ne prend en compte que les violations. Par conséquent, si des problèmes importés comprennent des problèmes « Nécessitant une révision » ou « Meilleures pratiques », axe Auditor n'importe pas ces problèmes.

Utilisation de l'intégration automatisée dans axe Auditor

Aperçu

En plus des importations manuelles, axe Auditor prend en charge les importations de problèmes via l'intégration automatisée.
Axe Auditor est intégré à axe DevTools Pro Extension via des API, permettant aux utilisateurs d'envoyer des problèmes à Auditor en toute transparence en un seul clic, à condition qu'ils soient abonnés à Intégration de Axe Auditor dans Compte Axe.

Comment envoyer des données de l'extension Axe DevTools Pro à Auditor

Prérequis

Avant d'envoyer des données, assurez-vous que les étapes suivantes sont effectuées dans Auditor :

1. Créez un cas de test et une exécution de test correspondante.
2. Déplacez l'unité de test vers le statut « En cours ». (Si l'unité de test est dans le statut « Non démarré », les données ne peuvent pas être importées.)

Étapes pour importer des incidents

1. Effectuer des tests dans l'extension axe DevTools Pro

   • Ouvrez l'URL que vous souhaitez tester.
   • Lancez Axe DevTools Pro Extension et terminez vos tests.

2. Obtenez le lien de test partagé

   • Une fois le test terminé, obtenez le lien de test partagé et ouvrez-le dans un nouvel onglet.

3. Envoyer les problèmes à l'Auditeur

   • Cliquez sur le bouton « Envoyer à l'Auditeur ».
   • Saisissez l'ID de l'unité de test, qui peut être copié à partir de l'Unité de test de l'Auditor (disponible sur les pages Présentation de l'exécution du test et Unité de test).

4. Confirmation et traitement des données

   • Une fois soumis, axe DevTools Pro Extension enverra les données à Auditor et affichera un message de confirmation.
   • Si l'Unité de test de l'Auditor contient déjà des problèmes, une invite demandera si les données existantes doivent être remplacées.
   • Si remplacer est sélectionné, tous les problèmes précédents dans Auditor seront remplacés par ceux nouvellement importés.

Types de problèmes pris en charge

Les utilisateurs peuvent désormais envoyer les types de problèmes suivants directement à Auditor via l'intégration :

• Problèmes détectés automatiquement
• Problèmes détectés par IGT
• Problèmes détectés manuellement

Toutes les validations, y compris les vérifications d’URL, les normes de méthodologie de test et la compatibilité des versions axe-core, s’appliqueront aux données importées, garantissant ainsi l’exactitude et la cohérence.

---

Messages d’erreur

---

Cette intégration rationalise le flux de travail des tests d'accessibilité, garantissant un transfert de problèmes transparent, précis et efficace entre axe DevTools Pro Extension et Auditor.