في هذا المقال، ستتعلم كيفية توثيق الخلل بشكل صحيح وفقًا لقواعدنا ومعاييرنا. لفهم الخلل، يحتاج العملاء إلى معلومات كافية وتوثيق عالي الجودة. ستجد معلومات أكثر تفصيلًا حول قواعدنا في كل قسم من هذا المقال، ولكن فيما يلي ملخص سريع لمتطلبات تقرير الخلل لدينا:
إذا كنت تقوم بالإبلاغ عن خلل وظيفي، يجب عليك اختيار أحد مستويات الشدة المتاحة قبل ملء بقية تقرير الخلل.
يجب أن يلخص العنوان الخطأ وأن يتضمن المعلومات اللازمة لفهم المشكلة دون الحاجة إلى فتح تقرير الخطأ. وتشمل هذه المعلومات ما الذي حدث، وأين وقع الخطأ، ومتى أو كيف أو في ظل أي شرط تم التسبب في ظهوره.
يجب أن يكون عنوان URL هو عنوان صفحة الويب التي وقع فيها الخطأ. يمكنك ببساطة نسخ عنوان URL من شريط العنوان في المتصفح.
وثّق الخطوات التي، عند اتباعها، تتيح لك إعادة إنتاج الخطأ.
يجب أن يتكون الناتج الفعلي من جملة أو أكثر توضح ما حدث بعد آخر إجراء. يمكنك أيضًا إضافة نتائج الإجراءات السابقة إذا كانت ضرورية لفهم الخلل. يجب ألا تكون نفس العنوان.
فكّر فيما كان ينبغي أن يحدث لو لم يكن الخطأ موجودًا، ثم اكتب هذا التوقع في قسم النتيجة المتوقعة.
أضف مرفقًا يُظهر الخطأ لعرضه بصريًا والتأكد من وجوده.
أخيرًا، يجب عليك تحديد البيئة المستخدمة والمتصفح الصحيح (إذا كان ذلك ممكنًا) المستخدم للاختبار، بناءً على الجهاز الذي تمت دعوتك لاختباره عند قبولك للدورة.
خطوتك الأولى في نموذج تقرير الأخطاء يجب أن تكون اختيار الميزة الصحيحة. إذا لم تتمكن من العثور على الميزة الصحيحة في القائمة المنسدلة، عد إلى صفحة نظرة عامة على الاختبار، استعرض جميع وصف الميزات واعتبرها مقروءة. بعد ذلك، يمكنك العودة إلى نموذج تقرير الأخطاء وسيتم عرض جميع الميزات في القائمة المنسدلة.
نموذج الخلل
بعد اختيار الميزة، سيظهر لك نموذج الأخطاء بالكامل. على سبيل المثال، نموذج الأخطاء الوظيفية يبدو كالتالي:
يجب عليك ملء كل حقل في نموذج الأخطاء بالمعلومات الصحيحة والمحددة وفقًا لمعايير الجودة لدينا. يمكن العثور على معلومات أكثر تفصيلًا حول كل حقل ومتطلباته أدناه.
الشدة
بالنسبة للأخطاء الوظيفية فقط، سترى حقلًا إضافيًا يسمى الشدة: منخفضة، عالية، و/أو حرجة. تشير الشدة إلى مدى إلحاح تقريرك وتعتمد على عوامل متعددة. لمعرفة مستويات الشدة المختلفة، يرجى زيارة المقال التالي: الأخطاء الوظيفية.
لن يتم عرض حقل الشدة لأنواع الأخطاء الأخرى.
العنوان
يجب أن يلخّص عنوان تقرير الخطأ الخطأ بحيث يحصل القارئ على فكرة عامة عن المشكلة بمجرد قراءة العنوان. ولا ينبغي أن يضطر إلى قراءة التقرير بالكامل لفهم طبيعة الخطأ. يجب أن يكون عنوان تقرير الخطأ دقيقًا وموجزًا.
يحتوي عنوان الخطأ الجيد على المعلومات اللازمة لفهم المشكلة وتمييزها عن تقارير الأخطاء الأخرى. وتشمل هذه المعلومات ما يلي:
ماذا حدث؟
أين حدث الخطأ؟
متى أو كيف أو في ظل أي شرط تم التسبب في ظهور الخطأ؟
عند كتابة عنوان الخطأ، صف ما يحدث بدلًا من وصف ما لا يحدث. تجنّب العبارات العامة مثل "لا يعمل"، وركّز على السلوك الفعلي الذي تمت ملاحظته.
يجب أن تعكس العناوين المشكلة الحقيقية. إذا حدث الخلل فقط في ظل ظروف معينة، يجب تضمين هذه الظروف في العنوان. على سبيل المثال، إذا لم تتمكن من حجز تذكرة عندما تذكر أنك مراهق، فهذه معلومة ذات صلة ويجب تضمينها في العنوان.
للتوصل إلى عنوان وصفي، ضع نفسك مكان شخص لم يختبر الموقع/التطبيق من قبل، ولا يمكنه تصور الصفحة التي أنت فيها، كيف تبدو وما الذي فعلته. اقرأ عنوانك من منظور ذلك الشخص لترى إذا كنت ستفهم الخلل. إذا لم تحصل على فكرة جيدة عن الخلل، عدل عنوان الخلل وكرر العملية.
أمثلة على عناوين الأخطاء:
صحيح | خاطئ |
يتم عرض رسالة خطأ في صفحة Checkout عند إرسال طلب باستخدام PayPal. | صفحة Checkout لا تعمل. |
تعرض صفحة Cart خطأ 404 عند فتحها بواسطة مستخدم قام بتسجيل الدخول. | تعرض صفحة Cart خطأ 404. |
الرابط (URL)
انتقل إلى الصفحة التي يظهر فيها الخطأ، ثم انسخ والصق عنوان URL من شريط العنوان في متصفحك داخل حقل URL في نموذج تقرير الخطأ. يجب أن يكون عنوان URL صالحًا.
أمثلة
السيناريو | عنوان URL الصحيح | عنوان URL غير الصحيح |
زر "Add to Cart" لا يستجيب في صفحة تفاصيل المنتج (PDP). | عنوان URL الخاص بصفحة تفاصيل المنتج (PDP) التي تم النقر فيها على الزر. مثال: https://www.example.com/product/running-shoes | عنوان URL لأي صفحة أخرى. |
يؤدي رابط إلى صفحة 404. | عنوان URL للصفحة التي تحتوي على الرابط المعطّل. مثال: https://www.example.com/sale | عنوان URL لصفحة 404 نفسها. مثال: https://www.example.com/404 |
خطوات إعادة الإنتاج
يجب أن يكون الخلل قابلاً لإعادة الإنتاج. ويتطلب ذلك خطوات مفصّلة خطوة بخطوة لكيفية إعادة إنتاجه. يجب أن تصف كل خطوة إجراءً منفصلاً.
ملاحظة: لا تحتاج إلى ترقيم خطواتك حيث يتم ذلك تلقائيًا بواسطة نظامنا.
يجب أن تتضمن الخطوة الأولى إشارة إلى الوصول إلى عنوان URL الخاص ببيئة العميل والمذكور في قسم Access إذا كنت تختبر موقعًا إلكترونيًا، أو إشارة إلى فتح التطبيق (مع ذكر اسمه) إذا كنت تختبر تطبيقًا على الهاتف المحمول. مثال:
بالنسبة للمواقع الإلكترونية:
افتح https://test.io/
بالنسبة لتطبيقات الهاتف المحمول:
افتح تطبيق testNow.
يجب أن تصف جميع الخطوات التالية الإجراءات التي تقوم بها بدءًا من الخطوة الأولى وحتى اللحظة التي يظهر فيها الخطأ، مثل الأزرار التي تضغط عليها، والروابط التي تتبعها، والبيانات التي تدخلها. ويجب أن تصف الخطوة الأخيرة الإجراء الذي تقوم به والذي يؤدي إلى ظهور الخطأ.
يجب أن تكون خطواتك عامة قدر الإمكان. فقط إذا كان الخلل يحدث تحت ظروف محددة، مثل صفحة منتج معينة، فلتر محدد، إدخال محدد، اذكر هذا الشرط في خطواتك. على سبيل المثال، في خطواتك، لا تصف صفحة منتج محددة زرتها، ثم المنتج المحدد الذي أضفته إلى السلة إذا كانت المشكلة تحدث لأي منتج. سيساعد ذلك القارئ على فهم فكرة خطأك دون التشتيت بتفاصيل غير ذات صلة.
أخيرًا، تأكد من أن خطواتك تحتوي على أقل عدد ممكن من الإجراءات. بعد قراءة كل خطوة، يجب أن يكون الشخص الذي يعيد إنتاج الخلل قادرًا على تنفيذها على الموقع أو التطبيق. لا يجب عليهم التحقق من نفس الخطوة عدة مرات لتذكر ما يجب القيام به.
أمثلة على خطوات جيدة:
اذهب إلى http://www.examplewebsite.com
أدخل أي استعلام بحث في شريط البحث أعلى اليمين (مثل "سان فرانسيسكو")
اضغط على زر "بحث الآن"
مرر لأسفل وانقر على "فرز حسب"
اختر الخيار "الفرز حسب السعر: من الأعلى إلى الأدنى"
الناتج الفعلي
الناتج الفعلي هو أحد أهم الحقول في تقرير الخلل لأنه هنا تشرح المشكلة وكل التفاصيل اللازمة لفهم الخلل.
ما يحدث بالفعل بعد اتباع دليل خطوة بخطوة يجب أن يوصف بأكبر قدر ممكن من التفصيل. حاول أن تكون دقيقًا جدًا ولا تكن عامًا جدًا، مثل القول إن المنتجات تظل في نفس الترتيب تقريبًا بعد تطبيق طريقة الفرز X، بل صف أمثلة محددة للمنتجات غير المرتبة بشكل صحيح. أضف أي معلومات في هذا الحقل ذات صلة الخلل، مثل الأمثلة، الظروف الإضافية، الاستثناءات أو نتائج أخرى مهمة إذا لزم الأمر. فقط تأكد من تنظيم معلوماتك لمساعدة القارئ على فهم طريقة تفكيرك.
ملاحظات مهمة: يجب ألا تكون النتيجة الفعلية والنتيجة المتوقعة مجرد العكس لبعضهما البعض. تختلف التوقعات حول ما كان يجب أن يحدث وما حدث فعليًا بدلاً من ذلك اختلافاً جوهرياً.
وبالمثل، يجب ألا يكون الناتج الفعلي نفس عنوان التقرير. بينما العنوان هو ملخص للمشكلة، يجب أن يكون الناتج الفعلي وصفًا تفصيليًا لها ويشمل تفاصيل إضافية مثل معلومات السيناريو، الأمثلة، والنتائج التي تم الحصول عليها أثناء تنفيذ خطوات إعادة إنتاج الخلل.
أمثلة على الناتج الفعلي
صحيح | خاطئ |
يظهر للمستخدم "خطأ 500 - خطأ داخلي في الخادم - عذرًا، حدث خطأ ما" بعد محاولته الانتقال إلى صفحة إتمام الشراء | ظهور خطأ في صفحة السلة بعد الضغط على زر إتمام الشراء |
تظهر رسالة خطأ "خطأ غير متوقع" في أعلى يمين صفحة المنتج، ولا يتم إضافة المنتج إلى السلة | لا يمكن للمستخدم إضافة منتج إلى السلة، يظهر خطأ |
الناتج المتوقع
صف ما تتوقع أن يحدث بعد تنفيذ آخر خطوة قمت بوصفها. فكّر فيما كان ينبغي أن يحدث لو لم تواجه الخطأ، أي لو كان كل شيء يعمل بشكل صحيح.
يجب أن يحتوي قسم النتيجة المتوقعة على وصف مختصر، ولكن في حالة الأخطاء المعقدة، قد تكون هناك حاجة إلى معلومات إضافية.
تذكّر أن النتيجة المتوقعة ليست هي نفسها النتيجة الفعلية مع بعض التعديلات البسيطة أو باستخدام عبارات نفي، بل هي قسم مستقل يتيح لك شرح كل ما كان ينبغي أن يحدث بعد إكمال آخر خطوة لإعادة إنتاج الخطأ.
أمثلة على النتيجة المتوقعة
صحيح | خاطئ |
يجب أن يتم تحميل صفحة إتمام الشراء (Checkout) بنجاح. | يجب إعادة توجيه المستخدم بشكل صحيح إلى صفحة إتمام الشراء، حيث ينبغي أن يتمكن من إدخال معلومات الشحن والدفع وإتمام الطلب. |
يجب إضافة منتج "Batman T-Shirt" إلى سلة التسوق حتى يتمكن المستخدم من متابعة عملية الطلب. | يجب إضافة منتج "Batman T-Shirt" إلى سلة التسوق بنجاح. يجب ألا يواجه المستخدم أخطاء مثل "Error 500"، ويجب أن يتمكن من إتمام شراء أي عناصر موجودة في سلة التسوق. |
المرفقات
لتعرف نوع المرفق الذي يجب إرفاقه لتقريرك وما هي القواعد المطبقة، يرجى زيارة المقال التالي: متطلبات مرفقات تقرير الأخطاء.
البيئة المستخدمة
من المهم لنا ولعملائنا معرفة الجهاز الذي استخدمته عند مواجهة الخلل. عند اختبار موقع ويب، انقر على أيقونة المتصفح بجانب الجهاز الذي استخدمته. عند اختبار تطبيق جوال، اختر الجهاز الذي استخدمته للاختبار والذي يحتوي على التطبيق مثبتًا.
يمكنك استخدام الأجهزة المدرجة في هذا القسم فقط للاختبار. علاوة على ذلك، يجب أن تختار جهازًا واحدًا أو متصفحًا واحدًا فقط عند الإبلاغ عن الخلل، وإرفاق المرفقات الخاصة به فقط. إذا كنت قادرًا على إعادة إنتاج الخلل على أجهزة أو متصفحات أخرى، يرجى ذكر ذلك في الناتج الفعلي.
يعد اختيار البيئة الصحيحة حيث يحدث الخللإجراءً إلزاميًا. عند تقديم تقريرك، يرجى التأكد من اختيار البيئة الصحيحة. إذا اخترت البيئة الخلل عن طريق الخلل ، يمكنك تصحيحها بعد تقديم التقرير. يمكنك القيام بهذا التعديل قبل مراجعة قائد الفريق لتقرير الخلل. إذا كان تقرير الخلل يحتوي على البيئة الخاطئة، سيرفضه قائد الفريق أثناء المراجعة.
هل ترغب في الاختبار بجهاز غير موجود في قائمة الأجهزة المتاحة في ملفك الشخصي؟ ببساطة أرسل لنا طلبًا عبر دردشة الدعم وسنضيف جهازك إلى قائمتك شريطة أن يكون ذا صلة بعملائنا.
ملاحظة: عند إزالة الجهاز الذي تمت دعوتك للاختبار عليه من قائمة الأجهزة في ملفك الشخصي كمختبر، لن تتمكن بعد الآن من تقديم تقارير في هذا الاختبار. سيصبح قسم البيئة في نموذج الخلل فارغاً ولن تتمكن من إرسال النموذج. لا يمكن استرجاع الجهاز المحذوف من ملفك الشخصي بعد قبول دعوة الاختبار!
تحسين تقريرك
بعد تقديم تقريرك، لا يزال بإمكانك تحرير جميع الحقول باستثناء نوع الخلل المختار. يجب عليك دائمًا تقديم تقارير كاملة جاهزة للمراجعة، واستخدام خيار التحرير فقط في حالة وجود خطأ مطبعي صغير أو رغبتك في إعادة صياغة كلماتك لتحسين جودة التقرير.
تذكر أنه لا يُسمح بعلامات النائب، لذا لا تقدم تقارير ناقصة لتحريرها لاحقًا.
إذا حدث خطأك فقط لأي إدخال محدد، استخدم المصطلحات التي سيستخدمها المستخدمون الفعليون وتجنب إدخال كلمات عشوائية عند إنشاء تقرير الخلل أو المرفقات. مثال سيء هو استخدام اسم مستخدم عند إنشاء حساب على واجهة العميل مثل “asdsdfkg_lajsdh”، حيث يجعل هذا تقريرك يبدو غير احترافي.
في حال قمت بتقديم تقرير خطأ عن طريق الخلل، يمكنك حذفه، ولكن فقط إذا لم يتم مراجعته بعد بواسطة قائد الفريق.









