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

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

عندما يتفاعل مستخدم مع تطبيق 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 برسالة خطأ.

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