כתיבת הודעות שגיאה שימושיות

בדף הזה מתוארות שיטות מומלצות לכתיבת הודעות שגיאה שאפשר לפעול לפיהן, שמספקות למשתמש הוראות לתיקון הבעיה כדי שהוא יוכל להשלים את המטרה שלו.

כשמשתמשים באפליקציית Google Chat, הודעות שגיאה יכולות להיות חוויה מתסכלת אם אין אפשרות לפעול לפיהן. לדוגמה, הודעת השגיאה An error occurred לא מועילה כי היא לא מסבירה מה השתבש, איך המשתמש יכול לפתור את הבעיה או איך הוא יכול לקבל עזרה. בדף הזה מוסבר איך ליצור הודעות שגיאה שימושיות למשתמשים, באמצעות דוגמאות לפעולות שאפשר לבצע ודוגמאות לפעולות שאי אפשר לבצע.

המבנה של הודעת השגיאה

למבנה של הודעת שגיאה עם פעולה יש את המבנה הבא:

• מה השתבש הסבר על הסיבה לכך שאפליקציית Chat לא יכולה להשלים בקשה יעזור למשתמש לפתור את הבעיה. הסבר על הסיבה לשגיאה יוצר אמון.
• איך המשתמש יכול להמשיך לעבר היעד שלו. אף פעם לא מספיק רק לומר מה השתבש. ציינו למשתמשים איך הם יכולים להתגבר על השגיאה ולהשלים את היעד.
• איך מקבלים עזרה אם המשתמש עדיין לא מצליח, ציינו איך הוא יכול לקבל עזרה נוספת. הפקודה יכולה להיות /help או קישור למסמכי העזרה של אפליקציית Chat.

דוגמה להודעת שגיאה: פורמט התאריך שגוי

בדוגמה הזו, המשתמש הזין תאריך בפורמט שלא תואם לאפליקציית Chat. הם כתבו November 19, 2021, אבל אפליקציית Chat מצפה ל-2021-11-19.

ריכזנו כאן גרסה שדורשת פעולה וגרסה שלא דורשת פעולה של הודעת השגיאה שמופיעה בתגובה מאפליקציית Chat:

שגיאה שניתן לטפל בה

משתמש מבקש מאפליקציית Chat לקבוע פגישה עם משתמש אחר. אפליקציית Chat תגיב בהודעת שגיאה טובה שאפשר לפעול לפיה:

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

הודעת השגיאה הזו מאפשרת לבצע פעולות מהסיבות הבאות:

• כתוב מה השתבש. אפליקציית Chat לא מזהה את פורמט התאריך.
• מסבירים איך לתקן את השגיאה על ידי ציון פורמט התאריך הצפוי, ומציינים תאריך לדוגמה כדי לעזור לאנשים להבין מה צריך לכתוב.
• מציעה עזרה נוספת באמצעות פקודה עם קו נטוי /help. אם המשתמשים עדיין נתקלים בבעיות, הם יידעו איפה למצוא מידע נוסף.

שגיאה שלא ניתן לבצע בה פעולה

משתמש מבקש מאפליקציית Chat לקבוע פגישה עם משתמש אחר. תופיע הודעת שגיאה לא מועילה ב-Chat:

Enter the correct date format.

לא ניתן לבצע פעולה כלשהי בעקבות הודעת השגיאה הזו מהסיבות הבאות:

• לא מצוין אם הוא זה שקבע את הפגישה. יכול להיות שהמשתמש לא ירצה לקבוע מועד חדש לפגישה, או שהוא יסיק שהיא הוגדרה.
• לא מוסבר למשתמש איך לבחור את הפורמט של התאריך. במקום להניח שהמשתמשים יודעים איך לעצב את התאריך, צריך לציין את פורמט התאריך הצפוי yyyy-mm-dd.
• לא מציע עזרה נוספת. אם המשתמשים נתקעים ולא יודעים איך להמשיך, יכול להיות שהם יפסיקו לשלוח הודעות באפליקציית Chat.

רוצה לנסות?

עכשיו, אחרי שלמדתם איך לכתוב שגיאות שאפשר לבצע בהן פעולה, תוכלו לזהות בתרחיש הבא אילו מהשגיאות האלה אפשר לבצע בהן פעולה:

אפליקציית Chat יוצרת אירועים ביומן כשמשתמשים שולחים לה הודעה עם מילת המפתח schedule. כדי ליצור אירוע ביומן, צריך לבצע אימות משתמש באפליקציית Chat. אם המשתמש לא אומת, תופיע הודעת שגיאה באפליקציית Chat.