كتابة رسائل خطأ قابلة للتنفيذ

تصف هذه الصفحة أفضل الممارسات لكتابة رسائل خطأ قابلة للتنفيذ تخبر للمستخدم كيفية إصلاح المشكلة حتى يتمكن من تحقيق هدفه.

عندما يتفاعل مستخدم مع تطبيق Google Chat، يمكن أن يكون الخطأ تجربة محبطة عندما لا يكون بالإمكان اتخاذ إجراء بشأن الخطأ. على سبيل المثال، رسالة الخطأ An error occurred ليست مفيدة نظرًا لأن رسالة لا توضح الخطأ الذي حدث أو كيف يمكن للمستخدم حل المشكلة أو كيف للمستخدم الحصول على المساعدة. تصف هذه الصفحة كيفية هيكلة رسائل الخطأ بحيث أنها مفيدة للمستخدمين من خلال إظهار أمثلة قابلة للتنفيذ وغير قابلة للتنفيذ.

بنية رسالة الخطأ

تحتوي رسالة الخطأ القابلة للتنفيذ على البنية التالية:

• الأخطاء التي حدثت توضيح سبب تعذّر على تطبيق Chat إكمال الطلب لمساعدة المستخدم في حل المشكلة. شرح سبب حدوث خطأ حدثت تبني الثقة.
• كيف يمكن للمستخدم المتابعة نحو تحقيق هدفه. لا يكفي أبدًا قول الخطأ الذي حدث. إخبار المستخدمين بكيفية تجاوز الخطأ وإكمال هدفه.
• كيفية الحصول على المساعدة إذا كان المستخدم لا يزال عالقًا، فأخبره كيف يمكنه التغلّب على المزيد من المساعدة. قد يكون هذا أمرًا /help أو رابطًا لوثائق تطبيق Chat

مثال على رسالة الخطأ: تنسيق تاريخ غير صحيح

في هذا المثال، أدخل المستخدم تاريخًا بتنسيق لم يتوقعه تطبيق Chat. كتبوا November 19, 2021، ولكن يتوقع تطبيق Chat. 2021-11-19

إليك نسخة قابلة للتنفيذ وغير قابلة للتنفيذ من رسالة الخطأ التي يردّ تطبيق 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 يردّ برسالة خطأ