Importieren von automatisierten, IGT- und manuellen Problemen

Axe Auditor-Benutzer können Probleme manuell importieren (exportiert als 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 ScreenshotURL-Tags in der JSON-Datei importiert.

Hinweis 2 - Vergleich nur von Hauptversionen während des Imports: Axe Auditor erlaubt den Import von Problemen, die mit der Erweiterung axe DevTools Pro generiert wurden, solange sie dieselbe Hauptversion von axe-core verwenden. Dies bedeutet, dass axe Auditor den Import einer mit der Erweiterung generierten Datei nur verhindert, wenn sich die Hauptversionsnummer (die erste Ziffer der Versionsnummer) zwischen dem Testlauf und der Erweiterung unterscheidet. Sollten sich die Nebenversionsnummern unterscheiden, gibt axe Auditor lediglich eine Warnung an den Benutzer aus, dass die importierte axe-core-Version nicht mit der von axe Auditor übereinstimmt und es möglicherweise einige Abweichungen in den Testdaten gibt. Diese Abweichungen beziehen sich hauptsächlich auf mögliche Unterschiede in den Deque-Checkpoints, die mit den Problemen in axe Auditor verbunden sind.

Hinweis 3 - Importieren von Problemen aus axe DevTools Mobile für Native Mobile Android und Native Mobile iOS - Beim Importieren von Problemen aus axe DevTools Mobile für digitale native mobile Asset-Typen importiert axe Auditor keine experimentellen und zu überprüfenden Probleme. Zusätzlich ignoriert axe Auditor Probleme mit dem AAA-Regelsatz, da es AAA-Regeln nicht unterstützt.

Hinweis 4 - Verwendung der Option Gespeicherte Tests und Probleme: Verwenden Sie die Option „Gespeicherte Tests und Probleme“, während Sie Probleme aus der axe DevTools-Erweiterung exportieren.

Hinweis 5 - Importieren von JSON-Dateien mit null Problemen: Beim Importieren von JSON-Dateien, die mit DevTools Pro keinerlei Probleme aufweisen, zeigt axe Auditor die Checkpoints an, die als Teil von IGTs getestet wurden, bei denen keine Probleme gemeldet wurden. Dies ermöglicht Ihnen, eine vollständigere Liste der als Teil der Tests mit axe DevTools Pro und axe Auditor getesteten Checkpoints zu erhalten, sodass Sie sich nur auf die verbleibenden Checkpoints konzentrieren können, die noch getestet werden müssen.

Hinweis 6 - Mehrfache Durchläufe von IGT bei axe DevTools-Importen: Wenn Sie das Mehrfachdurchlauf-Feature in der axe DevTools-Erweiterung (Pro-Feature) verwenden und den Export importieren, der bei einem Testlauf in axe Auditor importiert werden soll, können alle Probleme über mehrere Durchläufe importiert werden (nachdem Duplikate manuell entfernt wurden).

Verwendung der Schaltfläche „Probleme importieren“

Die drei verschiedenen Arten von Problemen, die eine Testeinheit umfassen kann, sind:

• Automatisierte Probleme - aus Auditor heraus oder aus einer vom Benutzer hochgeladenen JSON-Datei.
• IGT-Probleme - Alle Probleme, die die Erweiterung axe DevTools Pro bei IGT-Tests in einer vom Benutzer hochgeladenen JSON-Datei findet, werden als IGT-Probleme gekennzeichnet.
• Manuelle Probleme - aus Auditor heraus oder aus einer vom Benutzer hochgeladenen JSON-Datei.

Auf der Übersichtseite der Testeinheit verwenden Sie die Sektion „Teststatus“, um automatisierte, IGT- und manuelle Probleme zu importieren. Diese Sektion enthält:

• Das Datum und die Uhrzeit, zu der der Import der Probleme gestartet wurde,
• Den Teststatus, der den Status des Imports und das Datum sowie die Uhrzeit der Fertigstellung anzeigt, und
• Eine „Probleme importieren“-Schaltfläche, die es dem Benutzer ermöglicht, eine JSON-Datei in einem von Deque Systems bereitgestellten vordefinierten Format hochzuladen.

Wenn Sie auf die Schaltfläche „Probleme importieren“ klicken, erscheint das Bestätigungsdialogfeld zum Import von Problemen, 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 ScreenshotURL-Tags in der JSON-Datei importiert. Wenn das ScreenshotURL-Tag leer ist, wird kein Screenshot dem Problem hinzugefügt.

Hinweis 1: Beim erneuten Importieren von Problemen können Sie wählen, ob Sie die vorhandenen Probleme behalten oder durch die Probleme in der Datei ersetzen möchten, wenn die Testeinheit diese Probleme bereits enthält. Axe Auditor löscht und ersetzt nur manuell importierte Probleme, die mithilfe einer JSON-Datei importiert wurden. Manuell vom Benutzer hinzugefügte Probleme 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 Trusted Tester-Standards, können Sie keine automatisierten Tests durchführen oder IGT- und manuelle Probleme importieren. Die Schaltflächen auf der Übersichtsseite des Testlaufs zeigen „Nicht anwendbar“ statt „Automatisierte Tests ausführen“ und „Probleme importieren“ für Asset-Typen an, die nicht Desktop Web oder Mobile Web sind.

Hinweis 3: Axe Auditor berücksichtigt nur Verstöße, sodass importierte Probleme, die als „Zu überprüfen“ oder „Best Practices“ markiert sind, von axe Auditor nicht importiert werden.

Automatisierte Integration in Axe Auditor verwenden

Überblick

Zusätzlich zu manuellen Importen unterstützt axe Auditor den Import von Problemen durch automatisierte Integration.
Axe Auditor ist integriert mit axe DevTools Pro-Erweiterung über APIs, wodurch Benutzer Probleme nahtlos mit einem Klick an Auditor senden können – vorausgesetzt, sie haben ein Abonnement für Axe Auditor Integration in Axe-Konto.

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 das Auditor-Integration Abonnement abgeschlossen haben.
2. Der Benutzer sollte ein lizenzierter Benutzer von Auditor sein.
3. Erstellen Sie einen Testfall und einen entsprechenden Testrun.
4. Verschieben Sie die Testeinheit auf "In Bearbeitung" Status. (Wenn die Testeinheit den Status "Nicht begonnen" hat, können keine Daten importiert werden.)

Schritte zum Importieren von Problemen

1. Testdurchführung in Axe DevTools Pro Erweiterung

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

2. Erhalten Sie den geteilten Testlink

   • Sobald die Tests abgeschlossen sind, erhalten Sie den geteilten Testlink und öffnen ihn in einem neuen Tab.

3. Senden von Problemen an Auditor

   • Klicken Sie auf den "An Auditor senden" Knopf.
   • Geben Sie die Testeinheit-IDein, die aus der Auditor Testeinheit (verfügbar auf der Übersicht des Testruns und Testeinheit Seiten) kopiert werden kann.

4. Bestätigung und Datenverarbeitung

   • Einmal übermittelt, sendet DevTools die Daten an Auditor und zeigt eine Bestätigungsnachricht an.
   • Wenn die Auditor Testeinheit bereits Probleme enthält, erscheint eine Aufforderung, 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

Nutzer können nun 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, Standards der Testmethodik und Kompatibilität mit der axe-core-Version**—werden auf importierte Daten angewendet, um Genauigkeit und Konsistenz zu gewährleisten.

---

Fehlermeldungen

---

Diese Integration optimiert den Arbeitsablauf des Barrierefreiheitstests und gewährleistet einen **nahtlosen, genauen und effizienten** Problemtransfer zwischen **Axe DevTools Pro Extension** und **Auditor**.