دليل · SysML v2
نقل نموذج SysML v1 إلى SysML v2: ترحيل خطوة بخطوة
يمكن تحويل نموذج SysML v1 إلى SysML v2 تلقائيًا، لكن الترحيل أكثر من تحويل ملف: يجب أن يقرر أحدهم كيف ينبغي أن يبدو النموذج المحوَّل وأن يتأكد أنه ما زال يقول ما كان نموذج v1 يقوله. يمر هذا الدليل بترحيل في ثماني خطوات، من جرد نموذج v1 إلى الانتقال الكامل، مع نموذج صغير محوَّل ومقروء سطرًا سطرًا.
في هذه الصفحة
قبل أن تبدأ: ترجمة لا ترقية
SysML v2 لغة جديدة، لا إصدار جديد من صيغة ملفات SysML v1. فالكتل تصبح تعريفات أجزاء، والمنافذ تُنمَّط بتعريفات منافذ، والمتطلبات تحمل شروطًا، والمخططات تصبح عروضًا يعرّفها النموذج. ويشرح SysML v1 مقابل v2 الفروق واحدًا واحدًا.
يتولى المحوّل الجزء الآلي: كل عنصر له نظير في SysML v2 يُكتب بـ SysML v2، ويُبلَّغ عن الباقي. أما ما لا يستطيعه المحوّل فهو أن يقرر كيف يريد فريقك استخدام اللغة الجديدة. خطّط للترحيل بوصفه مهمة نمذجة لها مسؤول ومراجعة ونقطة يصبح فيها نموذج v2 هو المرجع.
يستخدم هذا الدليل محوّل Holarch، الذي يستورد نموذج SysML 1.x إلى مشروع SysML v2 ويبلّغ عن كل عنصر بأنه محوَّل أو مقرَّب أو مستبعد. وتنطبق خطوات التخطيط أيًّا كان المحوّل الذي تستخدمه.
1. اجرد نموذج v1
قبل أن تصدّر أي شيء، اعرف ما يحويه النموذج ومن يعتمد عليه. فجرد قصير يوفر إعادة العمل لاحقًا.
- الحزم والمسؤولون عنها. اسرد الحزم في المستوى الأعلى، ومن يصون كلًّا منها، وأيها تشير إليه نماذج أو مستندات أخرى. فالحزم هي الوحدة التي ستحوّلها وتراجعها.
- المخططات المهمة. دوّن المخططات التي يستخدمها الناس فعلًا في المراجعات والمستندات. لا تنتقل تخطيطات المخططات إلى SysML v2، فتصبح هذه عروضًا تعيد بناءها.
- الملامح والقوالب النمطية. اسرد قوالبك النمطية وقيمها الموسومة. فهي تصبح تعريفات بيانات وصفية، ويجب الاتفاق من جديد على معناها في النموذج الجديد.
- السلوك المكتوب برمجيًا. السلوكيات المعتمة والحُرّاس والقيود المكتوبة بـ OCL أو بلغة إجراءات أو بلغة البرمجة النصية لأداة ما تُحفظ نصًّا بلغتها الأصلية؛ ولا تُترجم.
- العناصر غير المسماة. العلاقات التي تشير إلى عناصر بلا اسم لا يمكن كتابتها في نص SysML v2، الذي يشير إلى العناصر بأسمائها. سمِّ العناصر التي تتتبع إليها الآن، في أداة v1.
- الحجم. يحوّل Holarch ملفًا واحدًا حتى 64 MB و250,000 عنصر في المرة الواحدة. وتُصدَّر النماذج الأكبر حزمةً حزمة.
2. صدّر النموذج من أداة SysML v1
يقرأ المحوّل النموذج من XMI، صيغة التبادل التي تكتبها أدوات SysML v1. وكل أداة تصدّرها بطريقة مختلفة قليلًا:
| الأداة | ما الذي يُستورد |
|---|---|
| Cameo Systems Modeler، MagicDraw | ملف المشروع .mdzip، أو File ← Export To ← Eclipse UML2 (v5.x) XMI File والملف .xmi |
| Enterprise Architect | حدد الحزمة، ثم Publish ← Export XML، واختر XMI 2.1، واستورد الملف .xml. ولا تُقرأ ملفات المشروع (.eap، .qea) مباشرةً. |
| IBM Rhapsody | تصدير XMI 2.x من مجموعة أدوات XMI |
| Eclipse Papyrus | ملف .uml الخاص بالنموذج |
احتفظ بالملف المصدَّر مع سجلات الترحيل: فهو مدخل v1 الدقيق الذي تشير إليه مراجعتك.
3. حوّل حزمة تجريبية
ابدأ بحزمة واحدة تمثيلية لكنها ليست الأكبر: نظام فرعي فيه بنية وواجهات وبعض السلوك ومتطلباته. تُظهر الحزمة التجريبية كيف يبدو تحويل نموذجك قبل أن تُلزم الفريق كله به.
- أنشئ مشروع SysML v2، أو افتح المشروع الذي ينبغي أن يدخله النموذج المحوَّل، وانقر النموذج ← الاستيراد والتصدير.
- تحت استيراد، اختر إلى مشروع SysML v2 جديد للحزمة التجريبية، كي لا يُمسّ أي شيء آخر.
- أفلت الملف المصدَّر على المربع. تُظهر بطاقة تقدم المراحل: قراءة ملف XMI، والتحويل إلى SysML v2، وفحص النتيجة.
لم يُستورد شيء بعد. والشاشة التالية هي المعاينة مع تقرير التحويل.
4. اقرأ تقرير التحويل
يعطي التحويل من SysML v1 في أعلى المعاينة عدد العناصر المحوَّلة والمقرَّبة والمستبعدة، وهل يجتاز نص SysML v2 الفحص دون مشكلات. ولكل عنصر من نموذج v1 نتيجة واحدة:
- محوَّل: للعنصر نظير مباشر في SysML v2، مثل كتلة تصبح
part def. - مقرَّب: يُحفظ العنصر بشكل معدَّل، مثل انتقال عبر عقدة اختيار يصبح انتقالًا واحدًا لكل مسار. وهذه هي المواضع التي قد يختلف فيها المعنى عن نموذج v1.
- مستبعد: لا نظير له في SysML v2، أو يشير العنصر إلى شيء غير موجود في الملف.
استخدم إظهار لسرد العناصر المقرَّبة والمستبعدة. يعطي كل صف العنصر، ونوعه في SysML v1، وما صار إليه مع اسمه في SysML v2، والسبب. افتح إظهار نص SysML v2 لقراءة النتيجة، وانقر تنزيل التقرير للاحتفاظ بالتقرير ملف CSV. وملف CSV هو قائمة العمل للخطوة 5: رتّبه حسب السبب وأعطِ كل مجموعة مسؤولًا.
مثال تطبيقي: نموذج مركبة جوالة صغيرة
نموذج SysML v1 صغير لمسار القدرة في مركبة جوالة كوكبية، في ثلاث حزم:
| الحزمة | عناصر SysML v1 |
|---|---|
| Types | نوع قيمة Power بالوحدة W؛ وكتلة Charge؛ وكتلة واجهة Power Interface لها خاصيتا تدفق خارجتان، charge (من نوع Charge) وvoltage (من نوع Real) |
| البنية | كتلة مغلّفة Rover لها خاصيتا جزء battery وcomputer، وخاصية قيمة power budget قدرها 120 W، وموصل power bus بين منفذيهما وتدفق عنصر power flow من Charge عليه. وكتلة Battery لها منفذ وكيل out؛ وكتلة Computer لها منفذ وكيل مترافق in ومنفذ كامل raw. وكلتاهما تحملان قالبًا نمطيًا للمستخدم «Hardware» مع قيم موسومة. وارتباط طرفه مملوك للارتباط. |
| المتطلبات | المتطلبان R-1 Mission وR-2 Power Margin؛ وR-2 مشتق من R-1؛ وR-2 يستوفيه جزء البطارية؛ وتتبُّع من Computer إلى Battery |
بعد التحويل يُقرأ هكذا. والقائمة هي مخرج المحوّل دون تغيير:
package 'Rover Model' {
package Types {
attribute def Power :> ISQ::PowerValue;
part def Charge;
port def 'Power Interface' {
out item charge : Charge;
out attribute voltage : ScalarValues::Real;
}
}
package Structure {
part def Rover {
doc /* Six-wheeled science rover. */
@SysMLv1Library::BlockData { isEncapsulated = true; }
part battery : Battery;
part computer : Computer;
attribute 'power budget' : Types::Power = 120 [SI::W];
connection 'power bus' connect battery.'out' to computer.'in';
satisfy Requirements::'Power Margin' by battery;
flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}
part def Battery {
@'SysML v1 Profiles'::rov::Hardware { qualified = "true"; vendor = "Acme Cells"; }
port 'out' : Types::'Power Interface';
attribute capacity : Types::Power;
}
part def Computer {
@'SysML v1 Profiles'::rov::Hardware { vendor = "Orbital Logic"; }
port 'in' : ~Types::'Power Interface';
part raw : Types::Charge {
@SysMLv1Library::PortData { isFullPort = true; }
}
}
}
package Requirements {
requirement <'R-1'> Mission {
doc /* The rover shall explore the landing site. */
}
requirement <'R-2'> 'Power Margin' {
doc /* Keep a 50 % power margin. */
}
connection : DerivationConnections::Derivation connect 'Power Margin' to Mission;
dependency from Structure::Computer to Structure::Battery {
@SysMLv1Library::TraceData { isTrace = true; }
}
}
}
package 'SysML v1 Profiles' {
package rov {
metadata def Hardware {
attribute qualified : ScalarValues::String;
attribute vendor : ScalarValues::String;
}
}
}
ما الذي حدث لكل جزء من نموذج v1:
- نوع القيمة مع وحدة. يخصّص Power بالواط
ISQ::PowerValueمن المكتبة القياسية، وتُكتب القيمة الافتراضية مع وحدتها:120 [SI::W]. أما نوع القيمة الذي وحدته ليست وحدة SI مقابَلة فيبقى عددًا حقيقيًا، مع الوحدة في توثيقه، ويُبلَّغ عنه بأنه مقرَّب. - الكتل والخصائص. تصبح الكتل
part defوتصبح خصائص الأجزاءpart. وليس لخاصية isEncapsulated في الكتلة كلمة مفتاحية في SysML v2، فتُحفظ بيانات وصفيةSysMLv1Library::BlockData. - كتلة الواجهة والمنافذ. تصبح كتلة الواجهة
port defخصائص تدفقها ميزات موجّهة:out itemللخاصية المنمَّطة بكتلة، وout attributeللقيمة. ويُنمَّط المنفذ الوكيل المترافق بـ~Types::'Power Interface'. ويصبح المنفذ الكامل جزءًا مع بيانات وصفيةSysMLv1Library::PortData، لأن المنفذ في SysML v2 يُنمَّط بتعريف منفذ. - الموصل وتدفق العنصر. يصبح الموصل
connectionبين المنفذين، ويصبح تدفق العنصر عليهflowمن Charge بين المنفذين نفسيهما. - المتطلبات. يحتفظ كل متطلب بمعرّفه اسمًا مختصرًا،
<'R-1'>، وبنصه بوصفهdoc. وتقع علاقة satisfy في الكتلة التي تملك الجزء المستوفي؛ وتصبح علاقة derive وصلة اشتقاق؛ ويصبح التتبع تبعية معSysMLv1Library::TraceData. - القالب النمطي للمستخدم. يصبح «Hardware»
metadata defفي حزمة'SysML v1 Profiles'، مطبَّقًا على كل كتلة مع قيمه الموسومة. ويُبلَّغ عن تطبيقيه بأنهما مقرَّبان: فقد صارت القيم الموسومة سمات نصية، أيًّا كان نوعها في الملمح. - الارتباط. الارتباط الذي ليست له فئة لا نظير له هنا في SysML v2، ولا يُحوَّل طرفه المملوك للارتباط كذلك. ويُبلَّغ عن كليهما بأنهما مستبعدان؛ والخصائص على الكتل تحمل البنية.
تقرير هذا النموذج: 31 عنصرًا، 27 محوَّلًا، و2 مقرَّبان، و2 مستبعدان، ويجتاز النص الفحص بلا أخطاء ولا تحذيرات. والأسماء التي ليست معرّفات بسيطة، مثل 'power budget' أو 'out' (كلمة مفتاحية في SysML v2)، توضع بين علامتي اقتباس فتحتفظ بتهجئتها في v1.
5. أعد العمل على ما قُرِّب أو استُبعد
امضِ في صفوف التقرير المقرَّبة والمستبعدة حسب السبب. ومعظم الأسباب تستدعي قرارًا من بين قرارات قليلة:
| ما يقوله التقرير | ما الذي يُقرَّر |
|---|---|
| منفذ منمَّط بكتلة ليست كتلة واجهة؛ فصار منفذًا بلا نوع | عرّف تعريف منفذ بالميزات التي تعبر الحد، ونمّط المنفذ به. |
| انتقالات عبر عقدة اختيار أو التقاء أو تفرع أو ضم؛ فصار كل مسار انتقالًا واحدًا | تأكد أن الحُرّاس المدمجة ما زالت تقول ما كان مخطط v1 يعنيه؛ وبسّط حيث صارت المسارات أسهل قراءة. |
| مُطلِق محفوظ توثيقًا | أعد كتابة مطلِقات التغيير والزمن بوصفها مطلِقات SysML v2 حيث يكون المعنى واضحًا، مثل accept after مدة. |
| وحدة ليست وحدة SI يقابلها Holarch؛ فنوع القيمة عدد حقيقي | قرر هل تناسب كمية قياسية، أو أبقِ العدد الحقيقي والوحدة الموثقة. |
| نوع إجراء غير إجراء الاستدعاء أو المعتم أو الاستقبال صار إجراءً عاديًا | أعد كتابة الإرسال والإجراءات المحددة الأخرى بإجراء SysML v2 الذي يفعل الشيء نفسه. |
| أقسام النشاط لا تُحوَّل | اذكر أي جزء يفعل ماذا بـ perform في الجزء، بدل مسار سباحة. |
| يشير إلى عنصر بلا اسم | سمِّ الهدف في أداة v1 وحوّل من جديد، أو أضف العلاقة في نموذج v2. |
| اسمه مستخدم مرتين في المكان نفسه؛ فأعيدت تسميته بلاحقة | أعطِ كل عنصر اسمًا يقول ما هو. |
| صارت القيم الموسومة سمات نصية في البيانات الوصفية | أعطِ سمات البيانات الوصفية الأنواع التي تحتاجها، واتفق على ما يعنيه كل قالب نمطي الآن. |
نوعان من النصوص يحتاجان إلى نظرة حتى إن تحولا بلا مشكلات. تُحفظ الأجسام المعتمة تمثيلات نصية بلغتها الأصلية، مثل language "OCL" /* … */؛ ولا يفحص Holarch إلا الأجسام المكتوبة بـ SysML أو KerML، فأعد كتابة الحارس أو القيد تعبيرَ SysML حيث ينبغي أن يقيّمه النموذج. والترجمات الحرفية تحتفظ بالحلول الالتفافية في v1، مثل الأنواع الخاصة بالخصائص التي أُنشئت فقط لضبط قيمة: وهي في SysML v2 إعادات تعريف عادية على الاستخدامات. ويسرد قسم ما يحتاج إلى إعادة تفكير الشائع منها.
6. أعد بناء العروض المهمة
لا تُحوَّل المخططات وتخطيطها. خذ قائمة المخططات من الخطوة 1 وأنشئ عرضًا لكل مخطط ما زالت الحاجة إليه قائمة: عرضًا عامًا للبنية والمتطلبات، وعرض ترابط للأجزاء والوصلات، وعرض تدفق إجراءات للأنشطة، وعرض انتقالات حالة لآلات الحالة. ولا تُعِد بناء إلا ما يستخدمه الناس؛ فالنموذج يحوي كل ما عداه على أي حال. راجع مرجع العروض.
7. افحص نموذج v2 وراجعه
- يجتاز النص الفحص دون مشكلات. يُظهر الاستيراد فحص النص المحوَّل قبل أن يتغير أي شيء؛ وبعد إعادة العمل، يعلّم المحرر أي مشكلات جديدة أثناء الكتابة.
- الأعداد متطابقة. قارن بضعة أرقام بين نموذج v1 ونموذج v2: المتطلبات، والأجزاء، والمنافذ، والوصلات، وعلاقات التحقق. والفرق الذي لا تستطيع تفسيره من التقرير يستحق نظرة.
- يراجعه من يستخدمون النموذج. امضِ في الحزمة التجريبية مع المسؤولين عنها، بدءًا بالعناصر المقرَّبة والعروض المعاد بناؤها.
- سجّل القرارات. دوّن أنماط النمذجة التي استقررت عليها للمنافذ والمطلِقات والوحدات والقوالب النمطية، كي يتبعها بقية الترحيل.
8. حوّل الباقي وانتقل
حوّل الحزم المتبقية واحدة تلو الأخرى، إلى مشروع SysML v2 نفسه. يُظهر كل استيراد المعاينة نفسها: تظهر الحزمة الموجودة في المشروع بـ مُغيَّر أو دون تغيير، والجديدة بـ جديد، وتختار أنت الحزم التي تستوردها. وكل استيراد خطوة تراجع واحدة.
أبقِ نموذج v1 مرجعًا إلى أن يُراجَع نموذج v2، ثم جمّده واجعل مشروع SysML v2 النموذج المعتمد. ومن تلك النقطة لا تدخل التغييرات إلا نموذج v2.
قائمة التحقق للترحيل
- الحزم والمسؤولون عنها والمخططات المهمة مسرودة.
- للعناصر التي تشير إليها العلاقات أسماء.
- ملف XMI المصدَّر محفوظ مع سجلات الترحيل.
- حُوِّلت حزمة تجريبية، ونُزِّل تقريرها، ولكل صف مقرَّب ومستبعد قرار.
- أنماط النمذجة للمنافذ والمطلِقات والوحدات والقوالب النمطية مدوّنة.
- العروض اللازمة أُعيد بناؤها؛ والنص يجتاز الفحص دون مشكلات.
- راجع مستخدمو النموذج الحزمة التجريبية.
- حُوِّلت الحزم المتبقية بالطريقة نفسها، وجُمِّد نموذج v1.
إلى أين بعد ذلك
- من SysML v1 إلى SysML v2 في Holarch: ما يقرؤه المحوّل وما يكتبه، ومثال CubeSat EO-1.
- استيراد نماذج SysML v1: كل خطوة ومقابلة وحد ورسالة في الوثائق.
- SysML v1 مقابل v2: كيف تختلف اللغتان.
- البرنامج التعليمي لـ SysML v2: ابنِ نموذجًا بالترميز النصي.
- تغطية لغة SysML v2: ما تدعمه مشاريع SysML v2 والثغرات المعروفة.
Cameo Systems Modeler وMagicDraw وEnterprise Architect وRhapsody وEclipse Papyrus علامات تجارية لمالكيها. وHolarch غير تابع لهم ولا معتمد منهم.