SysML v2
التحويل بين LML وSysML v2
أنشئ نسخة SysML v2 من مشروع LML، أو نسخة LML من مشروع SysML v2، مع تقرير بما يتحول وما لا يتحول.
نظرة عامة
نوع المشروع، LML أو SysML v2، يُثبَّت عند إنشائه. وللعمل على نموذج LML في SysML v2، أو على نموذج SysML v2 بصفحات LML، أنشئ نسخة محوَّلة:
- يكتب إنشاء نسخة SysML v2… في مشروع LML نموذجَه كنص SysML v2 في مشروع SysML v2 جديد.
- يحوّل إنشاء نسخة LML… في مشروع SysML v2 نموذجَه إلى كيانات وعلاقات LML في مشروع LML جديد.
لا يتغير المشروع الأصلي أبدًا. وقبل إنشاء النسخة، يدرج تقرير ما يُحوَّل، مع الأعداد، وما لا يُحوَّل، مع السبب. ويُحفظ التقرير نفسه في المشروع الجديد.
المفاهيم
نسخة، لا تغيير في النوع
ينشئ التحويل دائمًا مشروعًا جديدًا. ويمكنك مواصلة العمل في الأصل والتحويل مجددًا لاحقًا؛ فكل تحويل ينشئ مشروعًا جديدًا آخر. ولا شيء يربط النسخة بالأصل.
كيف تتقابل اللغتان
تصف LML وSysML v2 كثيرًا من الأشياء نفسها بطرق مختلفة. ويستخدم التحويل هذا التقابل في الاتجاهين:
| LML | SysML v2 |
|---|---|
| Asset | تعريف جزء، مع استخدام جزء أينما استُخدم |
| تفكيك Asset (decomposed by) | استخدام جزء في تعريف الأصل |
| Port | استخدام منفذ |
| Characteristic لـ Asset | استخدام سمة |
| Conduit | استخدام اتصال، أو استخدام واجهة حين يكون الطرفان منفذين |
| Input/Output | تعريف عنصر متدفق، مع معاملات عناصر in وout وتدفقات |
| Requirement (Number، Name، Description) | استخدام متطلب (اسم مختصر، اسم، doc) |
| satisfied by | satisfy |
| Test Case | استخدام تحقق مع هدف verify |
| Test Suite | حزمة حالات تحقق |
| Action، مع تدفقه | استخدام إجراء مع تعاقبات |
| كتل SYNC والكتل المتوازية | تفرع والتقاء |
| OR | قرار ودمج |
| LOOP | إجراء حلقة |
| performed by | perform |
| خصائص الحالة والانتقالات | تعريف حالة مع انتقالات، يُظهره الجزء |
| 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 لمراجعة.
حوّل بعد أن يستقر النموذج، واقرأ التقرير قبل أن تعتمد على النسخة.
إنشاء نسخة محوَّلة
- في إدارة المشاريع، انقر ⋯ في صف المشروع.
- اختر إنشاء نسخة SysML v2… (لمشروع LML) أو إنشاء نسخة LML… (لمشروع SysML v2).
يفحص Holarch التحويل؛ وفي مشروع كبير يقول شريط تقدم أسفل النافذة “فحص التحويل…”. ثم يُفتح مربع الحوار بالتقرير.
- اقرأ التقرير:
- يدرج محوَّل كل نوع من العناصر، وعدده، وما يصير إليه، مثل “Requirements 24 استخدام متطلب”.
- يدرج غير محوَّل كل نوع من العناصر لا يُحوَّل، وعدده، والسبب.
- انقر تنزيل التقرير (CSV) لحفظ التقرير بصف لكل عنصر، إن احتجت إليه خارج Holarch.
- أدخل اسم المشروع الجديد. وقيمته الافتراضية اسم الأصل متبوعًا بـ “(SysML v2)” أو “(LML)”.
- انقر إنشاء نسخة.
يقول الإشعار “أُنشئ “<name>””. وتُفتح النسخة على صفحتها الرئيسية.
- افتح المستند تقرير التحويل في النسخة. فهو يدرج كل عنصر لم يُحوَّل، برقمه واسمه.
فحص النسخة
- في نسخة SysML v2، افتح النموذج ← المحرر.
النموذج حزمة واحدة ذات مستوى أعلى مسمّاة باسم المشروع. وتضم الحزم Architecture وSystem وItems وRequirements وVerification وBehavior وConstraints وViews (ما له محتوى منها فقط).
- ابحث عن علامات المشكلات في الهامش. فإن كان في النص المحوَّل مشكلات، فقد ذكر مربع الحوار ذلك قبل إنشاء النسخة: “في النص المحوَّل N مشكلات. تُظهرها النسخة في محررها.”
- افتح العروض في العروض (Architecture Overview وSystem Connections) لرؤية البنية مرسومة من جديد.
- في نسخة LML، افتح قاعدة البيانات والمخططات لفحص Asset وRequirement وتدفقات الإجراءات.
مثال تطبيقي: المشروع التوضيحي Hybrid Car كنسخة LML
أنشئ المشروع التوضيحي أولًا: في إدارة المشاريع، انقر ملفات المشروع ▾ ← مشروع توضيحي جديد ← Hybrid Car (SysML v2).
- في إدارة المشاريع، انقر ⋯ في Hybrid Car (SysML v2 demo) واختر إنشاء نسخة LML…. ستُسمّى النسخة “Hybrid Car (SysML v2 demo) (LML)”.
- اقرأ التقرير.
تحت محوَّل: تصير استخدامات الأجزاء 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.
- التخصيصات: لا تخصيص في LML؛ فتُنسخ إلى الأجزاء ميزاتُ تعريفاتها العامة. و
- انقر إنشاء نسخة.
تُفتح نسخة 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. في الولايات المتحدة ودول أخرى.