Browser-Nachweise

Tests sagen Ihnen, dass der Code funktioniert. Ein Browser-Nachweis zeigt es Ihnen. Wenn eine Story etwas ändert, das Menschen sehen, etwa eine Seite, ein Formular oder einen Dialog, öffnet kanman die App in einem echten Browser, geht den Ablauf durch, wie es eine Person täte, und zeichnet ihn auf. Sie sehen sich die Aufnahme an, statt kanman beim Wort zu nehmen.

Was ein Nachweis ist

Ein Nachweis ist ein kurzes Video, in dem kanman Ihre App bedient, mit einer Liste benannter Schritte daneben:

• Aktionen: was kanman getan hat, in einfachen Worten, zum Beispiel “Anmeldeseite öffnen” oder “Auf Speichern klicken”.
• Prüfungen: was kanman zu sehen erwartet hat, zum Beispiel “Die Meldung sagt Gespeichert”. Eine Prüfung besteht nur, wenn die Seite es wirklich zeigt.

Jeder Schritt hat seine Zeit im Video und einen Screenshot. Klicken Sie auf einen Schritt, um dorthin zu springen.

Ein Nachweis gehört zu seiner Story. kanman zeichnet einen auf, wenn die Änderung für Menschen sichtbar ist; eine Änderung ohne etwas zu sehen, etwa eine Datenbankmigration oder ein Hintergrundjob, wird allein durch Ihre CI und das Review belegt. Siehe So prüft kanman seine Arbeit.

Wo Sie ihn ansehen

Sie finden denselben Nachweis überall dort, wo Sie die Arbeit verfolgen:

• An der Story: Das Log der Story zeigt den Nachweis als Karte. Öffnen Sie sie, um das Video mit den Schritten daneben abzuspielen, oder öffnen Sie den Nachweis auf seiner eigenen Seite, um einen Link darauf zu teilen.
• In der Unterhaltung: Die Zeile, die kanman für jede Story führt, trägt einen kleinen Nachweis-Chip. Klicken Sie darauf, um den Nachweis abzuspielen, ohne die Unterhaltung zu verlassen.
• In der Agent-Sitzung: Während Sie die Arbeit an einer Story live verfolgen, erscheinen ihre Nachweise dort, sobald sie aufgezeichnet sind.
• Am Merge Request: kanman schreibt einen Kommentar mit dem Ergebnis, den Schritten und einigen Schlüsselbildern, damit auch Reviewer auf Ihrem Code-Host das Ergebnis sehen.

Der Player lässt sich mit der Tastatur bedienen: Leertaste spielt ab und pausiert, die Pfeiltasten springen durch das Video, F schaltet auf Vollbild. Auf dem Telefon öffnet Alle Schritte die Schrittliste vom unteren Bildschirmrand.

Bestanden und fehlgeschlagen

• Bestanden: Jede Prüfung hat gefunden, was sie erwartet hat, und der Ablauf lief bis zum Ende.
• Fehlgeschlagen: Mindestens eine Prüfung hat nicht gefunden, was sie erwartet hat, oder ein Schritt war nicht möglich. Der Schritt ist rot markiert, mit dem Grund, zum Beispiel “Text nicht gefunden”, und der Nachweis zeigt “1 von 5 fehlgeschlagen”. kanman behebt die Änderung und zeichnet den Nachweis neu auf; einen fehlgeschlagenen Nachweis gibt kanman nie als erledigt aus.
• Vorzeitig beendet: Die Aufnahme hat vor dem Ende gestoppt, zum Beispiel weil sie ihre Längengrenze erreicht hat. Sie gilt als nicht belegt, nie als bestanden.

Auch ein fehlgeschlagener Nachweis ist nützlich: Er zeigt genau, wo der Ablauf bricht, so wie eine Person es erleben würde.

Welche Hosts ein Nachweis öffnen darf

Ein Nachweis läuft gegen die App, die kanman für die Story aus Ihrem Repository startet, auf der eigenen Maschine des Runs. Darüber hinaus öffnet der Browser nur die Hosts, die Ihr Team erlaubt, dieselbe Liste, die den Internetzugang während der Arbeit begrenzt. Produktion wird nie geöffnet, außer Ihr Team trägt sie ein.

Um einen Host zu erlauben, zum Beispiel eine Staging-Umgebung, tragen Sie ihn im Reiter Team unter Agent und Modelle > Internetzugang ein. Versucht ein Nachweis, einen nicht erlaubten Host zu öffnen, zeigt der Schritt, dass der Host blockiert wurde, und nennt ihn. Siehe Internetzugang während der Arbeit des Agenten.

Gegen eine Vorschau aus Ihrer CI

Wenn Ihre CI für einen Merge Request eine Vorschau deployt (eine Review-App oder Vorschau-Umgebung), kann kanman den Nachweis gegen diese Vorschau aufnehmen, statt die App selbst zu starten. kanman liest die Adresse der Vorschau aus Ihrer CI, aus der Umgebung des Deploy-Jobs; eine Adresse aus anderer Quelle nutzt es nie.

Ein Nachweis läuft gegen eine Vorschau nur auf den Hosts, die Sie unter Agent und Modelle > Internetzugang > Vorschau-Hosts eintragen, zum Beispiel *.review.example.com. Eine Produktionsumgebung wird nur geöffnet, wenn ihr eigener Host dort eingetragen ist; ein Platzhalter deckt Produktion nie ab. Ohne Vorschau-Hosts laufen Nachweise gegen die App, die kanman startet.

Ein Nachweis gegen eine Vorschau sagt das auf seiner Karte: Gegen die Vorschau und die Adresse, und der Kommentar am Merge Request nennt die Umgebung.

Aufnahmen zeigen nie die Passwörter, die kanman eintippt: Sie sind im Video, in den Schritten und im Kommentar am Merge Request verborgen.