Holarch

SysML v2

استيراد نماذج SysML v1

حوّل نموذج SysML 1.x من Cameo أو MagicDraw أو Enterprise Architect أو Rhapsody أو Papyrus إلى نص SysML v2، وراجع ما تغيّر شكله، واستورده إلى مشروع SysML v2.

طريقة استخدامها ←

في هذه الصفحة
  1. نظرة عامة
  2. المفاهيم
    1. محوَّل وتقريبي ومستبعد
    2. الحزمة SysMLv1Library
    3. تصير الأجسام المعتمة تمثيلات نصية
  3. طريقة استخدامها
    1. متى ولماذا
    2. استيراد نموذج SysML v1 إلى مشروع
    3. استيراد إصدار أحدث من النموذج نفسه
    4. الاحتفاظ بالتقرير والنص
    5. تصدير النموذج من أداة SysML v1
  4. مثال تطبيقي: نموذج CubeSat EO-1
  5. نصائح وأخطاء شائعة
  6. ما الذي يُحوَّل
  7. الحدود
  8. الرسائل
  9. صفحات ذات صلة

نظرة عامة

يمكنك جلب نموذج 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 إلى مشروع

  1. افتح مشروع SysML v2 وانقر النموذج ← الاستيراد والتصدير.
  2. تحت استيراد، اختر إلى هذا المشروع أو إلى مشروع SysML v2 جديد.
  3. أفلت الملف .xmi أو .uml أو .xml أو .mdzip على المربع، أو انقر المربع لاختياره. ترى بطاقة تقدم بالمراحل قراءة ملف XMI… والتحويل إلى SysML v2… وفحص النتيجة….
  4. اقرأ التحويل من SysML v1 أعلى المعاينة. فهو يذكر عدد العناصر المحوَّلة والتقريبية والمستبعدة، وما إذا كان نص SysML v2 يجتاز الفحص دون مشكلات.
  5. استخدم إظهار لإدراج العناصر التقريبية والمستبعدة، أو إحداهما فقط، أو كل العناصر. ويذكر كل صف العنصر، ونوعه في SysML v1، والنتيجة مع الكلمة المفتاحية في SysML v2 والاسم المؤهل، والسبب.
  6. افتح إظهار نص SysML v2 لقراءة النتيجة قبل استيرادها.
  7. ألغِ تحديد أي حزم لا تريدها في الجدول أدناه، ثم انقر استيراد 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 يشكّل نموذج اختبار واقعيًا.

  1. افتح المشروع التوضيحي CubeSat EO-1 وصدّره بصيغة UML/SysML XMI بتنسيق OMG XMI 2.5.1 (انظر تصدير نموذج UML/SysML (XMI)).
  2. افتح مشروع SysML v2، وانقر النموذج ← الاستيراد والتصدير، واختر إلى مشروع SysML v2 جديد، وأفلت ملف .xmi. يقول التقرير: 1,042 عنصرًا، حُوّل 1,007، وقُرّب 32، واستُبعد 3. ويجتاز نص SysML v2 الفحص دون مشكلات.
  3. اضبط إظهار على مستبعد. الصفوف الثلاثة هي امتداد حالة استخدام، وهو غير موجود في SysML v2، وعلاقتا تتبع إلى عنصرين بلا اسم، لا يستطيع نص SysML v2 الإشارة إليهما.
  4. انقر إنشاء مشروع. يُفتح مشروع SysML v2 الجديد في المحرر ببنية القمر الصناعي ووظائفه ومتطلباته وتتبعاته.

نصائح وأخطاء شائعة

  • استورد ملف XMI واحدًا في كل مرة، دون ملفات أخرى. استورد ملف SysML v1 XMI واحدًا في كل مرة، دون ملفات أخرى.
  • سمِّ العناصر التي تتتبع إليها. تُستبعد العلاقات مع العناصر غير المسمّاة، لأن نص SysML v2 يشير إلى العناصر بأسمائها.
  • أعد الاستيراد، لا تُعد الإنشاء. استورد التصدير الأحدث إلى المشروع نفسه لا إلى مشروع جديد: فالعناصر لا تحتفظ بمعرّفاتها إلا داخل المشروع الذي يضمها.
  • افحص التقريبات أولًا. فهي المواضع التي قد يختلف فيها المعنى عن نموذج v1، مثل المنافذ المنمَّطة بكتل أو أطراف الموصلات داخل الأجزاء.
  • العناصر ذات الاسم نفسه في موضع واحد يُعاد تسميتها بلاحقة مثل _2. ويدرج التقرير كل إعادة تسمية.
  • المتطلبات المحفوظة في أداة متطلبات (DOORS وPolarion وJama وcodebeamer) تصل بصيغة ReqIF، لا XMI. استورد ملف .reqif في الصفحة نفسها: فيصير متطلبات SysML v2 مع تقرير من النوع نفسه (استيراد متطلبات ReqIF وتصديرها).

ما الذي يُحوَّل

SysML v1SysML 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® وOMG® علامتان تجاريتان مسجلتان لشركة Object Management Group, Inc. في الولايات المتحدة ودول أخرى.