كيفية القيام بما يلي: استكشاف تعليمات برمجية باستخدام مخططات تسلسل

في Visual Studio Ultimate ، يمكنك إنشاء مخطط تسلسل لمساعدتك في تمثيل وفهم كيفية تنفيذ التعليمات البرمجية لأسلوب معين. مخطط التسلسل يصف التفاعل بين الكائنات كسلسلة من فترات التواجد و الرسائل. فترات التواجد تمثل مثيلات الكائنات, و الرسائل تمثل الاستدعاءات بين هذه الكائنات. يمكنك إنشاء مخططات تسلسل من التعليمات البرمجية لـ Visual C# .NET أو Visual Basic .NET. مخطط التسلسل الذي تم إنشاؤه يُظهر عناصر مشابهة لتلك على مخطط تسلسل UML. لمزيد من المعلومات، راجع مخططات تسلسل UML: المرجع.

ملاحظة

مخطط التسلسل الذي تقوم بإنشائه من التعليمات البرمجية للبرنامج يوجود بشكل مستقل عن طراز UML , و يمكن إضافته إلى أي مشروع .NET. على العكس, مخطط تسلسل UML الذي ترسمه يدوياً يكون دائما جزءاً من الطراز الذي تقوم بإنشائه.

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

يمكنك إنشاء وتعقب مهام العمل الذي تحتاج لتنفيذه على التعليمات البرمجية المقابلة قبل إنشاء أو ربط عناصر العمل بعناصر المخطط . لمزيد من المعلومات، راجع كيفية القيام بما يلي: ربط عناصر العمل بالطراز.

في هذا الموضوع:

• إنشاء مخطط تسلسل من التعليمات البرمجية

• استكشاف التعليمات البرمجية على مخططات تسلسل

• تحرير المخطط لاقتراح تغييرات في التصميم

• التنقل من المخطط

• ربط عناصر التفاعل بعناصر العمل

• العلاقات بالمخططات الأخرى

إنشاء مخطط تسلسل من التعليمات البرمجية

لإنشاء مخطط تسلسل من التعليمات البرمجية

1. في Visual Studio , قم بفتح ملف التعليمات البرمجية الذي يحتوي على تعريف الأسلوب.

2. انقر يمينًا فوق أي مكان داخل تعريف الأسلوب, ثم انقر فوق إنشاء مخطط تسلسل.

3. في مربع الحوار إنشاء مخطط تسلسل , في المربع أقصى عمق للاستدعاء ، حدد الحد الأقصى لمستوى الاستدعاءات التي تريد مشاهدتها.

   على سبيل المثال، إذا كنت تريد إلى رؤية المستوى أول فقط للمكالمات، وتحديد مستوى عمق الأقصى استدعاء من 1. ستظهر مخطط للتسلسل المستوى الثاني من الاستدعاءات كـ الرسائل التي لها لا تواجد الهدف، والتي تدعي رسائل مفقودة.

   ملاحظة

   بعد إنشاء المخطط , يمكنك توسيع رسائل مفقودة محددة.

4. ضمن تضمين استدعاءات في ، اختر نطاقاً من الجدول التالي:

   لرؤية	انقر فوق
   استدعاءات لعناصر في المشروع الحالي	المشروع الحالي
   استدعاءات لعناصر في الحل	الحل الحالي(افتراضي)
   استدعاءات لعناصر داخل وخارج الحل	الحل و المراجع الخارجية

   على سبيل المثال، يمكنك البدء بمخطط تسلسل بسيط عن طريق فحص فقط استدعاءات الأساليب للعناصر في المشروع الحالي. يمكنك توسيع نطاق المخطط بواسطة إنشاء واحد جديد يُظهِر الاستدعاءات لعناصر عبر الحل. إذا كنت تريد رؤية استدعاءات لعناصر ليست في الحل, يجب إنشاء مخطط يتضمن مراجع خارجية.

5. تحت استثناء استدعاءات إلى ، يمكنك تبسيط المخطط بشكل أكبر بحذف الاستدعاءات للعناصر التالية:

   لتجاهل الاستدعاءات لـ	تحديد
   الخصائص والأحداث	الخصائص والأحداث (افتراضي)
   مساحة الاسم System	مساحة اسم System (افتراضي)
   مساحات أسماء محددة	مساحات أسماء أخرى،ومن ثم اكتب مساحات الأسماء في المربع باستخدام فاصلة ( , ) للفصل بينها

   لتضمين الاستدعاءات لهذه العناصر، قم بإلغاء تحديد خانات الاختيار الخاصة بها.

6. وعند الانتهاء من ذلك، انقر فوق OK.

   Visual Studio ينشئ مخطط تسلسل ويضيفه إلى المشروع المقابل.

   ملاحظة

   بعد إنشاء المخطط , أية تغييرات تجريها على المخطط لا تظهر في التعليمات البرمجية, و أية تغييرات تجريها في التعليمة البرمجية لن تظهر في المخطط . لإظهار هذه التغييرات, يجب إنشاء مخطط تسلسل جديد. يمكنك إنشاء مخطط تسلسل جديد من نفس الأسلوب أي عدد تريده من المرات.

استكشاف التعليمات البرمجية على مخططات تسلسل

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

يمكنك إجراء التغييرات التالية على مخطط التسلسل.

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

تحرير المخطط لاقتراح تغييرات في التصميم

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

يلخص الجدول التالي التغييرات التي تفيد في وصف عروض التصميم. لمزيد من المعلومات، راجع مخططات تسلسل UML: إرشادات.

لعمل	قم بإجراء هذه الخطوات
تمييز فترات التواجد و الرسائل و العناصر الأخرى	غيّر خاصية العنصر لون . -أو- اربط تعليق بالعنصر: في مربع الأدوات، انقر فوق تعليق ، ومن ثم على المخطط ، انقر بالقرب من العنصر. في مربع الأدوات، انقر فوق ربط تعليق ، ومن ثم على المخطط ، انقر فوق التعليق ثم انقر فوق العنصر.
نقل فترات التواجد	اسحب فترة تواجد لمنطقة مختلفة من المخطط . ملاحظة لنقل مجموعة من فترات التواجد التي تحتوي على رسائل موجودة أو مفقودة, اتبع الخطوات التالية لتحديد فترات التواجد قبل نقلها: ارسم مستطيلاً حول فترات التواجد, أو اضغط باستمرار على المفتاح CTRL أثناء النقر فوق كل فترة تواجد.إذا استخدمت تحديد الكل أو CTRL+A لتحديد كافة فترات التواجد, ثم قمت بنقلها, أي رسائل موجودة أو مفقودة تم إرفاقها بفترات التواجد هذه لن تنتقل.في حالة حدوث هذا السيناريو, يمكنك نقل هذه الرسائل بشكل منفصل.
نقل ثم إعادة ترتيب الرسائل	اسحب رسالة إلى أعلى أو أسفل المخطط . حدد رسالة، ثم: لضبط موقع الرسالة, استخدم المفاتيح سهم لأعلى و سهم لأسفل . لتغيير تسلسل الرسائل, استخدم CTRL+سهم لأعلى و CTRL+سهم لأسفل.
إضافة فترة تواجد	انقر فوق فترة تواجد في مربع الأدوات , ثم انقر فوق المخطط .
إضافة رسالة	في مربع الأدوات، انقر فوق رسالة متزامنة أو غير متزامنة . لإضافة رسالة موجودة أو رسالة مفقودة ، استخدم رسالة غير متزامنة. الرسالة الموجودة تأتي من مصدر حدث غير معروف, والرسالة المفقودة تبث إلى مستلم غير معروف. على المخطط ، انقر فوق فترة التواجد لمصدر. انقر على فترة التواجد المستهدفة. -أو- لإنشاء رسالة موجودة أو مفقودة ، انقر فوق ناحية فارغة في المخطط خلف فترة التواجد للمصدر أو أمامها ، على التوالي. اكتب اسم الرسالة الجديدة.
نسخ فترات التواجد والرسائل إلى أو من المخططات الأخرى	انسخ و الصق فترات التواجد. الرسائل بينها سيتم تلقائياً نسخها أيضاً. ملاحظة عند نسخ فترات التواجد من مخطط تسلسل UML في مشروع طراز إلى مخطط تسلسل تم إنشاؤه, قد تظهر فقط رؤوس فترة التواجد أو قد تحتاج إلى ضبط الألوان الخاصة بهم.لإصلاح هذه المشكلة, حدد فترات التواجد الملصقة, و عيّن خصائص اللون الخاصة بهم .
وضع رسائل في جزء مدمج	حدد رسالة واحدة أو أكثر. انقر بزر الماوس الأيمن على اختيارك، أشر إلى إحاطة بـ ، ثم انقر فوق نوع الجزء المدمج. استخدم الأجزاء المدمجة لتمثيل التسلسلات البديلة, و الحلقات, و التركيبات الأخرى للرسائل.
نقل رسالة إلى مخطط جديد	انقر يمينا فوق الرسالة ثم انقر فوق نقل إلى مخطط. يتم إنشاء مخطط جديد, يحتوي على الرسالة والرسائل في حزمتها. على المخطط الأصلي, يتم استبدال الرسالة بـ استخدام تفاعل.
نسخ المخطط	انسخ المخطط في مستكشف الحل, أو نسخ الملفات في مستكشف Windows. هناك ملفّان مقترنان بكل مخطط . مخطط التسلسل الذي تم إنشاؤه يمكن تحريره باستخدام أي مثيل من Visual Studio Ultimate ، ويمكن قراءته باستخدام Visual Studio Ultimate أو Visual Studio Premium.
لا تميّز بعض التغييرات اليدوية, مثل الإضافات و تغييرات الاسم	انقر يمينا فوق سطح مخطط التسلسل ثم انقر فوق خصائص. عيّن الخاصية إظهار التغييرات اليدوية إلى False.

التنقل من المخطط

لعمل	قم بإجراء هذه الخطوات
الانتقال من فترة تواجد أو رسالة إلى تعريف فئة أو أسلوب, على الترتيب	انقر يميناً فوق فترة التواجد أو الرسالة , ثم انقر فوق الانتقال إلى تعريف.
البحث عن فئة أو أسلوب في "مستكشف البنية"	انقر يمينا فوق فترة تواجد أو رسالة, ثم انقر فوق إظهار في مستكشف البنية. لمزيد من المعلومات، راجع كيفية القيام بما يلي: توليد رسم بياني مستندات من تعليمات برمجية.

ربط مخطط تسلسل بعناصر عمل

للمساعدة في تخطيط العمل لتطبيق تغيير ، يمكنك ربط عناصر من أي نوع على مخطط تسلسل بعناصر عمل في Team Foundation Server. لمزيد من المعلومات، راجع كيفية القيام بما يلي: ربط عناصر العمل بالطراز.

لعمل	قم بإجراء هذه الخطوات
ربط فترات تواجد, أو رسائل, أو عناصر أخرى بعناصر عمل	انقر يمينا فوق واحد أو عدة عناصر, ثم انقر فوق ربط بـ"عنصر عمل". في مربع الحوار ربط بعناصر عمل شغّل استعلام للعثور على عنصر عمل, أو أدخل المعرّف الخاص به (ID) مباشرة. يمكنك تحديد أي عدد من عناصر العمل. يمكنك فيما بعد تكرار هذا الأمر لإضافة المزيد من ارتباطات عناصر العمل لنفس عنصر الطراز.
عرض عناصر العمل المرتبطة	انقر يمينا فوق عنصر واحد أو عدة عناصر ثم انقر فوق عرض عناصر العمل.
إزالة ارتباطات عناصر العمل	انقر بزر الماوس الأيمن فوق عنصر ، ثم انقر فوق إزالة عناصر العمل. في مربع الحوار إزالة ارتباطات عناصر العمل , انقر فوق ارتباطات عناصر العمل التي تريد إزالتها. يتم حذف الارتباطات بين عنصر الطراز و عناصر العمل التي تم اختيارها. لا تتم إزالة عناصر العمل و عناصر الطراز.

إرشادات حول استخدام مخططات التسلسل المنشأة

قد تكون الإرشادات التالية مفيدة عندما تقوم باستكشاف التعليمات البرمجية باستخدام مخططات تسلسل منشأة.

استكشاف التعليمات البرمجية

أنشئ مخططات تبعية للحصول على صورة عامة للتجميعات و التبعيات الرئيسية في نص كبير من التعليمات البرمجية. ثم أنشئ مخططات تسلسل للتركيز على أجزاء فردية من التصميم. لمزيد من المعلومات، راجع كيفية القيام بما يلي: توليد رسم بياني مستندات من تعليمات برمجية.

تفسير المخطط

الخوارزمية التي تنشئ المخطط تنفّذ تنفيذ رمزي للتعليمات البرمجية الخاصة بك. توجد بعض الحالات لا يغطيها هذا الأسلوب. بالأخص, هذه الحالات تتضمن:

• قد تظهر فترتي تواجد أو أكثر في المخطط حيث تنفيذ التعليمات البرمجية يتعامل فقط مع مثيل واحد. بشكل عام، يتم إنشاء فترة تواجد مستهدفة منفصلة لكل رسالة.

• نوع فترة تواجد هو النوع التي تم تعريفه في التعليمات البرمجية للبرنامج, حتى إذا كانت التعليمة البرمجية الخاصة بك تستخدم نوع فرعي دوماً.

التركيز على وجه من التصميم

• اختر أحد جوانب التصميم للتركيز عليها. يمكنك إنشاء مخططات مختلفة للتركيز على أوجه مختلفة, و إجراء نسخ من ملفات المخطط في أي مرحلة من العمل.

• للحصول على مخطط مفيد يوضح وجهًا من التصميم, قد تحتاج إلى اختبار إنشاء و عوامل تصفية مساحة الاسم .

• احذف الرسائل غير المناسبة لوجه التركيز, و وسّع الرسائل ذات الصلة لإظهار المزيد من التفاصيل.

• استخدام الأمر طي لتجميع فترات التواجد التي تمثل مجموعة متعاونة من الكائنات، إلا إذا كانت التفاعلات الداخلية الخاصة بها مهمة للوجه الذي تركز عليه.

تحديث التصميم

• يمكنك العمل بشكل متعاون على المخطط باستخدام التحكم بالإصدار. من المستحسن أن يتم تأمين المخطط عند قيامك بتحريره بحيث يمكن تحريره لشخص واحد فقط في المرة.

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

• عندما يكون لديك مخطط يركز على جانب معين من التصميم, قم بإجراء نسخ له ثم تحريرها لإنشاء عروض بديلة للتغييرات.

• يمكنك نسخ عناصر من مخطط تسلسل تم إنشاؤه إلى مخطط تسلسل UML. يجب أولاً إنشاء مخطط تسلسل UML داخل مشروع طراز UML. هناك، يمكنك تمثيل طرق عرض مختلفة من التصميم المحدث, ثم يمكنك ربط فترات التواجد بمكونات أو فئات في الطراز. يمكنك أيضاً توسيع التفاعل ليتضمن العوامل الخارجية.

راجع أيضًا:

المهام

كيفية القيام بما يلي: إنشاء رسومات تخطيطية طبقيّة من نتائج ملموسة

المرجع

مخططات تسلسل UML: المرجع

المبادئ

استكشاف التعليمات البرمجية الحالية

كيفية القيام بما يلي: توليد رسم بياني مستندات من تعليمات برمجية