تقرير ملخص البنية
يقوم ملخص البنية بسرد البنيات ويوفر معلومات حول نتائج الاختبار، وتغطية الاختبارات، وتغيُر التعليمات البرمجية، وملاحظات الجودة لكل بنية.
للحصول على معلومات حول كيفية الوصول إلى التقارير، أو تحديثها، أو إدارتها، راجع التقارير (Agile).
ملاحظة
يتطلب هذا التقرير تزويد مجموعة مشروع الفريق التي تحتوي على مشروع الفريق الخاص بك بخدمات التقارير SQL Server. لا يتوافر هذا التقرير فى حالة عدم ظهور تقارير .gif "تقرير"){kind=icon}
عند فتح مستكشف الفريق وتوسيع عقدة مشروع الفريق الخاص بك.
في هذا الموضوع
|
يمكنك استخدام هذا التقرير للاجابة على الأسئلة التالية:
|
الأذونات المطلوبة.
لعرض التقرير يجب أن يتم تعيينك أو أن تنتمي إلى مجموعة تم تعيينها في دور المستعرض في "خدمات التقارير". لمزيد من المعلومات، راجع إضافة مستخدمين إلى مشروعات الفريق أو إدارة الأذونات.
البيانات الموجودة في التقرير.
البيانات التي تظهر في نقرير ملخص البنية مشتقة من مستودع البيانات. يقدم التقرير عرض مرئي للنسبة المئوية للاختبارات الناجحة، والتعليمات البرمجية التى يتم اختبارها، والتغييرات في التعليمات البرمجية عبر عدة نسخ.
يمكنك مراجعة نتائج كل من البناء اليدوي و التلقائي، بالإضافة إلى أحدث البنيات والبنيات المستمرة أو المتكررة. يسرد التقرير أحدث البنيات أولاً ويحتوي على نتائج البناء التي تم التقاطها أثناء الفاصل الزمني المحدد لكافة البنيات التى تم تشغيلها، مع تطبيق عوامل التصفية التي قمت بتحديدها للتقرير.
بنظرة سريعة، يمكنك تحديد نجاح أو فشل العديد من تعريفات البناء فى الفترة الزمنية ضمن المراجعة، كما هو موضح في التوضيح التالي.
.png "مثال لتقرير ملخص البنية")
يصف الجدول التالي المعلومات التي تظهر على كل مؤشر جودة:
مؤشر جودة |
الوصف |
|---|---|
تقدم بنية |
يحدد حالة البنية. يمكن أن تكون البنية فى إحدى الحالات التالية:
|
جودة البنية |
تحديد تقييم معين يدوياً لجودة البناء. يمكنك إضافة أو إزالة خواص جودة البنية المعرّفة لمشروع الفريق الخاص بك. لمزيد من المعلومات، راجع كيفية: إضافة أو إزالة قيم جودة البناء. يكون العمود فارغاً إذا لم يتم تقييم جودة البنية. |
%الاختبارات الناجحة |
يعرض مخطط شريطي أفقى مكدس يقوم بسرد النسبة المئوية للاختبارات التي نجحت مركبة على شريط أخضر. الجزء المتبقي من الشريط باللون الأحمر يشير إلى النسبة المئوية للاختبارات التي فشلت. الطول الإجمالي للتخطيط يساوى دائماً عرض العمود. |
%تغطية التعليمات البرمجية |
يعرض مخطط شريطى أفقى مكدس يسرد النسبة المئوية من التعليمات البرمجية التي تمت تغطيتها مركبة على شريط أخضر. الجزء المتبقي من الشريط ذو اللون الأزرق الساطع، يشير إلى النسبة المئوية من التعليمات البرمجية التي لم يتم اختبارها في البناء. الطول الإجمالي للتخطيط يساوى دائماً عرض العمود. |
% التغير فى التعليمات البرمجية (خطوط) |
يعرض مخطط شريطي أفقي يسرد النسبة المئوية للتعليمات البرمجية مركبة على شريط رمادي. يتم حساب التغير فى التعليمات البرمجية من خلال تحديد عدد أسطر التعليمات البرمجية التي قام الفريق بإضافتها، أو حذفها أو تعديلها، مقسوماً على إجمالي عدد الأسطر في البناء. يتناسب طول الشريط مع شكل النسبة المئوية، مع تغيير حجمه عبر التقرير بحيث يكون الحد الأقصى لتغيًر التعليمات البرمجية لكل البنيات متسواياُ مع عرض العمود. |
يمكنك تصفية تقرير ملخص البنية بإحدى الطرق التالية:
تغيير تاريخ البدء وتاريخ الانتهاء للتقرير.
تصفية تعريفات البناء بواسطة تحديد الأنظمة الأساسية، أو التكوينات، أو تعريفات البنية، أو سمات البنية، أو تقدم البنية التى تريد تضمينها في التقرير.
لمزيد من المعلومات، راجع تصفية التقرير لاحقا في هذا الموضوع:
أنشطة إدارة البناء المطلوبة
كى يكون تقرير ملخص البنية مفيداً، يجب أن يقوم أعضاء الفريق بإجراء الأنشطة التالية لإدارة البنيات:
إعداد نظام البنية. لإستخدام بنية Team Foundation ، يجب عليك إعداد نظام بنية.
لمزيد من المعلومات، راجع ضبط نظام الإنشاء الخاص بك.
إنشاء تعريفات البنية. يمكن إنشاء العديد من تعريفات البنية، يمكن بتشغيل كل منها لإنتاج التعليمات البرمجية لنظام أساسي مختلف. أيضاً، يمكنك تشغيل أي بنية لتكوين مختلف.
لمزيد من المعلومات، راجع إنشاء ثم العمل مع إنشاء تعريفات.
تعريف الاختبارات لتعمل تلقائياً كجزء من البنية. كجزء من تعريف البنية, يمكنك تعريف الاختبارات ليتم تشغيلها كجزء من البنية أو تفشل إذا فشلت الاختبارات.
لمزيد من المعلومات، راجع كيفية: تعريف البنية استخدام القالب الافتراضي.
تكوين الاختبارات لجمع بيانات تغطية التعليمات البرمجية . حتى تظهر بيانات تغطية التعليمات البرمجية في التقرير, يجب على أعضاء الفريق وضع علامة فى الاختبارات لجمع تلك البيانات.
للمزيد من المعلومات، راجع كيفية: تكوين رمز تغطية استخدام اختبار إعدادات مع الاختبارات التلقائية وكيفية: جمع البيانات تغطية التعليمات البرمجية باستخدام اختبارات عام.
تشغيل الأبنية بإنتظام. يمكن تشغيل بناءين عند فواصل زمنية التعيين أو بعد كل إيداع. يمكنك جدولة البنيات منتظمة عند استخدام يشغّل الجدولة.
للمزيد من المعلومات، راجع كيفية: إنشاء تعريف البنية الأساسية وإنشاء قيد التشغيل والمراقبة.
(اختياري) تقييم البنيات المنتهية. يمكن لعضو الفريق تقييم بنية يدوياً باستخدام مستكشف البنيات.
لمزيد من المعلومات، راجع كيفية: تصنيف الجودة Build المكتملة.
تعيين مدة التكرار
لفهم تقدم الفريق في التكرار الحالي، يجب عليك تعيين تواريخ البدء والانتهاء للتقرير لمطابقة تواريخ دورة لتكرار حالي.
لتغيير مدة التكرار
بجوار (تاريخ) بدء تكرار أو (تاريخ) إنهاء ، انقر فوق ايقونة التقويم ثم انقر فوق تاريخ.
أنقر فوق عرض تقرير.
تفسير التقرير
يمكنك مراجعة تقرير ملخص البنية للرد على أسئلة حول أحدث البنيات. يحتوي التقرير على معلومات أكثر من تقرير نجاح البنية عبر الوقت.
الأسئلة التي يجيب عنها التقرير
يمكنك استخدام هذا التقرير للبحث عن إجابات لهذه الأسئلة:
ما هى حالة كل البنيات مع مرور الوقت؟
أى البنيات نجحت ؟
أى البنيات لها عدد ملحوظ من التغييرات فى التعليمات البرمجية؟
أى البنيات جاهزة للتثبيت؟
كم التعليمات البرمجية التى قامت الاختبارات بتنفيذها؟
لا يشير تقرير ملخص البنية لأسباب المشكلات، ولكن يشير إلى أين يمكنك البحث لتحديد السبب الجذرى للمشاكل. هذا التقرير لا يوضح أيضاً حجم أو أهمية مشاكل البنية.
الإصدار السليم من التقرير
يعرض تقرير ملخص البنية السليم المؤشرات التالية:
تنجح معظم البنيات.
تنجح معظم الاختبارات.
تغطية التعليمات البرمجية عالية.
تظهر بعض التموجات فى تغيرات التعليمات البرمجية.
الإصدار الغير سليم من التقرير
سيظهر قى الإصدار غير سليم لتقرير ملخص البنية واحد أو أكثر من المؤشرات التالية. قد تحتاج للاستقصاء وفقاُ للتوجيه التالي:
تفشل العديد من البنيات. قم بتقصى سبب فشل البنيات.
فشل العديد من الاختبارات. قم بالتحقق من الاختبارات الفاشلة وإصلاحها.
أغلبية تغطية التعليمات البرمجية زرقاء. قد تحتاج إلى كتابة المزيد من الاختبارات التلقائية.
تظهر بعض التموجات فى تغيرات التعلميات البرمجية. قد تحتاج إلى التحقق من أن القمم غير الاعتيادية تم أخذها فى الاعتبار.
تصفية التقرير
يمكنك تصفية تقرير ملخص البنية بإحدى الطرق التالية:
تغيير تاريخ البدء وتاريخ الانتهاء للتقرير.
قم بتصفية مجموعة البنيات الموجودة في التقرير عن طريق تحديد النظام الأساسي، التكوين، تعريف البنية، جودة البنية، وتقدم البنية التى تريد تضمينها في التقرير.
ملاحظة
يمكنك تكوين تعريفات البناء لعدم تشغيل الاختبارات، بعض الاختبارات، أو كافة الاختبارات. يتنوع التقرير بشكل كبير بناءً على تكوينات تعريفات البنية.
يبين الرسم التوضيحي التالي عوامل التصفية المتوفرة:
.png "عوامل تصفية تقرير ملخص البنية")
يجب تطبيق عوامل التصفية بالتسلسل المحدد فى الإجراء التالي. الخيارات المتوفرة مع بعض عوامل التصفية تعتمد على عوامل التصفية التي تم قمت بتعيينها مسبقاً.
لتصفية البنيات التي تظهر في التقرير
في قائمة النظام الأساسى، قم بتحديد خانة الاختيار لكل نظام أساسي ترغب فى تضمينه.
في قائمة التكوين، قم بتحديد خانة الاختيار لكل تكوين ترغب فى تضمينه.
في قائمة تعريف البنية، قم بتحديد خانة الاختيار لكل تعريف بنية ترغب فى تضمنيه.
في قائمة جودة البنية، قم بتحديد خانة الاختيار لكل جودة بنية تريد تضمينها.
في قائمة التقدم، قم بتحديد خانة الاختيار لكل تقدم بنية ترغب فى تضمينه.
أنقر فوق عرض تقرير.