Importieren von automatisierten, IGT- und manuellen Problemen

Axe Auditor-Benutzer können Probleme manuell importieren (exportiert als eine JSON-Datei mit der Erweiterung axe DevTools Pro) und durch automatisierte Integration auf Testeinheitenebene, sodass sie automatisierte, IGT- und manuelle Probleme in einem Vorgang importieren können.

Hinweis 1 - Automatisches Importieren des Screenshots mit dem manuellen Problem: Wenn Sie ein manuelles Problem importieren, wird der zugehörige Screenshot automatisch mithilfe des Tags ScreenshotURL in der JSON-Datei importiert.

Hinweis 2 - Beim Importieren nur Hauptversionen vergleichen: Axe Auditor ermöglicht es Ihnen, Probleme zu importieren, die von der Erweiterung axe DevTools Pro erzeugt wurden, solange sie dieselbe Hauptversion von axe-core verwenden. Das bedeutet, dass axe Auditor den Import einer von der Erweiterung erzeugten Datei nur verhindert, wenn die Hauptversionsnummer (die erste Ziffer der Versionsnummer) zwischen dem Testlauf und der Erweiterung abweicht. Falls die Nebenversionsnummern unterschiedlich sind, wird axe Auditor dem Benutzer lediglich eine Warnung geben, dass die importierte axe-core-Version nicht mit der axe Auditor-Version übereinstimmt und dass es möglicherweise einige Abweichungen in den Testdaten gibt. Diese Abweichungen beziehen sich hauptsächlich auf potenzielle Unterschiede in den Deque-Prüfpunkten, die mit den Problemen in axe Auditor verbunden sind.

Hinweis 3 - Importieren von Problemen von axe DevTools Mobile für Native Mobile Android und Native Mobile iOS - Beim Importieren von Problemen von axe DevTools Mobile für native mobilbasierte digitale Asset-Typen importiert axe Auditor keine experimentellen und zur Überprüfung anstehenden Probleme. Zusätzlich ignoriert axe Auditor Probleme mit dem AAA-Regelwerk, da es keine AAA-Regeln unterstützt.

Hinweis 4 - Verwenden der Option Gespeicherter Test und Probleme: Verwenden Sie die Option „Gespeicherter Test und Probleme“ beim Exportieren von Problemen aus der axe DevTools-Erweiterung.

Hinweis 5 - JSON-Dateien mit null Problemen importieren: Beim Importieren von JSON-Dateien mit DevTools Pro, die null Probleme enthalten, zeigt axe Auditor die Prüfpunkte an, die im Rahmen von IGTs getestet wurden, bei denen keine Probleme gemeldet wurden. Dies ermöglicht es Ihnen, eine vollständigere Liste der geprüften Prüfpunkte im Rahmen von Tests mit axe DevTools Pro und axe Auditor zu erhalten, sodass Sie sich auf nur noch diejenigen Prüfpunkte konzentrieren können, die noch zu testen sind.

Hinweis 6 - Mehrfache Durchläufe von IGT in axe DevTools-Importen: Wenn Sie die Multilauf-Funktion in der axe DevTools-Erweiterung (Pro-Funktion) verwenden und den Export zum Importieren in den axe Auditor-Testlauf nutzen, kann dieser in axe Auditor importiert werden, wobei die importierten Probleme die Gesamtsumme aller Probleme aus mehreren Läufen sind (nachdem die Duplikate manuell entfernt wurden).

Verwendung der Schaltfläche Probleme importieren

Die drei verschiedenen Problemtypen, die eine Testeinheit enthalten kann, sind:

• Automatisierte Probleme - innerhalb von Auditor oder aus einer vom Benutzer hochgeladenen JSON-Datei.
• IGT-Probleme - Alle Probleme, die die Erweiterung axe DevTools Pro beim Ausführen von IGT-Tests aus einer vom Benutzer hochgeladenen JSON-Datei finden kann, werden als IGT-Probleme markiert.
• Manuelle Probleme - innerhalb von Auditor oder aus einer vom Benutzer hochgeladenen JSON-Datei.

Auf der Übersichtsseite der Testeinheit verwenden Sie den Abschnitt namens Teststatus, um automatisierte, IGT- und manuelle Probleme zu importieren. Dieser Abschnitt enthält:

• Das Datum und die Uhrzeit, zu der der Import der Probleme gestartet wurde,
• den Status der Testung, der den Status des Imports und das Datum und die Uhrzeit der Fertigstellung anzeigt, sowie
• eine Schaltfläche Probleme importieren, die dem Benutzer das Hochladen einer JSON-Datei in einem von Deque Systems vordefinierten Format ermöglicht.

Wenn Sie auf die Schaltfläche Probleme importieren klicken, wird das Bestätigungsdialogfeld Import von Problemen angezeigt, in dem Sie alle drei Arten von Problemen mithilfe einer JSON-Datei importieren können. Um die JSON-Datei zu erstellen, verwenden Sie die JSON-Option in der axe DevTools-Erweiterung (Export → Gespeicherter Test und Probleme → JSON-Option).

Wenn Sie ein Problem importieren, wird der zugehörige Screenshot automatisch mithilfe des Tags ScreenshotURL in der JSON-Datei importiert. Wenn das ScreenshotURL-Tag leer ist, wird dem Problem kein Screenshot hinzugefügt.

Hinweis 1: Beim erneuten Importieren von Problemen können Sie wählen, ob die vorhandenen Probleme beibehalten oder durch die Probleme in der Datei ersetzt werden sollen, wenn die Testeinheit diese Probleme bereits enthält. Axe Auditor löscht und ersetzt nur manuell importierte Probleme, die über eine JSON-Datei importiert wurden. Manuelle Probleme, die vom Benutzer manuell hinzugefügt wurden, bleiben unberührt und werden nicht gelöscht oder erneut importiert.

Hinweis 2: Wenn der digitale Asset-Typ nicht Desktop-Web oder Mobile-Web ist, oder alle WCAG- und vertrauenswürdigen Testerstandards, können Sie keine automatisierte Tests ausführen oder IGT- und manuelle Probleme importieren. Die Schaltflächen auf der Testlauf-Übersichtsseite zeigen "Nicht anwendbar" anstelle von "Automatisierte Tests ausführen" und "Probleme importieren" für Asset-Typen, die nicht Desktop-Web oder Mobile-Web sind.

Hinweis 3: Axe Auditor berücksichtigt nur Verstöße, sodass, wenn importierte Probleme "Zur Überprüfung erforderlich" oder "Bewährte Praktiken"-Probleme umfassen, axe Auditor diese Probleme nicht importiert.

Verwendung der automatisierten Integration in Axe Auditor

Übersicht

Zusätzlich zu manuellen Importen, unterstützt axe Auditor auch Problemimporte durch automatisierte Integration.
Axe Auditor ist mit axe DevTools Pro-Erweiterung über APIs integriert, wodurch Benutzer Probleme nahtlos per Mausklick an Auditor senden können—vorausgesetzt, sie haben ein Abonnement für Axe Auditor-Integration im Axe Account.

Wie man Daten von der Axe DevTools Pro-Erweiterung an Auditor sendet

Voraussetzungen

Vor dem Senden von Daten stellen Sie sicher, dass die folgenden Schritte in Auditor abgeschlossen sind:

1. Die Auditor-Integration muss in der devTools pro Erweiterung verfügbar sein und der Benutzer muss die Auditor-Integration abonniert haben.
2. Der Benutzer sollte ein lizenzierter Benutzer von Auditor sein.
3. Erstellen Sie einen Testfall und einen entsprechenden Testlauf.
4. Verschieben Sie die Testeinheit in den Status „In Bearbeitung“ . (Wenn sich die Testeinheit im Status „Nicht begonnen“ befindet, können keine Daten importiert werden.)

Schritte zum Importieren von Problemen

1. Testen mit der Axe DevTools Pro Erweiterung durchführen

   • Öffnen Sie die URL, die Sie testen möchten.
   • Starten Sie die Axe DevTools Pro Erweiterung und führen Sie Ihre Tests durch.

2. Den geteilten Testlink erhalten

   • Nachdem der Test abgeschlossen ist, erhalten Sie den geteilten Testlink und öffnen Sie ihn in einem neuen Tab.

3. Probleme an Auditor senden

   • Klicken Sie auf die Schaltfläche „An Auditor senden“ .
   • Geben Sie die Testeinheit-IDein, die von der Auditor Testeinheit (verfügbar auf der Testlauf-Übersicht und den Testeinheit Seiten) kopiert werden kann.

4. Bestätigung und Datenverarbeitung

   • Nach der Übermittlung wird DevTools die Daten an Auditor senden und eine Bestätigungsnachricht anzeigen.
   • Wenn die Auditor Testeinheit bereits Probleme enthält, wird eine Aufforderung angezeigt, ob die vorhandenen Daten überschrieben werden sollen.
   • Wenn Überschreiben ausgewählt wird, werden alle vorherigen Probleme in Auditor durch die neu importierten ersetzt.

Unterstützte Problemtypen

Benutzer können jetzt die folgenden Problemtypen direkt über die Integration an Auditor senden:

• Automatisierte Probleme
• IGT (Intelligent Guided Testing) Probleme
• Manuelle Probleme

Alle Validierungen—einschließlich URL-Prüfungen, Testmethodologie-Standards und axe-core-Version-Kompatibilität—werden auf importierte Daten angewendet, um Genauigkeit und Konsistenz sicherzustellen.

---

Fehlermeldungen

---

Diese Integration optimiert den Arbeitsablauf des Barrierefreiheitstests und sorgt für eine nahtlose, genaue und effiziente Übertragung von Problemen zwischen Axe DevTools Pro Extension und Auditor.