Die Einrichtungsseite ist die erste Seite, die ein neuer Anwender sieht. Sie ist zugleich die einzige, die man selbst nach dem ersten Tag nie wieder aufruft.

Der Fall

Eine Einrichtungsseite brach mit einem schwerwiegenden Fehler ab, bevor sie ihr Formular zeigte. Die Ursache stand in der Kopfzeile: Dort wurde die Zuordnung des aufgerufenen Rechnernamens ausgelesen, um sie anzuzeigen.

Beim allerersten Aufruf gibt es diese Zuordnung nicht. Sie entsteht erst dadurch, dass jemand das Formular ausfüllt – deshalb ruft man die Seite ja auf. Der Code las etwas aus, das seiner eigenen Aufgabe nachgelagert ist.

Warum es niemandem auffiel

Bei jeder bestehenden Installation lief die Seite fehlerfrei – dort existiert die Zuordnung ja. Der Fehler war ausschließlich im Zustand „noch nichts eingerichtet" sichtbar, und in diesem Zustand ist keine der Umgebungen, auf denen entwickelt und geprüft wird.

Die Fehlerklasse

Der Einzelfall ist unwichtig. Wichtig ist das Muster: Code, der je Installation genau einmal läuft, wird von denen, die ihn schreiben, genau einmal ausgeführt – am Anfang, als noch nicht klar war, was er alles können muss.

Danach entwickelt sich der Rest der Anwendung weiter, die Datenstruktur ändert sich, Felder kommen hinzu – und der Einrichtungspfad läuft mit, ohne je wieder betreten zu werden. Er veraltet im Verborgenen.

Wer davon betroffen ist

Ausschließlich neue Anwender. Also genau die Gruppe, die am wenigsten Nachsicht hat und am wenigsten weiß, wo sie nachfragen könnte.

Das ist die zweite Hälfte des Problems: Der Fehler trifft nicht irgendwen, sondern jemanden im ersten Kontakt. Ein Bestandsnutzer meldet einen Abbruch. Ein neuer Anwender schließt das Fenster.

Was hilft

  1. Den Ausgangszustand herstellen können

    Leere Datenbank, unbekannter Rechnername, keine Konfigurationsdatei – auf einer Wegwerfumgebung. Wenn das umständlich ist, wird es nicht gemacht, und dann ist genau das die erste Baustelle.

  2. In die Abnahme aufnehmen

    Nicht „bei Gelegenheit prüfen". Vor jeder Auslieferung, die den Einrichtungspfad oder die Datenstruktur berührt.

  3. Alles Nachgelagerte null-sicher lesen

    Im Einrichtungspfad ist jeder Zugriff auf etwas, das erst durch die Einrichtung entsteht, ein Fehler in Wartestellung. Ein sinnvoller Ersatzwert kostet nichts und ist genau hier keine übertriebene Vorsicht.

  4. Die Verwandten mitdenken

    Migrationen, Erstanmeldung, erster Datensatz, Kennwort zurücksetzen, Verteiler abbestellen. Dieselbe Klasse, dieselbe blinde Stelle.

Weiterlesen Patchen mit Zusicherung Weiterleitungen, die niemand ausführt