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

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

כשמשתמש יוצר אינטראקציה עם אפליקציית 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 יוצרת אירועים ביומן כשמשתמשים שולחים הודעה למשתמשים אפליקציית Chat עם מילת המפתח schedule. שפת תרגום ליצור אירוע ביומן, אפליקציית Chat דורשת משתמש אימות. אם המשתמש לא אומת, אפליקציית Chat מגיבה עם הודעת שגיאה.