Na tej stronie opisujemy sprawdzone metody tworzenia przydatnych komunikatów o błędach, które informują użytkownika, jak rozwiązać problem, aby dokończył realizację celu.
Gdy użytkownik korzysta z aplikacji Google Chat, komunikaty o błędach mogą być frustrujące, gdy nie można podjąć żadnych działań.
Na przykład komunikat o błędzie An error occurred nie jest przydatny, ponieważ nie wyjaśnia, co poszło nie tak, jak użytkownik może rozwiązać problem ani jak może uzyskać pomoc. Ta strona zawiera informacje o tym, jak uporządkować komunikaty o błędach w taki sposób, aby były przydatne dla użytkowników, pokazując przykłady użytecznych i niewykonalnych działań.
Struktura komunikatu o błędzie
Użyteczny komunikat o błędzie ma taką strukturę:
- Co poszło nie tak. Powiedzenie, dlaczego aplikacja Google Chat nie może zrealizować żądania, pomaga użytkownikowi rozwiązać problem. Wyjaśnienie, dlaczego wystąpił błąd, buduje zaufanie.
- Sposób, w jaki użytkownik może przejść do celu. Nie wystarczy powiedzieć, co poszło nie tak. Powiedz użytkownikom, jak mogą uniknąć błędu i osiągnąć cel.
- Jak uzyskać pomoc Jeśli użytkownik nadal ma problem, powiedz mu, jak może uzyskać dalszą pomoc. Może to być polecenie
/helplub link do dokumentacji aplikacji Google Chat.
Przykładowy komunikat o błędzie: nieprawidłowy format daty
W tym przykładzie użytkownik podał datę w formacie, którego aplikacja Google Chat nie oczekiwała. Pisali oni
November 19, 2021, a aplikacja Google Chat oczekuje
2021-11-19.
Oto praktyczna i niezbędna do działania wersja komunikatu o błędzie, którą aplikacja Google Chat obsługuje:
Błąd wymagające działania
Użytkownik prosi aplikację Google Chat o zaplanowanie spotkania z inną osobą. Aplikacja Google Chat w odpowiedzi wyświetla dobry komunikat o błędzie, który można wykonać:
I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.
Ten komunikat o błędzie umożliwia podjęcie działania z następujących powodów:
- z informacją, co poszło nie tak. Aplikacja Google Chat nie rozpoznaje formatu daty.
- Wyjaśnia, jak naprawić błąd, informując użytkownika o oczekiwanym formacie daty, i podaje przykładową datę, która pomoże użytkownikom zrozumieć, co ma napisać.
- Dodatkowa pomoc dotycząca polecenia po ukośniku w języku
/help. Jeśli użytkownicy wciąż utknęli, wiedzą, jak uzyskać więcej informacji.
Błąd związany z brakiem możliwości podjęcia działania
Użytkownik prosi aplikację Google Chat o zaplanowanie spotkania z inną osobą. Aplikacja Google Chat w odpowiedzi wyświetla nieprzydatny komunikat o błędzie, który uniemożliwia podjęcie działania:
Enter the correct date format.
Nie można podjąć działania związanego z tym komunikatem o błędzie z następujących powodów:
- Nie ma tu informacji o tym, czy zaplanowano spotkanie. Użytkownik może mieć wątpliwości, czy można je przełożyć lub uznać, że spotkanie zostało zaplanowane.
- Nie informuje użytkownika, jak sformatować datę. Zamiast zakładać, że użytkownicy wiedzą, jak sformatować datę, należy powiedzieć, że spodziewany jest format daty
yyyy-mm-dd. - Nie oferuje dodatkowej pomocy. Gdy użytkownicy utkną i nie będą wiedzieć, co zrobić dalej, mogą przestać wysyłać wiadomości do aplikacji Google Chat.
Wypróbuj
Wiesz już, jak pisać przydatne błędy, więc teraz ustalisz, które z tych błędów można wykorzystać w następujących sytuacjach:
Aplikacja Google Chat tworzy wydarzenia w kalendarzu, gdy użytkownicy wysyłają do aplikacji Google Chat słowo kluczowe schedule. Aby utworzyć wydarzenie w kalendarzu, aplikacja Google Chat wymaga uwierzytelnienia użytkownika. Jeśli użytkownik nie został uwierzytelniony, aplikacja Google Chat w odpowiedzi wyświetli komunikat o błędzie.
/signin. Aby dowiedzieć się więcej, wpisz /help.- Co poszło nie tak. Aplikacja Google Chat wymaga uwierzytelnienia.
- Co zrobić. Wpisz
/signin, aby uwierzytelnić. - Jak uzyskać pomoc Jeśli użytkownik chce uzyskać więcej informacji, może wpisać
/help.