يجب توثيق كل خطأ بمرفق واحد على الأقل. من خلال مرفقاتك، فإنك تقدم دليلًا على أن الخطأ يحدث على جهازك أو نظام التشغيل أو/و المتصفح الخاص بك.
ملاحظة: المرفقات لا تُستبدل بالمعلومات المكتوبة في تقريرك. المرفقات هي تصور للمشكلة وتعمل كدليل.
لقطة شاشة أم تسجيل فيديو؟
بشكل عام، تتطلب الأخطاء الوظيفية تسجيل فيديو ليتم توضيحها بشكل صحيح وفعال. ما لم يطلب التعليمات أو قائد الفريق مرفقات محددة، استخدم القاعدة التالية لتحديد ما إذا كانت لقطة الشاشة أو تسجيل الفيديو مطلوبة لخطئك:
كلما كانت هناك حاجة إلى إجراء لتفعيل الخطأ أو عند الحاجة إلى توضيح عملية، قم برفع تسجيل فيديو. لقطات الشاشة كصور ثابتة لا يمكنها توضيح السبب الجذري. لهذا السبب، الأخطاء الوظيفية ستتطلب دائمًا تسجيل فيديو.
عندما يكون طبيعة الخطأ ثابتة، مثل مشاكل واجهة المستخدم الرسومية (GUI) الثابتة، تكفي لقطة الشاشة وتكون تصورًا أفضل من الفيديو. لقطات الشاشة تكفي لقضايا المحتوى أو القضايا البصرية.
متطلبات عامة للمرفقات
يجب إنشاء مرفقات جديدة لكل تقرير خطأ أو إعادة إنتاج.
يُحظر نسخ المرفقات من تقارير أخطاء أو إعادة إنتاج أخرى.
يجب أن تُظهر المرفقات جميع المعلومات ذات الصلة بالخطأ لتعمل كدليل.
يجب أن تُعرض جميع المعلومات ذات الصلة باللغة الإنجليزية (أو الألمانية كخيار إذا كانت لغة التقرير بالألمانية)، مثل التاريخ، الوقت، معلومات النظام، ورسائل الخطأ.
يجب عليك تحديد جهاز أو متصفح واحد فقط عند الإبلاغ عن الخطأ، ورفع مرفق له فقط. إذا كنت قادرًا على إعادة إنتاج الخطأ على أجهزة أو متصفحات أخرى، يرجى ذكر ذلك في النتيجة الفعلية.
لا تُظهر أي معلومات عن عملاء Test IO الآخرين يمكن ربطها بـ Test IO (مثل رسائل الدعوة عبر البريد الإلكتروني أو أسماء علامات التبويب في المتصفح). عرض التطبيقات المثبتة لعملاء آخرين مسموح به.
لا تُظهر أي معلومات شخصية أو بيانات غير مهنية مثل الصور، مقاطع الفيديو أو اقتراحات التصحيح التلقائي للكلمات السيئة. تذكر أن مرفقاتك ستكون متاحة لمختبرين آخرين، لفريق Test IO وللعميل، لذا كن حذرًا فيما تُظهره.
لاختبارات المواقع، يجب أن يكون حقل URL مرئيًا في المرفقات.
يجب أن تكون الدقة عالية بما يكفي بحيث يمكن التعرف بسهولة على النص والعناصر.
يرجى دائمًا تسجيل شاشتك بالكامل.
سجل الأعطال إلزامي لتقارير الأخطاء والإعادات الإيجابية لأعطال التطبيقات. يجب أن يتوافق الفيديو الذي يوثق العطل مع سجل العطل المرفق، أي أن التوقيتات يجب أن تكون متطابقة.
قواعد خاصة بالتاريخ والوقت
يجب أن يكون التاريخ والوقت الحاليان مرئيين في المرفقات.
عند إثبات الخطأ عبر لقطة شاشة على جهاز محمول، يجب رفع لقطة شاشة ثانية تُظهر التاريخ والوقت (يجب أن يتطابق شحن البطارية والوقت مع لقطة الشاشة الأولى).
يمكن أن يكون التاريخ بأي تنسيق شائع (DD/MM أو MM/DD)، بالإنجليزية (أو الألمانية اختياريًا إذا كانت لغة التقرير بالألمانية).
يجب أن يكون الوقت بصيغة 24 ساعة، أو إذا كنت تستخدم صيغة 12 ساعة، يرجى التأكد من استخدام تنسيق AM/PM.
بإظهار التاريخ الحالي على مرفقك، تُثبت أنك قمت بتسجيله في ذلك التاريخ. فيما يلي اقتراحات لمكان العثور على التاريخ:
Windows: عرض شريط المهام أو إظهار التقويم.
Mac: عرض أيقونة التقويم في Dock أو شريط القائمة.
iOS و Android: اسحب للأسفل مركز الإشعارات في بداية التسجيل.
مزيد من المعلومات: How-to-Geek.
ما الذي يجب تضمينه في لقطة الشاشة؟
قواعد خاصة بلقطات الشاشة:
يجب أن تكون لقطة الشاشة بصيغة JPG أو PNG.
يجب إبراز الخطأ في لقطة الشاشة.
نوصي بأدوات التسجيل وأفضل الممارسات في المقالة التالية: لقطات الشاشة.
يمكنك الاطلاع على الأخطاء الأكثر شيوعًا في المقالة التالية: الأخطاء الشائعة في المرفقات.
ما الذي يجب تضمينه في تسجيل الفيديو؟
يجب أن تكون تسجيلات الفيديو قصيرة قدر الإمكان ولكن بطول كافٍ لإظهار الخطأ. وهذا يعني أنه يجب ترك الخطوات التي لا تسبب الخطأ. على سبيل المثال، عندما يكون زر "إضافة إلى السلة" معطلاً في صفحة تفاصيل المنتج في متجر إلكتروني، عادة لا يهم كيف تنقلت في المتجر للوصول إلى صفحة المنتج. آخر خطوة تنقل، الخطوة التي تفعّل الخطأ، والخطأ نفسه عادة ما تكون كافية.
مثال 1: خطأ على الموقع، تم اختباره على جهاز سطح المكتب
خطوات إنتاج تسجيل الفيديو:
انتقل إلى الصفحة حيث يحدث الخطأ.
ابدأ التسجيل.
قم بتحديث الصفحة.
نفذ الإجراء الذي يفعّل الخطأ.
انتظر حتى يحدث الخطأ.
أوقف التسجيل.
مثال 2: خطأ في التطبيق، تم اختباره على جهاز محمول
خطوات إنتاج تسجيل الفيديو:
شغّل التطبيق وانتقل إلى الصفحة حيث تحتاج خطوة تنقل واحدة فقط للوصول إلى الصفحة التي يحدث فيها الخطأ.
ابدأ التسجيل.
اسحب للأسفل مركز الإشعارات لإظهار التاريخ الحالي لبضع ثوانٍ.
نفذ آخر خطوة تنقل للوصول إلى الصفحة الصحيحة.
نفذ الإجراء الذي يفعّل الخطأ.
انتظر حتى يحدث الخطأ.
أوقف التسجيل.
قد يرسل لك قادة الفرق طلب معلومات إضافية يطلبون تسجيلًا إضافيًا أو خارجيًا. يتم ذلك لفهم الخطأ بشكل أفضل أو عند الشك بسبب عدم إمكانية إعادة إنتاج الخطأ.
قواعد خاصة بتسجيلات الفيديو:
يجب أن تكون بصيغة MP4.
الحجم الأقصى للمرفق هو 25 ميغابايت.
الحد الأقصى لمدة التسجيل هو 60 ثانية لتقارير الأخطاء، إلا إذا كان الخطأ يتطلب عرض عملية تحميل أو إدخالات يدوية طويلة.
الحد الأقصى لمدة التسجيل هو 15 ثانية لإعادات الإنتاج (Reproductions) ومرفقات قصص المستخدم (User Stories).
يجب أن تكون النقرات/اللمسات/المؤشر مرئية (مطلوبة فقط لتسجيلات Android وسطح المكتب).
يجب أن يتم التسجيل دفعة واحدة، لا يُسمح بالإيقاف أو القص في الوسط. إذا كان الفيديو طويلًا جدًا وتريد تحريره، فقط قص البداية أو النهاية.
لا يُسمح بتسريع الفيديو. إذا تجاوزت المدة المسموح بها، تحقق مما إذا كنت قد عرضت خطوات غير ضرورية.
لا تُسجل أي ضوضاء (بكاء طفل، محادثات، تلفاز، موسيقى، حيوانات أليفة، إلخ).
نوصي بأدوات التسجيل وأفضل الممارسات في المقالة التالية: سجلات الشاشة.
يمكنك الاطلاع على الأخطاء الأكثر شيوعًا في المقالة التالية: الأخطاء الشائعة في المرفقات.
قواعد خاصة بتسجيلات الفيديو لأجهزة البث:
قم دائمًا بتسجيل شاشة التلفاز بالكامل.
يجب أن تكون دقة الفيديو عالية وجودة جيدة.
يجب ألا تكون الإضاءة المحيطة مظلمة.
يجب أن يكون جهاز التحكم عن بُعد مرئيًا بالكامل وبوضوح.
يجب عرض التاريخ والوقت الحاليين في المرفق (يمكن عرضه على التلفاز نفسه، أو على جهاز خارجي مثل الكمبيوتر أو الهاتف أو الجهاز اللوحي).
المدة القصوى للتسجيل: 60 ثانية لتقارير الأخطاء، و15 ثانية للإعادات وقصص المستخدم.
لا تُسجل أي ضوضاء (بكاء طفل، محادثات، تلفاز، موسيقى، حيوانات أليفة، إلخ).
يجب أن يبدو التسجيل احترافيًا دائمًا — لا تُسجل ساقيك، أو حاملة تلفاز فوضوية، أو ما شابه ذلك.
كيفية تسجيل فيديو لأخطاء لوحة المفاتيح؟
أحيانًا يتم إنتاج الأخطاء عند التفاعل مع المواقع باستخدام مفاتيح لوحة المفاتيح.
في هذه الحالة، وبما أنه يجب إظهار الإجراء الذي يفعّل الخطأ في التسجيل، فإن إظهار إدخال لوحة المفاتيح إلزامي.
إليك مثال ممتاز حول كيفية إنشاء تسجيل فيديو يُظهر إدخال لوحة المفاتيح:
إتقان مرفقات تسجيل الفيديو لجميع الأجهزة
طمس المعلومات الخاصة في المرفقات
لحماية معلوماتك الخاصة مثل الإشارات المرجعية، أسماء الحسابات أو رسائل البريد الإلكتروني المخزنة من أن تكون مرئية في علامات التبويب، يمكنك استخدام تقنية بسيطة لطمسها. ومع ذلك، لتسهيل عملية الإبلاغ عن الأخطاء، يُوصى باستخدام نافذة متصفح مخصصة لغرض الاختبار، كما هو موضح في المثال أدناه حيث لا توجد علامات تبويب غير ضرورية مفتوحة أو إشارات مرجعية مرئية.
إذا كنت بحاجة إلى تضمين معلومات خاصة في مرفقاتك ولكن لا ترغب في أن تكون مرئية، يمكنك اتباع هذا المثال لإخفائها بشكل احترافي؛ لاحظ أن أسماء علامات التبويب التي قد تُظهر عناوين بريد إلكتروني، أسماء مستخدمين أو إشارات مرجعية قد تم إخفاؤها.
من المهم أن يكون حقل URL مرئيًا وأن لا يتم حجب عناصر الموقع.
لأسباب مهنية، من الضروري تجنب الطرق اليدوية أو البدائية عند تغطية المعلومات في مرفقاتك، كما هو موضح في المثال أدناه:
