Umsetzbare Fehlermeldungen schreiben

Auf dieser Seite werden Best Practices zum Verfassen umsetzbarer Fehlermeldungen beschrieben, die Nutzern mitteilen, wie sie das Problem beheben können, damit sie ihr Ziel erreichen.

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 die Meldung nicht erklärt, was schiefgelaufen ist, wie der Nutzer das Problem beheben kann oder wie der Nutzer Hilfe erhält. Auf dieser Seite wird beschrieben, wie Sie Fehlermeldungen so strukturieren, dass 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 Nutzer Hilfe erhalten. 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, die Chat-App erwartet aber 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 angegeben, was schiefgelaufen ist. Die Chat-App erkennt das Datumsformat nicht.
  • Es wird erklärt, wie der Fehler behoben werden kann. Dazu wird das erwartete Datumsformat angegeben und ein Beispieldatum genannt, damit 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 angegeben, ob die Besprechung geplant wurde. Der Nutzer zögert möglicherweise, die Besprechung neu zu planen, oder geht davon aus, dass sie 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

Nachdem Sie nun wissen, wie Sie umsetzbare Fehlermeldungen verfassen, können Sie im folgenden Szenario erkennen, welche dieser Fehlermeldungen 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?
Bevor ich die Besprechung planen kann, müssen Sie sich anmelden. Geben Sie dazu /signin ein. Weitere Informationen erhalten Sie mit /help.
Diese Fehlermeldung ist umsetzbar, da 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 Nutzer Hilfe erhalten. Wenn der Nutzer weitere Informationen wünscht, kann er /help eingeben.
Sie müssen sich authentifizieren.
Diese Fehlermeldung ist nicht umsetzbar, da nicht angegeben wird, wie die Authentifizierung erfolgt.
Melden Sie sich an.
Diese Fehlermeldung ist nicht umsetzbar, da nicht angegeben wird, wie sich der Nutzer anmelden kann. Außerdem wird angedeutet, dass der Nutzer abgemeldet ist, anstatt dies klar zu sagen, was verwirrend ist.
Besprechung kann nicht geplant werden.
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.