Importieren von automatisierten, IGT- und manuellen Problemen

Axe Auditor-Nutzer können Probleme manuell importieren (exportiert als JSON-Datei mit der Axe DevTools Pro-Erweiterung) und durch automatische Integration auf der Testeinheitenebene, wodurch 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 - Beim Importieren nur Hauptversionen vergleichen: Axe Auditor erlaubt Ihnen, Probleme zu importieren, die von der Axe DevTools Pro-Erweiterung generiert wurden, solange sie dieselbe Hauptversion von axe-core verwenden. Das bedeutet, dass axe Auditor den Import einer von der Erweiterung generierten Datei nur verhindert, wenn sich die Hauptversionsnummer (die erste Ziffer der Versionsnummer) zwischen dem Testlauf und der Erweiterung unterscheidet. Falls sich die Nebenversionsnummern unterscheiden, gibt axe Auditor nur eine Warnung aus, die darauf hinweist, dass die zu importierende axe-core-Version nicht mit der axe Auditor-Version übereinstimmt und es daher zu einigen Abweichungen in den Testdaten kommen kann. Diese Abweichungen betreffen hauptsächlich potenzielle Unterschiede bei den Deque-Checkpoints, die mit den Problemen in axe Auditor verbunden sind.

Hinweis 3 - Probleme von Axe DevTools Mobile für native Mobile Android und native Mobile iOS importieren - Beim Importieren von Problemen von Axe DevTools Mobile für digital basierte Mobile-Asset-Typen importiert axe Auditor keine experimentellen oder Überprüfungsbedarf-Probleme. Zusätzlich ignoriert axe Auditor Probleme mit dem AAA-Regelwerk, da es keine AAA-Regeln unterstützt.

Hinweis 4 - Verwendung 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 - Importieren von JSON-Dateien ohne Probleme: Beim Importieren von JSON-Dateien mit DevTools Pro bei null Problemen 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 getesteten Checkpoints als Teil von Tests mit Axe DevTools Pro und axe Auditor zu erhalten und sich auf die noch zu testenden Checkpoints zu konzentrieren.

Hinweis 6 - Mehrere Läufe von IGT in Axe DevTools-Importen: Wenn Sie die Multi-Run-Funktion in der Axe DevTools-Erweiterung (Pro-Funktion) verwenden und den Export zum Importieren in den Axe Auditor-Testlauf verwenden, kann dieser in axe Auditor importiert werden, wobei die importierten Probleme die Summe aller Probleme über mehrere Läufe hinweg sind (nach manueller Entfernung von Duplikaten).

Verwendung der Schaltfläche zum Importieren von Problemen

Die drei verschiedenen Arten von Problemen, 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 Axe DevTools Pro-Erweiterung bei der Durchführung von IGT-Tests aus einer vom Benutzer hochgeladenen JSON-Datei findet, werden als IGT-Probleme markiert.
• Manuelle Probleme - innerhalb von Auditor oder aus einer vom Benutzer hochgeladenen JSON-Datei.

Auf der Testeinheiten-Übersichtsseite verwenden Sie den Abschnitt mit der Bezeichnung 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 des Tests, der den Status des Imports und Datum und Uhrzeit seiner Fertigstellung anzeigt, und
• Eine Schaltfläche „Probleme importieren“, die dem Benutzer ermöglicht, eine JSON-Datei in einem vordefinierten Format von Deque Systems hochzuladen.

Wenn Sie auf die Schaltfläche „Probleme importieren“ klicken, öffnet sich das Bestätigungsdialogfeld „Probleme importieren“, wo 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. Ist das ScreenshotURL-Tag leer, wird dem Problem kein Screenshot hinzugefügt.

Hinweis 1: Beim erneuten Importieren von Problemen können Sie wählen, ob Sie die vorhandenen Probleme beibehalten oder sie durch Probleme in der Datei ersetzen möchten, falls die Testeinheit diese Probleme bereits enthält. Axe Auditor löscht und ersetzt nur manuell importierte Probleme, die mit 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 nicht erfüllt sind, können Sie keine automatisierten Tests durchführen oder IGT- und manuelle Probleme importieren. Die Schaltflächen auf der Testlauf-Übersichtsseite zeigen anstelle von „Automatisierte Tests durchlaufen“ und „Probleme importieren“ für Asset-Typen, die nicht Desktop Web oder Mobile Web sind, „Nicht anwendbar“ an.

Hinweis 3: Axe Auditor betrachtet nur Verstöße, daher importiert axe Auditor keine Probleme, die „Überprüfungsbedarf“ oder „Best Practices“ umfassen.

Verwendung der automatisierten Integration in Axe Auditor

Übersicht

Zusätzlich zu manuellen Importen unterstützt axe Auditor den Import von Problemen durch automatisierte Integration.
Axe Auditor ist über APIs in Axe DevTools Pro-Erweiterung integriert und ermöglicht es den Benutzern, Probleme mit einem einzigen Klick nahtlos an Auditor zu senden, sofern sie Axe Auditor-Integration in Axe-Konto abonniert haben.

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

Voraussetzungen

Bevor Sie Daten senden, stellen Sie sicher, dass die folgenden Schritte in Auditor abgeschlossen sind:

1. 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. Einen Testfall erstellen und eine entsprechende Testlauf.
4. Verschieben Sie die Testeinheit auf „In Bearbeitung“-Status. (Falls die Testeinheit den Status „Nicht gestartet“ hat, können Daten nicht importiert werden.)

Schritte zum Importieren von Problemen

1. Testen in der Axe DevTools Pro-Erweiterung durchführen

   • Öffnen Sie die URL, die Sie testen möchten.
   • Starten Sie Axe DevTools Pro-Erweiterung und schließen Sie Ihre Tests ab.

2. Den geteilten Testlink erhalten

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

3. Probleme an den Auditor senden

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

4. Bestätigung und Datenverarbeitung

   • Nach dem Absenden DevTools sendet die Daten an den Auditor und eine Bestätigungsnachricht wird angezeigt.
   • Falls die Auditor Testeinheit enthält bereits Probleme, wird eine Eingabeaufforderung gestellt, ob vorhandene Daten überschrieben werden sollen.
   • Wenn überschreiben ausgewählt wird, werden alle vorherigen Probleme im Auditor durch die neu importierten ersetzt.

Unterstützte Problemmeldungstypen

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

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

Alle Validierungen—einschließlich URL-Prüfungen, Testmethodikstandards und axe-core-Version-Kompatibilität—gelten für importierte Daten und gewährleisten Genauigkeit und Konsistenz.

---

Fehlermeldungen

---

Diese Integration rationalisiert den Workflow der Barrierefreiheitstests und gewährleistet einen nahtlos, genau und effizient Übertrag der Probleme zwischen Axe DevTools Pro-Erweiterung und Auditor.