Umsetzbare Fehlermeldungen schreiben

Auf dieser Seite werden Best Practices zum Verfassen umsetzbarer Fehlermeldungen beschrieben, die dem Nutzer mitteilen, wie er das Problem beheben kann, damit er sein Ziel erreichen kann.

Wenn ein Nutzer mit einer Google Chat-App interagiert und auf Fehlermeldungen stößt, kann das frustrierend sein, wenn der Fehler nicht umsetzbar ist. 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 erhält. Auf dieser Seite wird beschrieben, wie Sie Fehlermeldungen strukturieren, damit sie für Nutzer nützlich sind. Dazu werden umsetzbare und nicht umsetzbare Beispiele gezeigt.

Struktur von Fehlermeldungen

Eine umsetzbare Fehlermeldung hat die folgende Struktur:

  • Was ist schiefgelaufen? Wenn Sie angeben, warum die Chat-App eine Anfrage nicht ausführen kann, können Nutzer das Problem beheben. Wenn Sie erklären, warum ein Fehler aufgetreten ist, schaffen Sie Vertrauen.
  • Wie der Nutzer sein Ziel erreichen kann. Es reicht nie aus, nur zu sagen, was schiefgelaufen ist. Teilen Sie Nutzern mit, wie sie den Fehler beheben und ihr Ziel erreichen können.
  • Wie man Hilfe erhält. Wenn der Nutzer immer noch nicht weiterkommt, teilen Sie ihm mit, wie er weitere Hilfe erhalten kann. Das kann ein /help-Befehl oder ein Link zur Dokumentation Ihrer Chat-App sein.

Beispiel für eine Fehlermeldung: falsches Datumsformat

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

Hier sind eine umsetzbare und eine nicht umsetzbare Version der Fehlermeldung, mit der die Chat-App antwortet:

Umsetzbarer Fehler

Ein Nutzer bittet die Chat-App, eine Besprechung mit einer anderen Person zu planen. 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, die dem Nutzer mitteilt, was schiefgelaufen ist, wie er vorgehen soll und wie er Hilfe erhalten kann.

Diese Fehlermeldung ist aus folgenden Gründen umsetzbar:

  • Es wird gesagt, was schiefgelaufen ist. Die Chat-App erkennt das Datumsformat nicht.
  • Es wird erklärt, wie der Fehler behoben werden kann, indem dem Nutzer das erwartete Datumsformat mitgeteilt wird. Außerdem wird ein Beispieldatum angegeben, damit die Nutzer wissen, was sie eingeben müssen.
  • Mit dem Slash-Befehl /help wird weitere Hilfe angeboten. Wenn Nutzer immer noch nicht weiterkommen, wissen sie, wie sie weitere Informationen erhalten.

Nicht umsetzbarer Fehler

Ein Nutzer bittet die Chat-App, eine Besprechung mit einer anderen Person zu planen. Die Chat-App antwortet mit einer nicht hilfreichen, nicht umsetzbaren Fehlermeldung:

Enter the correct date format.

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

Diese Fehlermeldung ist aus folgenden Gründen nicht umsetzbar:

  • Es wird nicht gesagt, ob die Besprechung geplant wurde. Der Nutzer zögert möglicherweise, die Besprechung neu zu planen, oder geht davon aus, dass die Besprechung geplant wurde.
  • Es wird nicht erklärt, wie das Datum formatiert werden muss. Statt 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

Jetzt wissen Sie, wie Sie umsetzbare Fehlermeldungen verfassen. Können Sie im folgenden Szenario erkennen, welcher dieser Fehler umsetzbar ist:

Eine Chat-App erstellt Kalendertermine, wenn Nutzer der Chat-App eine Nachricht mit dem Keyword schedule senden. Zum Erstellen eines Kalendertermins ist eine Nutzerauthentifizierung erforderlich. Wenn ein Nutzer nicht authentifiziert wurde, antwortet die Chat-App mit einer Fehlermeldung.

Welche Fehlermeldung ist umsetzbar?
Before I can schedule the meeting, you must sign in by typing /signin. To learn more, type /help.
Diese Fehlermeldung ist umsetzbar, weil sie Folgendes enthält:
  • Was ist schiefgelaufen? Die Chat-App erfordert eine Authentifizierung.
  • Wie geht es weiter? Geben Sie /signin ein, um sich zu authentifizieren.
  • Wie man Hilfe erhält. Wenn der Nutzer weitere Informationen wünscht, kann er /help eingeben.
You must authenticate.
Diese Fehlermeldung ist nicht umsetzbar, da nicht angegeben wird, wie man sich authentifizieren kann.
Sign in.
Diese Fehlermeldung ist nicht umsetzbar, da nicht angegeben wird, wie man sich anmelden kann. Außerdem wird angedeutet, dass der Nutzer abgemeldet ist, anstatt es klar zu sagen, was verwirrend ist.
Can't schedule meeting.
Diese Fehlermeldung ist nicht umsetzbar, da nicht angegeben wird, warum die Besprechung nicht geplant werden kann oder wie der Nutzer vorgehen soll. Es wird keine Hilfe angeboten.