Umsetzbare Fehlermeldungen schreiben

Auf dieser Seite werden Best Practices für die Erstellung umsetzbarer Fehlermeldungen beschrieben, die Nutzern zeigen, wie sie das Problem beheben können, damit sie ihr Ziel erreichen.

Wenn Nutzer mit einer Google Chat-App interagieren, kann es frustrierend sein, wenn Fehlermeldungen angezeigt werden, die nicht behoben werden können. Die Fehlermeldung An error occurred ist beispielsweise nicht hilfreich, da sie nicht erklärt, was schiefgelaufen ist, wie der Nutzer das Problem beheben kann oder wie er Hilfe erhalten kann. Auf dieser Seite wird beschrieben, wie Sie Fehlermeldungen so strukturieren, dass sie für Nutzer nützlich sind, indem Sie umsetzbare und nicht umsetzbare Beispiele zeigen.

Struktur von Fehlermeldungen

Eine umsetzbare Fehlermeldung hat die folgende Struktur:

  • Was ist schiefgelaufen? Wenn Sie angeben, warum die Chat-App eine Anfrage nicht abschließen kann, kann der Nutzer das Problem beheben. Wenn Sie erklären, warum ein Fehler aufgetreten ist, bauen Sie Vertrauen auf.
  • Wie Nutzer ihr Ziel erreichen können. Es reicht nicht aus, nur zu sagen, was schiefgelaufen ist. Informieren Sie die Nutzer darüber, wie sie den Fehler umgehen und ihr Ziel erreichen können.
  • Hilfe erhalten Wenn der Nutzer immer noch nicht weiterkommt, erkläre ihm, wie er weitere Hilfe erhalten kann. Dies kann ein /help-Befehl oder ein Link zur Dokumentation für Ihre Chat-App sein.

Beispiel für eine Fehlermeldung: falsches Datumsformat

In diesem Beispiel hat der Nutzer ein Datum in einem Format eingegeben, das von der Chat-App nicht erwartet wurde. Er hat November 19, 2021 geschrieben, aber die Chat App erwartet 2021-11-19.

Hier sehen Sie eine ausführbare und eine nicht ausführbare Version der Fehlermeldung, die die Chat-App zurückgibt:

Umsetzbarer Fehler

Ein Nutzer bittet die Chat-App, einen Termin mit einer anderen Person zu vereinbaren. Die Chat-App antwortet mit einer guten, umsetzbaren Fehlermeldung:

I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.

Beispiel für eine Fehlermeldung, in der der Nutzer darüber informiert wird, was schiefgelaufen ist, wie er vorgehen und wo er Hilfe finden kann.

Diese Fehlermeldung ist aus folgenden Gründen relevant:

  • Hier wird angegeben, was das Problem ist. Die Chat-App erkennt das Datumsformat nicht.
  • Erläutert, wie der Fehler behoben wird, indem der Nutzer das erwartete Datumsformat mitgeteilt und ein Beispieldatum angegeben wird, anhand dessen er versteht, was er eingeben muss.
  • Bietet mehr Hilfe mit einem /help-Befehl. Wenn Nutzer immer noch nicht weiterkommen, wissen sie, wie sie mehr erfahren können.

Nicht behebbarer Fehler

Ein Nutzer bittet die Chat-App, einen Termin mit einer anderen Person zu vereinbaren. Die Chat-App antwortet mit einer nicht hilfreichen, nicht ausführbaren Fehlermeldung:

Enter the correct date format.

Beispiel für eine Fehlermeldung, die keine umsetzbaren Informationen enthält.

Diese Fehlermeldung kann aus folgenden Gründen nicht behoben werden:

  • Es wird nicht angegeben, ob die Besprechung geplant wurde. Der Nutzer zögert möglicherweise, den Termin zu verschieben, oder er geht davon aus, dass der Termin bereits geplant war.
  • Der Nutzer wird nicht darüber informiert, wie das Datum formatiert werden soll. Anstatt davon auszugehen, dass Nutzer wissen, wie das Datum formatiert werden muss, sollte angegeben werden, dass das Datumsformat yyyy-mm-dd erwartet wird.
  • Es wird keine weitere Hilfe angeboten. Wenn Nutzer nicht weiterkommen und nicht wissen, wie sie vorgehen sollen, senden sie möglicherweise keine Nachrichten mehr an die Chat-App.

Jetzt ausprobieren

Nachdem Sie nun wissen, wie Sie umsetzbare Fehler formulieren, können Sie im folgenden Szenario erkennen, welcher dieser Fehler umsetzbar ist:

Eine Chat-App erstellt Kalendertermine, wenn Nutzer der Chat-App das Keyword schedule senden. Für das Erstellen eines Kalendertermins ist in der Chat App eine Nutzerauthentifizierung erforderlich. Wenn ein Nutzer nicht authentifiziert wurde, antwortet die Chat-App mit einer Fehlermeldung.

Welche Fehlermeldung kann behoben werden?
Bevor ich den Termin planen kann, müssen Sie sich anmelden. Geben Sie dazu /signin ein. Geben Sie /help ein, um mehr zu erfahren.
Diese Fehlermeldung kann behoben werden, da sie Folgendes enthält:
  • Was ist schiefgelaufen? Für die Chat-App ist eine Authentifizierung erforderlich.
  • So gehts weiter Geben Sie /signin ein, um sich zu authentifizieren.
  • Hilfe erhalten Wenn der Nutzer weitere Informationen benötigt, kann er /help eingeben.
Sie müssen sich authentifizieren.
Diese Fehlermeldung ist nicht ausführbar, da nicht angegeben wird, wie die Authentifizierung erfolgen soll.
Anmelden.
Diese Fehlermeldung ist nicht hilfreich, da nicht erklärt wird, wie man sich anmeldet. Außerdem wird angedeutet, dass der Nutzer abgemeldet ist, anstatt dies klar zu formulieren. Das ist verwirrend.
Besprechung kann nicht geplant werden.
Diese Fehlermeldung ist nicht hilfreich, da sie dem Nutzer nicht mitteilt, warum die Besprechung nicht geplant werden kann oder wie er vorgehen kann. Es wird keine Hilfe angeboten.