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 mit dem ScreenshotURL-Tag in der JSON-Datei importiert.

Hinweis 2 - Beim Importieren nur Hauptversionen vergleichen: Axe Auditor erlaubt es Ihnen, Probleme zu importieren, die durch die axe DevTools Pro-Erweiterung generiert wurden, solange sie dieselbe Hauptversion von axe-core verwenden. Das bedeutet, dass axe Auditor den Import einer durch die Erweiterung generierten Datei nur verhindert, wenn sich die Hauptversionsnummer (die erste Ziffer in der Versionsnummer) zwischen dem Testlauf und der Erweiterung unterscheidet. Sollten die Nebenversionsnummern unterschiedlich sein, wird axe Auditor dem Benutzer nur 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 bei den Deque-Checkpoints, die mit den Problemen in axe Auditor verknüpft 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 Anlagentypen importiert axe Auditor keine experimentellen und „Needs Review“-Probleme. Außerdem 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 „Gespeicherte Tests und Probleme“, während Sie Probleme aus der axe DevTools-Erweiterung exportieren.

Hinweis 5 - JSON-Dateien mit null Problemen importieren: Beim Importieren von JSON-Dateien mit DevTools Pro ohne Probleme zeigt axe Auditor die Checkpoints an, die als Teil von IGTs getestet wurden, die keine gemeldeten Probleme haben. Dies ermöglicht es Ihnen, eine vollständigere Liste der getesteten Checkpoints zu erhalten, die im Rahmen von Tests mit axe DevTools Pro und axe Auditor durchgeführt wurden, sodass Sie sich nur auf die Checkpoints konzentrieren können, die noch getestet werden müssen.

Hinweis 6 - Mehrfache Durchläufe von IGT in axe DevTools-Importen: Wenn Sie die Mehrfachlauf-Funktion in der axe DevTools-Erweiterung (Pro-Funktion) verwenden und den Export zum Import in den axe Auditor-Testlauf verwenden, kann er in axe Auditor importiert werden, wobei die importierten Probleme die Summe aller Probleme über mehrere Läufe hinweg 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 Sie die vorhandenen Probleme behalten oder sie durch Probleme in der Datei ersetzen möchten, wenn die Testeinheit diese Probleme bereits enthält. Axe Auditor löscht und ersetzt nur manuell über eine JSON-Datei importierte Probleme. Manuell vom Benutzer hinzugefügte Probleme bleiben unverändert und werden nicht gelöscht oder erneut importiert.

Hinweis 2: Wenn der digitale Anlagentyp 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 Testlauf-Übersichtsseite zeigen „Nicht anwendbar“ anstelle von „Automatisierte Tests durchführen“ und „Probleme importieren“ für Anlagentypen, die nicht Desktop-Web oder Mobile-Web sind.

Hinweis 3: Axe Auditor berücksichtigt nur Verstöße, sodass, wenn importierte Probleme „Needs Review“ oder „Best Practices“-Probleme umfassen, axe Auditor diese Probleme nicht importiert.

Verwendung der automatisierten Integration in Axe Auditor

Übersicht

Zusätzlich zu manuellen Importen unterstützt unterstützt axe Auditor auch den Import von Problemen über automatisierte Integration.
Axe Auditor ist über APIs mit axe DevTools Pro-Erweiterung integriert, sodass Benutzer Probleme nahtlos mit einem einzigen Klick an Auditor senden können – vorausgesetzt, sie haben Axe Auditor-Integration in Axe Account abonniert.

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 abonniert haben.
2. Der Benutzer sollte ein lizenzierter Benutzer von Auditor sein.
3. Erstellen Sie einen Testfall und ein entsprechendes Testlauf.
4. Bewegen Sie den Testeinheit in den Status „In Bearbeitung“-Status. (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 Axe DevTools Pro Extension und schließen Sie Ihre Tests ab.

2. Den geteilten Testlink erhalten

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

3. Probleme an Auditor senden

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

4. Bestätigung und Datenverarbeitung

   • Nach der Einreichung wird DevTools die Daten an Auditor senden und eine Bestätigungsnachricht angezeigt.
   • Wenn der 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 zu gewährleisten.

---

Fehlermeldungen

---

Diese Integration rationalisiert den Workflow für Barrierefreiheitstests, indem ein nahtlose, genaue und effiziente-Problemaustausch zwischen Axe DevTools Pro Extension und Auditor sichergestellt wird.