QA-Testschritte mit Screenshots dokumentieren

Diese Anleitung zeigt, wie du Screenshot-Nachweise für einen QA-Testlauf sammelst. Du legst das Testziel fest, erfasst Voraussetzungen und Testdaten, schreibst prüfbare Schritte, nimmst Nachweise auf, vergibst ein Ergebnis und vervollständigst das Ausführungsprotokoll.

Kurz gesagt: Ein QA-Protokoll verbindet jede geplante Aktion mit einem erwarteten Ergebnis und belegt den abschließenden Status „bestanden“, „fehlgeschlagen“ oder „blockiert“ mit Nachweisen aus genau diesem Durchlauf.

Ein Testziel festlegen

Das Testziel beschreibt das geprüfte Verhalten und die Erfolgsbedingung. Beschränke einen Datensatz auf ein Ergebnis, damit ein Fehler auf einen klaren Produktbereich weist.

„Prüfen, ob ein Free-Nutzer ein Action Capture Document als PNG exportieren kann“ ist testbar. „Action-Capture-Exporte testen“ vermischt mehrere Formate, Tarifzustände und Fehlerwege, die in getrennte Fälle gehören.

Vergib eine stabile Testfall-ID, wenn der Test wiederholt wird. Die ID verbindet spätere Durchläufe, Regressionen und Fehlerberichte, ohne von einem möglicherweise später bearbeiteten Titel abzuhängen.

Voraussetzungen und Testdaten festhalten

Voraussetzungen machen den Durchlauf wiederholbar. Liste Produktversion, Betriebssystem, Tarif- oder Kontozustand, Berechtigungen, Feature Flags, vorbereitetes Dokument und alle vor Schritt eins benötigten Daten auf.

Nutze genaue Testdaten statt der vagen Anweisung „gültige Daten eingeben“. Wenn ein Wert Zugangsdaten oder einen Kundendatensatz offenlegen könnte, erstelle eine sichere Testvorgabe und notiere, wo der Tester sie findet.

Eine kompakte Einrichtung kann so aussehen:

Umgebung: macOS 15.5, Shotomatic 1.8.2
Kontozustand: Free
Berechtigungen: Bildschirmaufnahme erlaubt
Testdaten: Action Capture Document mit drei Seiten
Ausgangsbildschirm: Documents-Editor, erste Seite ausgewählt

Schritte mit erwarteten Kontrollpunkten schreiben

Verbinde jeden Schritt mit dem Ergebnis, das der Tester prüfen muss. So verschiebt eine lange Aktionsliste nicht alle Prüfungen ans Ende.

Nutze direkte Anweisungen:

1. Menü Export öffnen. Erwartet: PNG und JPG sind verfügbar.
2. PNG auswählen. Erwartet: Der Speicherdialog wird geöffnet.
3. Testordner auswählen und speichern. Erwartet: Für jede Seite wird eine PNG-Datei erstellt.
4. Exportierte Dateien öffnen. Erwartet: Die Seiten entsprechen der Dokumentreihenfolge und dem Editor.

Fasse nicht mehrere Interaktionen in einem Schritt zusammen. Schlägt ein kombinierter Schritt fehl, bleibt unklar, welche Aktion das Ergebnis verursacht hat.

Nachweise an nützlichen Kontrollpunkten aufnehmen

Ein nützlicher Nachweis belegt einen Zustand, der für die Testentscheidung wichtig ist. Nimm Ausgangskonfiguration, tarifabhängige Optionen, Endausgabe und jedes unerwartete Ergebnis auf.

Du brauchst keinen Screenshot für jeden Klick. Das Öffnen eines Menüs kann einen Nachweis erfordern, wenn der Test die verfügbaren Formate prüft. Die Auswahl eines gewöhnlichen Ordners fügt dagegen möglicherweise nichts hinzu.

Action Capture kann eine Klick-für-Klick-Folge aufnehmen, wenn der Test selbst einem UI-Pfad folgt. Prüfe die Seiten danach und behalte nur Zustände, die das Testergebnis stützen. Free-Sessions unterstützen fünf gespeicherte Schritte und alle Dokumentexportformate. Pro hebt das Schrittlängelimit auf und ergänzt Weichzeichnung, Klickmarkierung und Schrittnummern.

Tatsächliche Ergebnisse ohne nachträgliche Anpassung erfassen

Das tatsächliche Ergebnis sollte beschreiben, was bei dieser Ausführung geschehen ist. Ändere das erwartete Ergebnis nicht, damit es zu einem Fehler passt, und bearbeite geplante Schritte nicht mitten im Lauf, ohne die Abweichung festzuhalten.

Nutze einen von drei eindeutigen Zuständen:

• Bestanden: Jedes erforderliche Ergebnis stimmte überein.
• Fehlgeschlagen: Mindestens ein erforderliches Ergebnis stimmte nicht überein.
• Blockiert: Eine Voraussetzung oder ein anderer Fehler verhinderte eine Entscheidung.

Nenne bei einem fehlgeschlagenen Test den ersten abweichenden Kontrollpunkt und verlinke einen getrennten Fehlerbericht. Darin können der verkürzte Reproduktionsweg, Umgebung, Häufigkeit und Diagnosenachweise stehen, ohne den wiederverwendbaren Testfall zu überladen.

Dieses QA-Ausführungsprotokoll verwenden

Die folgende Struktur trennt die wiederverwendbare Testdefinition vom Ergebnis eines einzelnen Durchlaufs:

Testfall-ID:
Ziel:

Umgebung:
Voraussetzungen:
Testdaten:

Schritte und erwartete Ergebnisse:
1. Aktion:
   Erwartet:
2. Aktion:
   Erwartet:

Ausführungsdatum:
Tester:
Geprüfter Build:

Tatsächliches Ergebnis:
Status: Bestanden / Fehlgeschlagen / Blockiert
Nachweise:
Verknüpfter Fehler:
Notizen oder Abweichungen:

Du kannst diese Dokumentationsstruktur in das vorhandene QA-System übernehmen. Shotomatic importiert sie nicht als Projektvorlage.

Nachweise prüfen und freigeben

Die abschließende Prüfung bestätigt, dass die Nachweise zum angegebenen Durchlauf gehören. Kontrolliere Build, Kontozustand, Datum, Seitenreihenfolge und exportiertes Ergebnis, bevor eine andere Person das Protokoll zur Freigabe einer Version verwendet.

Entferne doppelte Screenshots und schütze private Testdaten. Verknüpfe Dateinamen oder Seitentitel mit der Testfall-ID, wenn die Dateien getrennt vom Testmanagementsystem gespeichert werden. Führe vor der Weitergabe eine Abschlussprüfung und einen Leserdurchlauf durch.

Ein QA-Protokoll ist vollständig, wenn ein Prüfer sehen kann, was getestet wurde, die Einrichtung wiederholen, erwartete und tatsächliche Ergebnisse vergleichen und den Endstatus verstehen kann. Nutze Action Capture, um eine klickbasierte Testfolge aufzunehmen. Für Nachweise zu einem bereits beobachteten Problem statt zu einem geplanten Test eignet sich Einen Fehler auf dem Mac mit Schritt-für-Schritt-Screenshots dokumentieren.