Holarch

من SysML v1 إلى SysML v2

انقل نموذج SysML v1 الخاص بك إلى SysML v2 دون إعادة رسمه.

أفلت نموذج SysML v1 محفوظًا بصيغة XMI (.xmi و.xml و.uml) أو بصيغة أرشيف مشروع .mdzip في مشروع SysML v2. يحوّله Holarch إلى نص SysML v2، ويفحص النص، ويبلّغ عن كل عنصر بأنه محوَّل أو تقريبي أو مستبعد، مع السبب، قبل استيراد أي شيء.

المحوّل جزء من كل خطة، بما فيها Free. تبدأ الحسابات الجديدة تجربة Individual لمدة 30 يومًا عند أول تسجيل دخول: 10,000 عنصر لكل مشروع، دون بطاقة، والعودة إلى Free عند انتهائها. لديك حساب؟ ابدأ التجربة.

الإثبات: نموذج CubeSat EO-1

النتيجةالعناصر
محوَّل1,007
تقريبي32
مستبعد3
العناصر المقروءة1,042
المشكلات في نص SysML v20

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

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

استورد ملف XMI أو مشروع .mdzip لنموذج SysML v1 إلى مشروع SysML v2. قبل إنشاء أي شيء، يسرد تقرير التحويل كل عنصر بأنه محوَّل أو تقريبي أو مستبعد، مع السبب، ويُحفظ بصيغة ملف CSV. المثال هو نموذج CubeSat EO-1: 1,042 عنصرًا، استُوردت دون أي مشكلات.

استيراد نموذج SysML v1 في صفحة مقاطع الفيديو

ما تحصل عليه من المحوّل

نموذج SysML v2 يمكنك العمل فيه، وقائمة واضحة بما يجب مراجعته.

دون إعادة رسم

تصبح الكتل part def، وتنتقل المنافذ والموصلات وتدفقات العناصر، وتحتفظ المتطلبات بمعرّفاتها ونصوصها، وتبقى علاقات satisfy وverify وallocate متتبَّعة.

تقرير عن كل عنصر

يُدرج كل عنصر من نموذج v1 مع نوعه في v1، ونتيجته، والاسم الذي صار إليه في SysML v2، ومع السبب مكتوبًا لكل ما قُرِّب أو استُبعد. صفِّه على الشاشة أو نزّله بصيغة CSV.

مفحوص قبل الاستيراد

المحرك الذي يفحص محرر SysML v2 أثناء الكتابة يفحص النص المحوَّل. ترى النتيجة والنص والتقرير أولًا؛ والاستيراد خطوة تراجع واحدة.

أعد الاستيراد كلما تغيّر نموذج v1

تأخذ العناصر معرّفاتها من معرّفات XMI في نموذج v1. استورد ملفًا مصدَّرًا أحدث إلى المشروع نفسه فتُحدَّث العناصر في مكانها، حتى إن أُعيدت تسميتها أو نُقلت، مع تخطيطات مخططاتها وتعليقاتها وروابطها وسجلها.

نموذج يمكنك العمل فيه

يقرأ المحرر وطرق العرض والمتطلبات والتحقق وسائر صفحات مشروع SysML v2 النموذج المحوَّل كأي نموذج آخر.

يبقى نموذج v1 كما هو

يقرأ Holarch ملفًا مصدَّرًا منه ولا يكتب فيه أبدًا، فيظل نموذج v1 هو المرجع بينما يراجع الفريق نسخة SysML v2.

كيف يعمل

  1. أفلت الملف. في مشروع SysML v2، انقر النموذج ← الاستيراد والتصدير، واختر إلى هذا المشروع أو إلى مشروع SysML v2 جديد، وأفلت ملف .mdzip أو .xmi أو .uml أو .xml. تعرض بطاقة تقدّم مراحل القراءة والتحويل والفحص.
  2. راجع التقرير. يعرض التحويل من SysML v1 الأعداد، ويبيّن ما إذا كان النص يجتاز الفحص دون مشكلات، ويسرد العناصر التقريبية والمستبعدة مع سبب كل منها. ويفتح إظهار نص SysML v2 النتيجة؛ نزّل التقرير أو ملف .sysml للاحتفاظ بهما.
  3. استورد. ألغِ تحديد أي حزم لا تريدها واستورد. يزيل تراجع واحد الاستيراد بأكمله مجددًا.

خطوة بخطوة، مع إعدادات التصدير في كل أداة: استيراد نماذج SysML v1 في الوثائق، ودليل الترحيل لتخطيط انتقال برنامج كامل.

كتلة محوَّلة

part def 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';
}

مخرجات المحوّل لكتلة مغلّفة بجزأين، وخاصية قيمة بالواط، وموصل بين منافذ وكيلة مع تدفق عنصر، وعلاقة satisfy. ويعرض دليل الترحيل النموذج الصغير كاملًا، قبل التحويل وبعده.

ما يقرؤه

  • SysML v1 بصيغة XMI 2.x: UML 2.5 مع ملف تعريف SysML 1.x.
  • .xmi: ملف XMI.
  • .xml: ملف XMI محفوظ بالامتداد .xml.
  • .uml: ملف نموذج XMI.
  • .mdzip: أرشيف مشروع مضغوط يحتوي النموذج بصيغة XMI؛ يقرأ Holarch ملف XMI الموجود داخله.
  • صيغ المشاريع الأخرى: الأداة التي تحفظ النماذج بصيغة مشروع خاصة بها تصدّر النموذج بصيغة XMI أولًا.

ملف واحد لكل عملية استيراد، حتى 64 MB و250,000 عنصر و512 مستوى من التداخل.

ما يُنتجه

  • نص SysML v2 في المشروع المفتوح أو في مشروع SysML v2 جديد، مستوردًا بخطوة تراجع واحدة.
  • فحص للنص، يُعرض قبل الاستيراد.
  • تقرير تحويل عن كل عنصر، قابل للتصفية على الشاشة وللتنزيل بصيغة CSV.
  • ملف .sysml للتنزيل، للمراجعة أو لأداة SysML v2 أخرى.

يستند التحويل إلى التحويل من SysML v1 إلى SysML v2 الوارد في مواصفة OMG SysML 2.0.

محوَّل أو تقريبي أو مستبعد

يحصل كل عنصر من نموذج v1 على إحدى ثلاث نتائج، فتعرف بالضبط أين تنظر.

محوَّل

للعنصر نظير مباشر في SysML v2. تصبح الكتلة part def، وكتلة الواجهة port def، ويحتفظ المتطلب بمعرّفه ونصه.

تقريبي

يُحتفظ بالعنصر بصيغة معدَّلة. المنفذ الكامل المُنمَّط بكتلة واجهة يصبح منفذًا؛ والانتقال عبر نقطة اختيار يصبح انتقالًا لكل مسار؛ والوحدة التي ليست وحدة SI مقابَلة تصبح عددًا حقيقيًا مع ذكر الوحدة في توثيقه.

مستبعد

لا نظير له في SysML v2، أو يشير العنصر إلى شيء غير موجود في الملف. ومن الأمثلة عُقد نهاية التدفق، وأقسام النشاط، وامتدادات حالات الاستخدام، والعلاقات مع عناصر بلا أسماء.

تُحفظ خصائص SysML v1 التي ليس لها كلمة مفتاحية في SysML v2، مثل الكتلة المغلّفة أو المنفذ الكامل أو علاقة refine، بوصفها بيانات وصفية من الحزمة SysMLv1Library، التي يحمّلها Holarch في كل مشروع SysML v2. وتصبح الأنماط النمطية الخاصة بك تعريفات بيانات وصفية مع قيمها الموسومة، وتحتفظ السلوكيات المعتمة والشروط الحارسة والقيود بنصوصها بوصفها تمثيلات نصية، مثل language "OCL" /* … */.

ما الذي يتحول إلى ماذا

المقابلات الرئيسية. وتسردها الوثائق كلها.

SysML v1SysML v2
الحزمةpackage، متداخلة كما في v1
الكتلة، الفاعلpart def
نوع القيمة، التعدادattribute def، enum def؛ ونوع القيمة الذي له وحدة SI معروفة يخصّص كمية ISQ
خصائص الأجزاء والمراجع والقيمpart، ref part، attribute، مع التعدديات والقيم الافتراضية
كتلة الواجهة، المنفذ الوكيل، خاصية التدفقport def، port، item أو attribute موجَّه
الموصل، الموصل الرابط، تدفق العنصرconnect, bind, flow
النشاط، الإجراءات، تدفقات التحكم والكائناتaction def، إجراءات، تعاقبات مع شروط حارسة، تدفقات بين المعاملات
آلة الحالة، الحالات، الانتقالاتstate def، حالات، انتقالات مع accept وشروط حارسة وتأثيرات
المتطلب، satisfy، verify، deriverequirement بمعرّفه ونصه، satisfy، verify، اتصالات الاشتقاق
allocate، refine، traceallocate؛ dependency مع بيانات وصفية من SysMLv1Library
حالة الاستخدام، التفاعل، كتلة القيودuse case def، occurrence def مع الرسائل، constraint def
الأنماط النمطية والقيم الموسومةmetadata def لكل نمط نمطي، مطبَّق بوسومه

مثال عملي: نموذج CubeSat EO-1

العرض التوضيحي CubeSat EO-1 مصدَّرًا بصيغة SysML 1.6 XMI ومستوردًا إلى مشروع SysML v2 جديد: قُرئ 1,042 عنصرًا، وحُوِّل 1,007، وقُرِّب 32، واستُبعد 3. يجتاز نص SysML v2 الفحص دون أخطاء ودون تحذيرات، ويُفتح المشروع الجديد ببنية القمر الصناعي ووظائفه ومتطلباته وتتبعاته. كل عنصر تقريبي ومستبعد، بحسب السبب:

العناصرالنتيجةالسبب
10 موصلاتتقريبييقع طرف الموصل داخل جزء؛ واستُنتج المسار إليه من أنواع الأجزاء.
8 انتقالاتتقريبيحُفظ 4 مشغّلات تغيير ووقت، مثل when Undervoltage، بوصفها توثيقًا؛ وحصلت 4 أحداث بلا إشارة، مثل Contact Start، على تعريف عنصر بالاسم نفسه.
6 تدفقات عناصرتقريبياستُخدم الاسم مرتين في المكان نفسه؛ فأُعيدت تسمية التدفق بلاحقة.
5 أنواع قيمتقريبيالوحدة (%، GB، Mbps، mNms، W/m^2) ليست وحدة SI يقابلها Holarch؛ فنوع القيمة عدد حقيقي مع ذكر الوحدة في توثيقه.
2 تدفقا تحكمتقريبيفرع بلا شرط حارس بجانب فروع لها شروط؛ فحصل على الشرط true.
1 حالة نهائيةتقريبيأصبحت الحالة النهائية حالة عادية.
1 امتداد حالة استخداممستبعدليس في SysML v2 امتدادات لحالات الاستخدام.
2 علاقتا traceمستبعدتشيران إلى عناصر بلا أسماء، لا يستطيع نص SysML v2 الإشارة إليها.

ملف EO-1 هو ملف SysML 1.6 المصدَّر من Holarch نفسه، لذا يستخدم الجزء من SysML v1 الذي يكتبه Holarch. أما النموذج القادم من أداة أخرى فيستخدم عادةً جزءًا أكبر من اللغة، وستختلف أرقامه: تقرير نموذجك أنت هو المقياس المعتبر، وتراه قبل استيراد أي شيء. وتتحول أيضًا نماذج الاختبار في Holarch، المكتوبة بصيغ XMI لعدة أدوات SysML v1، إلى نص يجتاز الفحص دون مشكلات، ويتحول النموذج نفسه إلى النص نفسه في كل مرة.

الأسئلة

ما الذي يُفقد في التحويل؟

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

هل النموذج المحوَّل جاهز للاستخدام؟

يجتاز الفحص دون مشكلات وتعمل معه كل صفحة في مشروع SysML v2، لكن تعامل معه بوصفه نقطة انطلاق. فبعض الفروق بين اللغتين تستحق قرارًا في النمذجة، لا مجرد ترجمة. ما تدعمه مشاريع SysML v2، والثغرات المعروفة: تغطية لغة SysML v2.

ما أكبر نموذج يمكنني تحويله؟

ملف واحد بحجم 64 MB على الأكثر، يضم 250,000 عنصر على الأكثر بتداخل لا يتجاوز 512 مستوى، و8 MB على الأكثر من النص المحوَّل. صدّر النموذج الأكبر حزمةً حزمة. وينطبق حد العناصر لكل مشروع في خطتك على النموذج المحوَّل: 1,000 في Free، و10,000 في Individual، و50,000 في Team. راجع ما الذي يُحتسب عنصرًا. ولنموذج يتجاوز 10,000 عنصر، اطلب تقييم Team.

هل يمكنني مواصلة العمل في أداة SysML v1 الخاصة بي؟

نعم. يقرأ Holarch ملفًا مصدَّرًا ولا يغيّر نموذج v1 أبدًا. وعندما يتغير نموذج v1، صدّره مجددًا واستورد الملف الجديد إلى المشروع نفسه: تأخذ العناصر معرّفاتها من ملف XMI، فتُحدَّث في مكانها، حتى بعد إعادة تسمية أو نقل. وتُعاد تسمية العناصر التي تحمل الاسم نفسه في مكان واحد بلاحقة مثل _2، ويسرد التقرير كل إعادة تسمية.

إلى أين يذهب ملفي؟

يقرأ Holarch ملف XMI أو .mdzip ويحوّله في متصفحك؛ ولا يُرفع الملف نفسه. وفي app.holarch.app يُرسل نص SysML v2 المحوَّل إلى Holarch لإعداد المعاينة، ولا يُحفظ في مشروعك إلا عند الاستيراد. ولا تقبل الخدمة المستضافة مواد CUI أو المواد الخاضعة لمراقبة الصادرات؛ ولذلك يعمل Holarch في بيئتك الخاصة (Enterprise). المزيد في الأمان.

وماذا عن المتطلبات المحفوظة في أداة لإدارة المتطلبات؟

تنتقل بصيغة ReqIF (.reqif، .reqifz)، صيغة تبادل المتطلبات القياسية. يستورد Holarch صيغة ReqIF ويصدّرها في مشاريع LML وSysML v2. وفي مشروع SysML v2، يصبح ملف ReqIF متطلبات وتعريفات متطلبات وحزمًا، مع تقرير بما حُوِّل، وتُصدَّر المتطلبات مجددًا بمعرّفاتها الأصلية. وفي رحلة الذهاب والإياب التي أجريناها على العرض التوضيحي CubeSat EO-1 من Holarch إلى ReqIF والعودة، عادت العناصر الـ 407 جميعها وقيم السمات الـ 979 دون تغيير. ReqIF في مشاريع LML · ReqIF في مشاريع SysML v2

كم يكلّف المحوّل؟

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

تبني ترحيلًا في أداتك الخاصة؟

المحوّل جزء من Holarch Language Engine، المحرك الذي تقوم عليه مشاريع SysML v2 في Holarch، ويُرخَّص لمورّدي الأدوات والمكاملين بوصفه إضافة الترحيل. وهو المحوّل نفسه الذي يعمل في Holarch.

  • يقرأ منتجك ملف XMI، ويتولى المحرك التحويل: أرسل نموذج v1 بصيغة JSON بالشكل المحايد الموثَّق، واحصل في المقابل على نص SysML v2، وفحص المحرك له، وتقرير عن كل عنصر برمز سبب ثابت والاسم الذي صار إليه في SysML v2، بصيغة JSON.
  • يعمل حيث يعمل منتجك: في المتصفح بصيغة WebAssembly داخل Web Worker، أو على خادمك عبر Node.js أو امتداد Python مع الاستخدام على الخادم.
  • قابل للتكرار ومحدود: يتحول النموذج نفسه إلى النص نفسه في كل مرة؛ ونماذج حتى 250,000 عنصر، والنموذج الأكبر يتلقى ردًا بخطأ، ولا يتوقف عن الاستجابة أبدًا.
  • يُفعَّل برمز ترخيصك، دون إعادة بناء ودون تغيير في الشيفرة. ويعمل التقييم المجاني لمدة 60 يومًا على حاسوبك الخاص مع الوثائق والأمثلة.

طلب وإجابته

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

طلب v1_convert في مرجع API الخاص بالمحرك. ويوفّر المحرك أيضًا المحاكاة والاستخدام على الخادم بوصفهما إضافتين.

شاهد نموذجك أنت في SysML v2.

حوّله، واقرأ التقرير، ولا تستورد إلا حين تقتنع.

تبدأ الحسابات الجديدة تجربة Individual لمدة 30 يومًا عند أول تسجيل دخول: 10,000 عنصر لكل مشروع، دون بطاقة، والعودة إلى Free عند انتهائها. لديك حساب؟ ابدأ التجربة في إعدادات الحساب ← الخطة والفوترة.