SysML v2
استيراد نماذج SysML v1
حوّل نموذج SysML 1.x من Cameo أو MagicDraw أو Enterprise Architect أو Rhapsody أو Papyrus إلى نص SysML v2، وراجع ما تغيّر شكله، واستورده إلى مشروع SysML v2.
في هذه الصفحة
نظرة عامة
يمكنك جلب نموذج SysML 1.x إلى مشروع SysML v2. يقرأ Holarch ملف XMI الخاص بالنموذج، ويحوّله إلى نص SysML v2، ويفحص النص، ويعرض تقرير تحويل قبل أن يتغير أي شيء.
- Input: نموذج SysML 1.x بصيغة XMI (
.xmi،.uml،.xml) أو مشروع Cameo أو MagicDraw (.mdzip). - المخرجات: نص SysML v2 في مشروعك (ويُلغي تراجع واحد ذلك كله)، أو مشروع SysML v2 جديد.
- التقرير: كل عنصر من v1 مع نتيجته: محوَّل أو تقريبي أو مستبعد، والسبب.
يتبع التحويل تحويل SysML v1 إلى SysML v2 الوارد في مواصفة OMG SysML 2.0، حيث يحمل النموذج المتبادل بصيغة XMI تفاصيل كافية لذلك.
المفاهيم
محوَّل وتقريبي ومستبعد
يحصل كل عنصر من نموذج v1 على نتيجة واحدة:
- محوَّل: للعنصر نظير مباشر في SysML v2، مثل كتلة تصبح
part def. - تقريبي: يُحفظ العنصر بشكل متغير. فمثلًا، يصير المنفذ الكامل المنمَّط بكتلة واجهة منفذًا، ويصير الانتقال عبر حالة زائفة للاختيار انتقالًا واحدًا لكل مسار.
- مستبعد: لا نظير له في SysML v2، أو يشير العنصر إلى شيء ليس في الملف. ومن الأمثلة عُقد نهاية التدفق وأقسام النشاط وامتدادات حالات الاستخدام ومواصفات المثيلات.
يذكر التقرير سبب كل عنصر تقريبي ومستبعد بالكلمات.
الحزمة SysMLv1Library
بعض خصائص SysML v1 ليس لها كلمة مفتاحية في SysML v2، مثل isEncapsulated لكتلة أو علاقة refine. ويحتفظ بها المحوّل كبيانات وصفية من الحزمة SysMLv1Library، مثل @SysMLv1Library::RefineData { isRefine = true; }. والحزمة جزء من مكتبة Holarch، فتُحَل هذه الأسماء في كل مشروع SysML v2.
تصير الأجسام المعتمة تمثيلات نصية
تحمل السلوكيات المعتمة والإجراءات المعتمة والحُرّاس ومواصفات القيود نصًا بلغة مثل OCL أو الإنجليزية. ويحتفظ المحوّل بكل جسم كتمثيل نصي: language "OCL" /* … */. وتُفحص الأجسام المكتوبة بـ SysML أو KerML كباقي النص. انظر التمثيلات النصية.
طريقة استخدامها
متى ولماذا
استخدم الاستيراد حين ينقل فريق نموذج SysML 1.x قائمًا إلى SysML v2، أو يريد إعادة استخدام أجزاء منه. والنص المحوَّل نقطة بداية: يخبرك التقرير بما تجب مراجعته يدويًا.
استيراد نموذج SysML v1 إلى مشروع
- افتح مشروع SysML v2 وانقر النموذج ← الاستيراد والتصدير.
- تحت استيراد، اختر إلى هذا المشروع أو إلى مشروع SysML v2 جديد.
- أفلت الملف
.xmiأو.umlأو.xmlأو.mdzipعلى المربع، أو انقر المربع لاختياره. ترى بطاقة تقدم بالمراحل قراءة ملف XMI… والتحويل إلى SysML v2… وفحص النتيجة…. - اقرأ التحويل من SysML v1 أعلى المعاينة. فهو يذكر عدد العناصر المحوَّلة والتقريبية والمستبعدة، وما إذا كان نص SysML v2 يجتاز الفحص دون مشكلات.
- استخدم إظهار لإدراج العناصر التقريبية والمستبعدة، أو إحداهما فقط، أو كل العناصر. ويذكر كل صف العنصر، ونوعه في SysML v1، والنتيجة مع الكلمة المفتاحية في SysML v2 والاسم المؤهل، والسبب.
- افتح إظهار نص SysML v2 لقراءة النتيجة قبل استيرادها.
- ألغِ تحديد أي حزم لا تريدها في الجدول أدناه، ثم انقر استيراد N حزم (أو إنشاء مشروع). يُستورد النموذج، ويُلغي تراجع واحد ذلك كله. ويزيله تراجع مجددًا.
استيراد إصدار أحدث من النموذج نفسه
عندما يتغير نموذج SysML v1، صدّره مجددًا واستورد الملف الجديد إلى المشروع نفسه (إلى هذا المشروع). يأخذ كل عنصر محوَّل معرّفه من معرّف العنصر في ملف XMI (xmi:id)، فيحدّث الاستيراد العناصر في مكانها: العنصر الذي أُعيدت تسميته أو نُقل إلى حزمة أخرى في أداة SysML v1 يبقى العنصر نفسه، بتخطيطات مخططاته وتعليقاته وروابطه وسجله. ويذكر التقرير عدد العناصر التي تأخذ معرّفاتها من نموذج SysML v1. وتُطابَق العناصر التي لا اسم لها (الموصلات والتعاقبات) بموضعها في النموذج.
المشروع المستورد من نموذج SysML v1 قبل أن يشتق Holarch المعرّفات من ملف XMI يحتفظ بمعرّفاته: يحدّث التصدير الأحدث عناصره بالاسم، وتأخذ العناصر الجديدة في نموذج SysML v1 معرّفاتها منه.
الاحتفاظ بالتقرير والنص
- انقر تنزيل التقرير للحصول على ملف CSV فيه كل عنصر ونتيجته ومساره في SysML v2 والسبب.
- انقر تنزيل نص SysML v2 للحصول على ملف
.sysmlالمحوَّل.
تصدير النموذج من أداة 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. ولا يمكن قراءة ملفات مشاريع Enterprise Architect (.eap،.qea) مباشرة. - IBM Rhapsody: صدّر النموذج بمجموعة أدوات XMI (XMI 2.x) واستورد الملف.
- Eclipse Papyrus: استورد ملف
.umlالخاص بالنموذج.
مثال تطبيقي: نموذج CubeSat EO-1
المشروع التوضيحي CubeSat EO-1 مشروع LML. وتصديره بصيغة SysML v1 يشكّل نموذج اختبار واقعيًا.
- افتح المشروع التوضيحي CubeSat EO-1 وصدّره بصيغة UML/SysML XMI بتنسيق OMG XMI 2.5.1 (انظر تصدير نموذج UML/SysML (XMI)).
- افتح مشروع SysML v2، وانقر النموذج ← الاستيراد والتصدير، واختر إلى مشروع SysML v2 جديد، وأفلت ملف
.xmi. يقول التقرير: 1,042 عنصرًا، حُوّل 1,007، وقُرّب 32، واستُبعد 3. ويجتاز نص SysML v2 الفحص دون مشكلات. - اضبط إظهار على مستبعد. الصفوف الثلاثة هي امتداد حالة استخدام، وهو غير موجود في SysML v2، وعلاقتا تتبع إلى عنصرين بلا اسم، لا يستطيع نص SysML v2 الإشارة إليهما.
- انقر إنشاء مشروع. يُفتح مشروع SysML v2 الجديد في المحرر ببنية القمر الصناعي ووظائفه ومتطلباته وتتبعاته.
نصائح وأخطاء شائعة
- استورد ملف XMI واحدًا في كل مرة، دون ملفات أخرى. استورد ملف SysML v1 XMI واحدًا في كل مرة، دون ملفات أخرى.
- سمِّ العناصر التي تتتبع إليها. تُستبعد العلاقات مع العناصر غير المسمّاة، لأن نص SysML v2 يشير إلى العناصر بأسمائها.
- أعد الاستيراد، لا تُعد الإنشاء. استورد التصدير الأحدث إلى المشروع نفسه لا إلى مشروع جديد: فالعناصر لا تحتفظ بمعرّفاتها إلا داخل المشروع الذي يضمها.
- افحص التقريبات أولًا. فهي المواضع التي قد يختلف فيها المعنى عن نموذج v1، مثل المنافذ المنمَّطة بكتل أو أطراف الموصلات داخل الأجزاء.
- العناصر ذات الاسم نفسه في موضع واحد يُعاد تسميتها بلاحقة مثل
_2. ويدرج التقرير كل إعادة تسمية. - المتطلبات المحفوظة في أداة متطلبات (DOORS وPolarion وJama وcodebeamer) تصل بصيغة ReqIF، لا XMI. استورد ملف
.reqifفي الصفحة نفسها: فيصير متطلبات SysML v2 مع تقرير من النوع نفسه (استيراد متطلبات ReqIF وتصديرها).
ما الذي يُحوَّل
| SysML v1 | SysML v2 |
|---|---|
| نموذج، حزمة | package |
| الكتلة، الفاعل | part def |
| نوع قيمة، نوع بيانات، تعداد | attribute def، enum def (أنواع القيم ذات وحدة SI معروفة تخصّص كمية ISQ) |
| إشارة | item def |
| كتلة واجهة | port def |
| خصائص الأجزاء والمراجع والقيم | part، ref part، attribute، مع التعدديات والقيم الافتراضية |
| منفذ وكيل، خاصية تدفق | port، in/out item أو attribute |
| منفذ كامل | part مع @SysMLv1Library::PortData |
| الموصل، الموصل الرابط، تدفق العنصر | connect, bind, flow |
| تعميم | :> |
| نشاط، إجراء استدعاء سلوك، دبابيس | action def، action، معاملات |
| تدفقات التحكم والكائنات، الحُرّاس | تعاقبات مع حُرّاس if وelse، وتدفقات بين المعاملات |
| البداية، النهاية، القرار، الدمج، التفرع، الالتقاء | start, done, decide, merge, fork, join |
| آلة حالات، حالات، مناطق | state def، state، حالات متوازية |
| انتقالات، ومشغّلات الإشارة والوقت | transition مع accept وaccept after والحُرّاس والتأثيرات |
| تفاعل | occurrence def مع خطوط الحياة والرسائل |
| حالة استخدام، موضوع، تضمين | use case def, subject, include |
| متطلب (المعرّف والنص) | requirement <'id'> Name { doc /* text */ } |
| استيفاء، تحقق، اشتقاق متطلب | satisfy، وverify في هدف تحقق، واتصال اشتقاق |
| تنقيح، تتبع | dependency مع بيانات وصفية SysMLv1Library |
| تخصيص، تبعية | allocate, dependency |
| كتلة قيد، قيد | constraint def, assert constraint |
| الأنماط النمطية والقيم الموسومة | metadata def لكل نمط نمطي، مطبَّق بوسومه |
| تعليق، توثيق | doc, comment |
الحدود
- ملف واحد بحد أقصى 64 MB.
- 250,000 عنصر على الأكثر، بتداخل لا يتجاوز 512 مستوى. والنموذج ذو التداخل الأعمق، أو ذو دورة ملكية، لا يُستورد.
- في النموذج المحوَّل، تُستبعد العناصر المتداخلة بأكثر من 128 مستوى مع السبب التداخل.
- لا يتجاوز النص المحوَّل 8 MB.
- لا تُحوَّل المخططات وتخطيطاتها. أنشئ عروضًا في مشروع SysML v2.
الرسائل
| الرسالة | ما العمل |
|---|---|
| استورد ملف SysML v1 XMI واحدًا في كل مرة، دون ملفات أخرى. | استورد ملف XMI وحده. |
| لا يحوي <file> أي عناصر UML أو SysML. صدّر النموذج بصيغة XMI 2.x واستورده مجددًا. | صدّر النموذج مجددًا بصيغة XMI 2.x. |
| لم يُعثر على نموذج UML في <file>. في Cameo أو MagicDraw، صدّر النموذج بصيغة Eclipse UML2 XMI واستورد ملف .xmi. | صدّر المشروع بصيغة XMI. |
| في نموذج SysML v1 أكثر من 250,000 عنصر. صدّر جزءًا أصغر من النموذج. | صدّر حزمة واحدة في كل مرة. |
| سيكون نص SysML v2 المحوَّل أكبر من 8 MB. صدّر جزءًا أصغر من النموذج. | صدّر حزمة واحدة في كل مرة. |
صفحات ذات صلة
- تبادل نماذج SysML v2
- استيراد متطلبات ReqIF وتصديرها: متطلبات من DOORS وPolarion وأدوات متطلبات أخرى.
- الصيغة النصية لـSysML v2
- التحويل بين LML وSysML v2
SysML® وOMG® علامتان تجاريتان مسجلتان لشركة Object Management Group, Inc. في الولايات المتحدة ودول أخرى.