Holarch

SysML v2

التحويل بين LML وSysML v2

أنشئ نسخة SysML v2 من مشروع LML، أو نسخة LML من مشروع SysML v2، مع تقرير بما يتحول وما لا يتحول.

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

في هذه الصفحة
  1. نظرة عامة
  2. المفاهيم
    1. نسخة، لا تغيير في النوع
    2. كيف تتقابل اللغتان
    3. بيانات Holarch تنتقل معها
    4. ما الذي لا يُحوَّل
  3. طريقة استخدامها
    1. متى ولماذا
    2. إنشاء نسخة محوَّلة
    3. فحص النسخة
    4. مثال تطبيقي: المشروع التوضيحي Hybrid Car كنسخة LML
    5. نصائح وممارسات جيدة
    6. أخطاء شائعة
  4. مرجع التقرير
    1. من LML إلى SysML v2
    2. من SysML v2 إلى LML
    3. ملف CSV للتقرير
  5. الرسائل
  6. الحدود
  7. صفحات ذات صلة

نظرة عامة

نوع المشروع، LML أو SysML v2، يُثبَّت عند إنشائه. وللعمل على نموذج LML في SysML v2، أو على نموذج SysML v2 بصفحات LML، أنشئ نسخة محوَّلة:

  • يكتب إنشاء نسخة SysML v2… في مشروع LML نموذجَه كنص SysML v2 في مشروع SysML v2 جديد.
  • يحوّل إنشاء نسخة LML… في مشروع SysML v2 نموذجَه إلى كيانات وعلاقات LML في مشروع LML جديد.

لا يتغير المشروع الأصلي أبدًا. وقبل إنشاء النسخة، يدرج تقرير ما يُحوَّل، مع الأعداد، وما لا يُحوَّل، مع السبب. ويُحفظ التقرير نفسه في المشروع الجديد.

المفاهيم

نسخة، لا تغيير في النوع

ينشئ التحويل دائمًا مشروعًا جديدًا. ويمكنك مواصلة العمل في الأصل والتحويل مجددًا لاحقًا؛ فكل تحويل ينشئ مشروعًا جديدًا آخر. ولا شيء يربط النسخة بالأصل.

كيف تتقابل اللغتان

تصف LML وSysML v2 كثيرًا من الأشياء نفسها بطرق مختلفة. ويستخدم التحويل هذا التقابل في الاتجاهين:

LMLSysML v2
Assetتعريف جزء، مع استخدام جزء أينما استُخدم
تفكيك Asset (decomposed by)استخدام جزء في تعريف الأصل
Portاستخدام منفذ
Characteristic لـ Assetاستخدام سمة
Conduitاستخدام اتصال، أو استخدام واجهة حين يكون الطرفان منفذين
Input/Outputتعريف عنصر متدفق، مع معاملات عناصر in وout وتدفقات
Requirement (Number، Name، Description)استخدام متطلب (اسم مختصر، اسم، doc)
satisfied bysatisfy
Test Caseاستخدام تحقق مع هدف verify
Test Suiteحزمة حالات تحقق
Action، مع تدفقهاستخدام إجراء مع تعاقبات
كتل SYNC والكتل المتوازيةتفرع والتقاء
ORقرار ودمج
LOOPإجراء حلقة
performed byperform
خصائص الحالة والانتقالاتتعريف حالة مع انتقالات، يُظهره الجزء
Equation ومتغيراتهاتعريف قيد مع معاملاته

بيانات Holarch تنتقل معها

بعض البيانات لا مكان لها في أي من اللغتين. إنها بيانات Holarch، وتُنسخ مع روابطها:

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

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

  • تخطيطات المخططات. تُرسم العروض والمخططات من جديد في النسخة.
  • السجل وخطوط الأساس وطلبات التغيير. تبدأ النسخة دونها.
  • العناصر التي لا مكان لها في إحدى اللغتين، مثل Measure وResource في LML، أو التعدادات والحسابات وحالات التحليل في SysML v2.

يسمّي التقرير كل عنصر من هذا القبيل ويذكر السبب. انظر مرجع التقرير.

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

متى ولماذا

حوّل حين لا تعود لغة المشروع ملائمة للعمل:

  • من LML إلى SysML v2: صار فريقك أو أحد العملاء يعمل بـ SysML v2، أو يجب تبادل النموذج مع أدوات SysML v2. حوّل، ثم صدّر .sysml أو JSON (انظر تبادل نماذج SysML v2).
  • من SysML v2 إلى LML: تحتاج إلى صفحة LML أو مخطط LML لا يوجد في مشاريع SysML v2، أو تريد النموذج بصيغة دورة الحياة في Holarch لمراجعة.

حوّل بعد أن يستقر النموذج، واقرأ التقرير قبل أن تعتمد على النسخة.

إنشاء نسخة محوَّلة

  1. في إدارة المشاريع، انقر ⋯ في صف المشروع.
  2. اختر إنشاء نسخة SysML v2… (لمشروع LML) أو إنشاء نسخة LML… (لمشروع SysML v2).

    يفحص Holarch التحويل؛ وفي مشروع كبير يقول شريط تقدم أسفل النافذة “فحص التحويل…”. ثم يُفتح مربع الحوار بالتقرير.

  3. اقرأ التقرير:
    • يدرج محوَّل كل نوع من العناصر، وعدده، وما يصير إليه، مثل “Requirements 24 استخدام متطلب”.
    • يدرج غير محوَّل كل نوع من العناصر لا يُحوَّل، وعدده، والسبب.
  4. انقر تنزيل التقرير (CSV) لحفظ التقرير بصف لكل عنصر، إن احتجت إليه خارج Holarch.
  5. أدخل اسم المشروع الجديد. وقيمته الافتراضية اسم الأصل متبوعًا بـ “(SysML v2)” أو “(LML)”.
  6. انقر إنشاء نسخة.

    يقول الإشعار “أُنشئ “<name>””. وتُفتح النسخة على صفحتها الرئيسية.

  7. افتح المستند تقرير التحويل في النسخة. فهو يدرج كل عنصر لم يُحوَّل، برقمه واسمه.

فحص النسخة

  1. في نسخة SysML v2، افتح النموذج ← المحرر.

    النموذج حزمة واحدة ذات مستوى أعلى مسمّاة باسم المشروع. وتضم الحزم Architecture وSystem وItems وRequirements وVerification وBehavior وConstraints وViews (ما له محتوى منها فقط).

  2. ابحث عن علامات المشكلات في الهامش. فإن كان في النص المحوَّل مشكلات، فقد ذكر مربع الحوار ذلك قبل إنشاء النسخة: “في النص المحوَّل N مشكلات. تُظهرها النسخة في محررها.”
  3. افتح العروض في العروض (Architecture Overview وSystem Connections) لرؤية البنية مرسومة من جديد.
  4. في نسخة LML، افتح قاعدة البيانات والمخططات لفحص Asset وRequirement وتدفقات الإجراءات.

مثال تطبيقي: المشروع التوضيحي Hybrid Car كنسخة LML

أنشئ المشروع التوضيحي أولًا: في إدارة المشاريع، انقر ملفات المشروع ▾ ← مشروع توضيحي جديد ← Hybrid Car (SysML v2).

  1. في إدارة المشاريع، انقر ⋯ في Hybrid Car (SysML v2 demo) واختر إنشاء نسخة LML…. ستُسمّى النسخة “Hybrid Car (SysML v2 demo) (LML)”.
  2. اقرأ التقرير.

    تحت محوَّل: تصير استخدامات الأجزاء Asset، واستخدامات المنافذ Port، والسمات Characteristic، واستخدامات الاتصال والواجهة Conduit، واستخدامات المتطلبات وتعريفاتها Requirement، واستخدامات التحقق Test Case، والإجراءات Action، والحالات والانتقالات نظائرها في LML.

    تحت غير محوَّل، من بين أمور أخرى:

    • التخصيصات: لا تخصيص في LML؛ فتُنسخ إلى الأجزاء ميزاتُ تعريفاتها العامة. وSportCar :> Car واحد منها.
    • إعادة التعريفات: تحل الميزة المعيدة للتعريف محل الموروثة في كل جزء منسوخ. وتُنسخ بطارية السيدان بـ 48 kg.
    • التعدادات (DriveMode، FuelKind): تُحفظ قيم السمات نصًا.
    • الحسابات (PowerToWeight، ElectricRange) وحالات التحليل (PowerToWeightAnalysis).
    • موصلات الربط (bind output = transmission.output;): لا ربط بين الميزات في LML.
    • قيم السمات: تُحفظ نصًا في Value لكل Characteristic؛ ولا تُقيَّم الوحدات والتعبيرات.
    • العروض: تُرسم المخططات من جديد في نسخة LML.
  3. انقر إنشاء نسخة.

    تُفتح نسخة LML. fleet.sedan وأجزاؤه Asset؛ والمتطلب Sedan Mass (VR-1.1) هو Requirement يستوفيه Asset السيدان. وتُنسخ مخاطر المشروع التوضيحي وقراراته ومهامه أيضًا، مرتبطةً بالعناصر المحوَّلة.

لتجربة الاتجاه الآخر، أنشئ المشروع التوضيحي CubeSat EO-1 (مشروع LML) واختر إنشاء نسخة SysML v2… فيه.

نصائح وممارسات جيدة

  • رتّب مشروع LML قبل التحويل: صِل كل Conduit باثنين بالضبط من Asset أو Port، وألحق كل Characteristic بـ Asset أو Equation، وأزل مجموعات الاختبار الفارغة. وإلا أُبلغ عنها بأنها غير محوَّلة.
  • في LML، اكتب تسميات فروع OR كتعبيرات منطقية على قيم النموذج (مثل speed > 3) إن أردت أن تصير حُرّاسًا. وتصير التسميات الأخرى تعليقات doc على التعاقبات.
  • في SysML v2، أعطِ الفاعلين نوعًا من تعريف جزء، ومعاملات العناصر نوعًا من تعريف عنصر متدفق. ولا يُحوَّل غير المنمَّط منها.
  • احتفظ بالأصل. وحوّل منه مجددًا بعد التغييرات الكبيرة بدل تعديل المشروعين بالتوازي.

أخطاء شائعة

  • افتراض أن الأصل سيتغير. لا يتغير. فالنسخة مشروع منفصل.
  • افتراض أن المخططات ستحتفظ بتخطيطها. لا تُحوَّل التخطيطات؛ رتّب العروض أو المخططات الجديدة مجددًا.
  • أجزاء مفقودة في نسخة LML. تعريف الجزء الذي لا يستخدمه أي جزء ليس له Asset في LML، لأن LML لا تعرف إلا المثيلات. استخدم التعريف في جزء، ثم حوّل مجددًا.
  • عنصر “لا يُحَل” في التقرير. اسم في نص SysML v2 لا يشير إلى أي شيء. أصلح الاسم في المحرر، ثم حوّل مجددًا.

مرجع التقرير

من LML إلى SysML v2

تشمل العناصر المحوَّلة Asset (تعريفات الأجزاء مع استخداماتها) وCharacteristic (السمات) وPort وConduit (الاتصالات أو الواجهات) وInput/Output (تعريفات العناصر المتدفقة) وRequirement وAction وحالات الاستخدام وتدفقات العناصر بين الإجراءات وState وTransition وEquation (تعريفات القيود) وPerforms ومجموعات الاختبار وTest Case وVerifies وSatisfies، وعناصر Holarch (المنسوخة مع روابطها): المصنوعات والبيانات والمهام والمخاطر وعناصر الجدول الزمني والتكاليف والمسائل والقرارات والمخاطر على السلامة وأنماط الإخفاق. وينتقل سير عمل الفئات (تغييرات مخطط المشروع) بحالاته المخصصة وانتقالاته ومعتمِديه، فتحتفظ المتطلبات وحالات الاختبار بقيم Status المخصصة. وتحتفظ النسخة بمفتاحي البرنامج الرسمي والسلامة والموثوقية للمشروع.

غير محوَّلالسبب
Asset في حلقة تفكيكالأصل الذي يحتوي نفسه لا مكان له في شجرة أجزاء. يُحوَّل تعريف جزئه؛ ولا يُستخدم كجزء.
Conduit ليس له طرفان بالضبطيصل اتصال SysML بين طرفين. صِل القناة بأصلين أو منفذين، ثم حوّل مجددًا.
العناصر التي تنقلها قناةلا تحمل الاتصالات في هذا التحويل عناصر. وتُحوَّل العناصر كتعريفات عناصر متدفقة وتدفقات بين الإجراءات.
Conduit مفكّك إلى قنوات أخرىلا تتداخل اتصالات SysML هنا؛ فكل قناة تصير اتصالًا خاصًا بها.
أعداد الحلقات والبرامج النصية للحلقاتتتكرر حلقة SysML هنا حتى يتحقق شرط؛ ويُحفظ العدد كبيانات Holarch ويستعيده «إنشاء نسخة LML».
تسميات فروع القرار واحتمالاتهاحين تكون كل تسمية لقرار تعبيرًا منطقيًا على قيم النموذج، تصير التسميات حُرّاسه؛ وإلا صارت تعليقات doc على التعاقبات. وتُحفظ الاحتمالات كبيانات Holarch للمحاكي، ويستعيد «إنشاء نسخة LML» كليهما.
عناصر OR وSYNC وLOOPتُحوَّل البنى كعُقد قرار/دمج وتفرع/التقاء وحلقة؛ ولا تُحفظ العناصر التي سمّتها.
إجراءات الدخول والتنفيذ والخروج للحالاتتُحوَّل الإجراءات كإجراءات؛ ولا يملأ هذا التحويل أجسام حالات SysML.
انتقالات ليس لها حالتان من آلة واحدةيصل انتقال SysML بين حالتين من تعريف الحالة نفسه.
حُرّاس الانتقالات ومشغّلاتهاتُكتب في LML نصًا حرًا؛ وتُحفظ كبيانات Holarch، لا كتعبيرات SysML، ويستعيدها «إنشاء نسخة LML».
حالات لا يحددها أصلتحتاج الحالة إلى الأصل الذي تصف سلوكه.
تعبيرات Equationتستخدم التعبيرات أسماء ليست ميزات SysML؛ ويُحفظ كل منها كتعليق في تعريف القيد الخاص به.
مجموعات اختبار بلا حالات اختبارتصير المجموعة حزمة حالات التحقق الخاصة بها؛ والمجموعة الفارغة لا شيء لديها لتحويه.
حالات اختبار تتحقق من شيء غير متطلبلا تتحقق حالة تحقق SysML إلا من المتطلبات.
دورات الاختبارتشغيلات الاختبار المسجلة على مجموعة ليست جزءًا من النموذج؛ وتُحفظ أحدث نتيجة لكل حالة.
متطلبات تستوفيها أنواع أخرى من العناصرمثلًا، لا يستوفي متطلب متطلبًا آخر في SysML؛ استخدم الاشتقاق في النص.
علاقات أخرىليس لهذا التحويل علاقة SysML لها؛ ويسمّي التقرير كلًا منها.
Measureليس لمقاييس الفعالية عنصر SysML في هذا التحويل.
Resourceكميات الموارد (الاستهلاك والإنتاج) تخص محاكي LML وليس لها عنصر SysML هنا.
Characteristic غير ملحقة بأصل أو معادلةتحتاج السمة إلى مالك: حدّدها بأصل أو اجعلها متغير معادلة.
عناصر من فئات أخرىليس لهذه الفئة عنصر SysML ولا مكان في Holarch داخل مشروع SysML v2.
الميزات والتكويناتليس بعد: لا تصير ميزات خط الإنتاج وتكويناته نقاط تباين ومتغيرات وتكوينات في SysML v2. ويدرجها التقرير كعناصر Feature وعناصر Configuration؛ نمذج المتغيرات مجددًا في النسخة (انظر المتغيرات والتكوينات في SysML v2).
خطوط الأساسلا تنطبق خطوط أساس مشروع LML على النموذج الجديد؛ وتبدأ النسخة دون خطوط أساس.
السجليبدأ سجل التغييرات من جديد في النسخة.
طلبات التغييرتقترح طلبات التغيير في LML تغييرات على عناصر LML، وهي غير موجودة في النسخة.
تخطيطات المخططاتتُرسم المخططات من جديد كعروض SysML v2؛ ولا تُنقل المواضع.
العناصر المحوَّلة في مخططات المستندات التفصيليةتُنسخ المستندات؛ وصارت المتطلبات وعناصر النموذج الأخرى في مخططاتها التفصيلية عناصر SysML وتظهر في النموذج، لا في المخطط التفصيلي.

من SysML v2 إلى LML

يصير كل استخدام جزء Asset، مع نسخ أجزاء تعريفه ومنافذه وسماته (وتعريفات ما يخصّصه) إليه. وتحل إعادة التعريفات محل ما تعيد تعريفه. وتصير الاتصالات والواجهات Conduit بين تلك الأصول. وتعود المتطلبات وحالات التحقق وsatisfy وverify وperform ومعاملات العناصر والحالات والانتقالات كما في الجدول أعلاه. وتصير التعاقبات تدفقات إجراءات؛ وتصير حُرّاس القرار (أو تعليقات doc على تعاقباته) تسميات فروع OR، مع احتمالاتها. وتنتقل تغييرات مخطط المشروع، بما في ذلك سير عمل الفئات بحالاته المخصصة وانتقالاته ومعتمِديه، فتحتفظ المتطلبات وحالات الاختبار بقيم Status المخصصة.

غير محوَّلالسبب
اتصالات بأطراف لا تُحَلأصلح أسماء الأطراف في النص، ثم حوّل مجددًا.
اتصالات داخل تعريفات لا يستخدمها أي جزءيصير كل اتصال قناة بين أجزاء كل جزء يملكه؛ ولا شيء يستخدم هذا التعريف.
موصلات الربطلا ربط (مساواة) بين الميزات في LML.
علاقات verify لا تُحَلأصلح اسم المتطلب في هدف التحقق، ثم حوّل مجددًا.
معاملات عناصر بلا تعريف عنصر متدفقنمّط المعامل بـ item def لتحويله.
فاعلون بلا تعريف جزء في النموذجنمّط الفاعل بـ part def لتحويله.
استخدامات perform لا تُحَل إلى إجراء وجزءنفّذ إجراءً من تعريف جزء أو استخدام جزء، ثم حوّل مجددًا.
علاقات satisfy لا تُحَلأصلح الأسماء في عبارة satisfy، ثم حوّل مجددًا.
تعاقبات ليست تدفقًا مهيكلًاتدفقات الإجراءات في LML تسلسلات بكتل متوازية وقرار وحلقة؛ وتُحوَّل رسوم التعاقب الأخرى إلى تسلسل خطي.
تعريفات حالات لا يُظهرها أي جزءتُحوَّل الحالات دون الأصل الذي تصف سلوكه.
انتقالات لا تُحَل إلى حالتينأصلح أسماء الحالات، ثم حوّل مجددًا.
مشغّلات الانتقالات (accept)لا تحتفظ انتقالات LML بالمشغّل إلا نصًا حرًا؛ ولا تُربط الإشارة المقبولة.
تعريفات المنافذ والواجهات والاتصالاتتُحوَّل إلى Port وConduit حيث تستخدمها الأجزاء؛ ولا أنواع منافذ أو واجهات أو اتصالات في LML.
تعريفات السمات (أنواع القيم)لا أنواع لخصائص LML.
التعدادات وقيم التعدادلا تعدادات في LML؛ وتُحفظ قيم السمات نصًا.
الحسابات وحالات التحليل والاهتماماتلا حسابات ولا حالات تحليل ولا اهتمامات أصحاب مصلحة في LML.
العروض ووجهات النظرتُرسم المخططات من جديد في نسخة LML.
إجراءات الإسناد وif والإرسال والقبوللا عبارات في إجراءات LML.
التبعياتلا تبعية عامة في LML.
التخصيصاتاستخدم perform في النص للإجراءات التي تنفذها الأجزاء.
البيانات الوصفيةلا بيانات وصفية في LML.
الحدوثاتلا حدوثات في LML.
حالات الاستخدام المضمَّنةلا تُحوَّل علاقات التضمين بين حالات الاستخدام.
الأسماء البديلةلكل كيان في LML اسم واحد.
استخدامات المراجع (معاملات الحسابات والحالات)لا معاملات في LML سوى متغيرات المعادلات.
التخصيصاتلا تخصيص في LML؛ فتُنسخ إلى الأجزاء ميزاتُ تعريفاتها العامة.
إعادة التعريفاتتحل الميزة المعيدة للتعريف محل الموروثة في كل جزء منسوخ.
المجموعات الفرعيةلا مجموعات فرعية في LML.
الاستيراداتلا فضاءات أسماء في LML؛ فكل كيان مرئي في المشروع.
التعريفات بوصفها متميزة عن الاستخداماتلا تعرف LML إلا المثيلات: يصير تعريف الجزء أصولَ الأجزاء التي تستخدمه، ويذهب نصه إلى أوصافها.
التعدديات لغير الأجزاءلا مكان في LML إلا لتعدديات الأجزاء (Multiplicity لعلاقة decomposed by).
قيم السماتتُحفظ القيم نصًا في Value لكل خاصية؛ ولا تُقيَّم الوحدات والتعبيرات.
خطوط الأساسلا تنطبق خطوط أساس مشروع SysML v2 على نسخة LML؛ وتبدأ دون خطوط أساس.
السجليبدأ سجل التغييرات من جديد في النسخة.
طلبات التغييرتقترح طلبات التغيير في SysML تغييرات نصية لا تنطبق على كيانات LML.

ملف CSV للتقرير

يكتب تنزيل التقرير (CSV) صفًا لكل نوع من العناصر المحوَّلة وصفًا لكل عنصر لم يُحوَّل. وأعمدته النتيجة (محوَّل أو غير محوَّل) وماذا والعدد ويصير أو السبب والرقم والاسم.

الرسائل

الرسالةالمعنى والحل
فحص التحويل… (شريط التقدم)يجري إعداد التقرير.
هذا مشروع SysML v2 بالفعل. اختر «إنشاء نسخة LML…» بدلًا من ذلك.اختير الاتجاه الخطأ.
هذا مشروع LML بالفعل. اختر «إنشاء نسخة SysML v2…» بدلًا من ذلك.اختير الاتجاه الخطأ.
في النص المحوَّل N مشكلات. تُظهرها النسخة في محررها.يمكن إنشاء النسخة؛ أصلح المشكلات في محررها.
لا يُحلَّل النص المحوَّل (…). لم يُنسخ المشروع؛ أبلغ عن هذا مع ملف المشروع.فشل التحويل. تواصل مع الدعم مع ملف المشروع.
لم يبدأ مدقق SysML. أعد تحميل الصفحة وحاول مجددًا.أعد التحميل وحاول مجددًا.
تعذّرت قراءة المشروع. أعد تحميل الصفحة وحاول مجددًا.أعد التحميل وحاول مجددًا.
لم تُنشأ النسخة: … أعد تحميل الصفحة وحاول مجددًا.أعد التحميل وحاول مجددًا.
أُنشئ “<name>”أُنشئت النسخة وفُتحت.

الحدود

  • لا تُحوَّل تخطيطات المخططات والسجل وخطوط الأساس وطلبات التغيير.
  • ليس بعد: تحويل خط إنتاج LML (الميزات والتكوينات) إلى متغيرات SysML v2.
  • يدرج مستند التقرير حتى 500 عنصر لكل نوع.

SysML® وOMG® علامتان تجاريتان مسجلتان لشركة Object Management Group, Inc. في الولايات المتحدة ودول أخرى.