Holarch

SysML v2

تبادل نماذج SysML v2

استورد ملفات .sysml وأرشيفات zip وSysML v2 JSON إلى مشروع SysML v2 مع معاينة، وصدّر النموذج أو حزمة كنص .sysml أو SysML v2 JSON.

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

في هذه الصفحة
  1. نظرة عامة
  2. المفاهيم
    1. صيغ الملفات
    2. المعرّفات والمطابقة
    3. معرّفات العناصر في النص
    4. المجلدات تصبح حزمًا
    5. ما تقارنه المعاينة
  3. طريقة استخدامها
    1. متى ولماذا
    2. استيراد الملفات إلى هذا المشروع
    3. استيراد الملفات إلى مشروع جديد
    4. تحديث حزمة من إصدار جديد
    5. إعادة تسمية العناصر ونقلها في النص مع الاحتفاظ بمعرّفاتها
    6. عمليات الاستيراد الكبيرة على الخدمة المستضافة
    7. تصدير النموذج أو حزمة
    8. استيراد متطلبات ReqIF وتصديرها
    9. السحب من مستودع والدفع إليه
    10. مثال تطبيقي: المشروع التوضيحي Hybrid Car
    11. نصائح وممارسات جيدة
    12. أخطاء شائعة
    13. كيف يرتبط بالميزات الأخرى
  4. صفحة الاستيراد والتصدير
    1. استيراد
    2. تصدير
  5. المستودع
  6. كيف تُقرأ الملفات
    1. العناصر التي لا يفسّرها Holarch
  7. الرسائل
  8. الحدود
  9. صفحات ذات صلة

نظرة عامة

تتبادل مشاريع SysML v2 النماذج مع أدوات SysML v2 الأخرى كملفات. وتقوم صفحة الاستيراد والتصدير (النموذج ← الاستيراد والتصدير) بالأمرين:

  • يقرأ استيراد ملفات .sysml، أو ملف .zip من ملفات .sysml، أو ملف SysML v2 JSON. ويُظهر معاينة لما يتغير، ثم يطبّقه على هذا المشروع (ويُلغي تراجع واحد ذلك كله) أو ينشئ مشروع SysML v2 جديدًا.
  • يكتب تصدير النموذج كاملًا أو حزمة واحدة كنص SysML v2 (.sysml) أو بصيغة SysML v2 JSON (.json).
  • تُستورد ملفات ReqIF (.reqif، .reqifz) من أدوات المتطلبات كمتطلبات SysML v2، وتُصدَّر المتطلبات بصيغة ReqIF: انظر استيراد متطلبات ReqIF وتصديرها.

يمكنك أيضًا إنشاء مشروع مباشرة من ملفات: في إدارة المشاريع، انقر ملفات المشروع ▾ ← استيراد ملفات SysML v2….

تلميح: لإبقاء النموذج متوافقًا مع مستودع نماذج SysML v2 يوفّر Systems Modeling API، استخدم قسم المستودع في الصفحة نفسها: انظر السحب من مستودع والدفع إليه.

المفاهيم

صيغ الملفات

الصيغةمحتوياتهااستيرادتصدير
نص SysML v2 (.sysml)الصيغة النصية، ملف واحد لكل حزمة على المستوى الأعلى.نعمنعم
أرشيف Zip (.zip)عدة ملفات .sysml. والمجلدات تصبح حزمًا.نعمنعم، عند تصدير عدة ملفات
SysML v2 JSON (.json)قائمة مسطّحة من العناصر، لكل منها @id و@type، كما يستخدمها Systems Modeling API.نعمنعم
ReqIF (.reqif، .reqifz)متطلبات بسماتها وتسلسلها الهرمي وعلاقاتها، من DOORS وPolarion وJama وcodebeamer وأدوات المتطلبات الأخرى.نعم، محوّلة إلى متطلباتنعم، المتطلبات

لا تُستورد ملفات KerML (.kerml) بعد.

المعرّفات والمطابقة

لكل عنصر في مشروع SysML v2 معرّف. وتحتفظ به الصيغتان بطريقتين مختلفتين:

  • تحتفظ JSON بالمعرّفات. العنصر المستورد مجددًا من JSON يطابق العنصر الذي يحمل المعرّف نفسه.
  • تُفهم مراجع المكتبة القياسية. تسمّي JSON القادمة من Systems Modeling API أو SysML v2 Pilot Implementation أو مستودع آخر عناصر المكتبة القياسية (وحدات مثل ISQ::mass، وScalarValues::Real، وParts::Part) بالمعرّفات القياسية. ويقرؤها الاستيراد بوصفها عناصر المكتبة نفسها، فتبقى الوحدات والأنواع محلولة.
  • يحتفظ النص بالمعرّفات عندما تطلبها. حدّد تضمين معرّفات العناصر عند تصدير نص .sysml. فيحمل عندئذٍ كل تعريف واستخدام وحزمة مسمّاة معرّفه كأول سطر في جسمه، @HolarchMetadata::ElementId { id = "…"; }. وعندما يُستورد ذلك النص مجددًا، يطابق كل عنصر له معرّف العنصر الذي يحمل المعرّف نفسه، حتى لو أُعيدت تسميته أو نُقل إلى مالك آخر أو حزمة أخرى على المستوى الأعلى أو أُعيد ترتيبه. وتبقى مواضعه في المخططات وتعليقاته وتتبعاته وروابطه.
  • يُطابَق النص الذي لا معرّفات فيه بالاسم. يطابق Holarch الحزم على المستوى الأعلى بالاسم، والعناصر داخلها بأسمائها ومواضعها. وتُحفظ المعرّفات حيث تتطابق العناصر. والعنصر المعاد تسميته يبقى مطابَقًا ما دام يحتفظ بمكانه؛ أما العنصر الذي أُعيدت تسميته ونُقل في الوقت نفسه فيصبح عنصرًا جديدًا.

يذكر التصدير هذا تحت عناصر التحكم في التصدير: “تُحفظ معرّفات العناصر في JSON. وفي نص .sysml، حدّد «تضمين معرّفات العناصر» للاحتفاظ بها: فتحتفظ العناصر عندئذٍ بمواضعها في المخططات وتعليقاتها وتتبعاتها عند استيراد النص المعدَّل مجددًا، حتى بعد إعادة التسمية أو النقل. ودون معرّفات، تُطابَق العناصر بالاسم.”

معرّفات العناصر في النص

@HolarchMetadata::ElementId { id = "…"; } بيانات وصفية عادية في SysML v2: ElementId تعريف بيانات وصفية في حزمة المكتبة الخاصة بـHolarch HolarchMetadata (في المكتبة القياسية تحت Holarch)، بجانب TBD وTBR. وتقرأ أدوات SysML v2 الأخرى السطر كتعليقة بيانات وصفية؛ ولحل اسمه تحتاج إلى HolarchMetadata.sysml من تلك المكتبة.

  • ينتمي المعرّف إلى العنصر الذي يحتوي جسمه على السطر. والعناصر غير المسمّاة (الاتصالات والتعاقبات والتعليقات) لا تحمل معرّفًا وتُطابَق بمحتواها، كما في السابق.
  • لا يحتفظ Holarch بالسطر كعنصر. ويعرض المحرر النموذج دون هذه الأسطر، والعنصر الذي لم يحتوِ جسمه إلا على السطر يُعرض بوصفه part engine : Engine;.
  • يجب أن تكون المعرّفات فريدة. وعندما يظهر المعرّف نفسه مرتين (مثلًا بعد نسخ كتلة في النص)، يحتفظ به العنصر الأول وتصبح النسخة عنصرًا جديدًا.
  • المعرّف الذي ليس UUID (مثلًا "R-17") يُحوَّل إلى UUID ثابت، فيعطي النص نفسه دائمًا العنصر نفسه، كما في استيراد JSON.
  • المعرّف غير الموجود في المشروع يُحفظ للعنصر الجديد. وحذف عنصر في Holarch واستيراد النص مجددًا يعيده بمعرّفه القديم.
  • في المحرر، يعمل السطر الملصق ضمن الحزمة التي تعدّلها: المعرّف الذي ينتمي إلى عنصر في حزمة أخرى يُتجاهل هناك، ويُطابَق العنصر بالاسم. ولنقل العناصر بين الحزم مع الاحتفاظ بمعرّفاتها، صدّر مع المعرّفات واستورد الملفات المعدّلة.

يحمل تعريف الجزء Car في المشروع التوضيحي Hybrid Car مثل هذا السطر في ملفه المصدر، لذا يكون معرّفه هو نفسه في كل نسخة من المشروع التوضيحي.

المجلدات تصبح حزمًا

في أرشيف zip، يصبح كل مجلد حزمة تحتوي على ملفاته ومجلداته الفرعية. ويُقرأ الملف powertrain/engine.sysml داخل الأرشيف كما لو كان مكتوبًا داخل package powertrain { … }. وتُقرأ الملفات في أعلى الأرشيف كما هي. وتُقرأ المجلدات والملفات بترتيب الأسماء.

ما تقارنه المعاينة

للمعاينة صف واحد لكل حزمة على المستوى الأعلى (أو، للمشروع الجديد، لكل عنصر على المستوى الأعلى). ولكل صف نتيجة:

النتيجةالمعنىيُستورد افتراضيًا
جديدليس في المشروع حزمة بذلك الاسم (أو المعرّف). فتُضاف.نعم
معدَّلفي المشروع الحزمة؛ ويضيف الاستيراد عناصر فيها أو يغيّرها أو يزيلها. ويذكر التفصيل كم عددها، مثلًا “3 مُضافة، 1 متغيّرة (حُفظت المعرّفات حيث تتطابق العناصر)”.نعم
دون تغييرالحزمة هي نفسها كما في هذا المشروع.لا (لا شيء لفعله)
تعارضلا يمكن دمج الحزمة. ويذكر التفصيل السبب وما يجب فعله.لا

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

متى ولماذا

استخدم الاستيراد والتصدير عندما ينتقل نموذج بين Holarch وأداة SysML v2 أخرى، أو بين مشاريع Holarch:

  • ابدأ مشروع Holarch من نموذج مكتوب في مكان آخر.
  • اجلب حزمة يتولاها فريق آخر، مثل مكتبة مكونات، وحدّثها عندما يرسلون إصدارًا جديدًا.
  • سلّم حزمة إلى مورّد أو إلى أداة تقرأ نص SysML v2 أو JSON.
  • احتفظ بملفات .sysml في نظام التحكم في الإصدارات الخاص بك بجانب مشروع Holarch.

استيراد الملفات إلى هذا المشروع

  1. افتح النموذج ← الاستيراد والتصدير.
  2. تحت استيراد، اختر إلى هذا المشروع.
  3. أفلت الملفات على منطقة الإفلات، أو انقرها واخترها.

    ترى “جارٍ قراءة الملفات…”، ثم المعاينة: عدد الحزم على المستوى الأعلى والملفات، وأي مشكلات، وجدولًا يحتوي على استيراد والحزمة والعناصر والنتيجة.

  4. اقرأ قائمة المشكلات إن وُجدت. فهي تذكر كل ملف وسطر لا يُحلَّل وكل ملف تم تخطيه.
  5. ألغِ تحديد أي حزمة لا تريد استيرادها. ولاستبدال حزمة تتعارض بالاسم، حدّدها.

    في خطة ذات حد للعناصر، تحسب المعاينة العناصر التي سيضمها المشروع بعد الاستيراد (لا تُحسب العلاقات). وإن تجاوز ذلك الحد، تذكر ذلك، مثل “سيرفع هذا الاستيراد المشروع إلى 1,804 عناصر؛ وتسمح خطة Free بـ 1,000.”، ويبقى استيراد N حزم معطّلًا حتى تلغي تحديد ما يكفي من الحزم. لا يُطبَّق شيء ولا يُرسل إلى الخادم. وتُفحص عمليات الاستيراد إلى مشروع جديد مقابل حد المشروع الواحد في خطتك بالطريقة نفسها.

  6. انقر استيراد N حزم.

    يقول الإشعار “استُوردت N حزم.” وتقول الصفحة “استُوردت N حزم (M عناصر). يتراجع التراجع عن الاستيراد في خطوة واحدة.” انقر فتح النص لرؤيتها.

استيراد الملفات إلى مشروع جديد

  1. افتح النموذج ← الاستيراد والتصدير واختر إلى مشروع SysML v2 جديد.
  2. أفلت الملفات أو اخترها.

    تدرج المعاينة العناصر ذات المستوى الأعلى، وكلها محددة.

  3. ألغِ تحديد ما لا تريده، وعدّل اسم المشروع. وقيمته الافتراضية اسم الملف الوحيد، أو الحزمة الأولى.
  4. انقر إنشاء مشروع.

    يُفتح المشروع الجديد في المحرر.

من إدارة المشاريع، يؤدي ملفات المشروع ▾ ← استيراد ملفات SysML v2… الأمر نفسه في خطوة واحدة. وإن تعذّرت قراءة أجزاء من الملفات، يسأل أولًا: “عُثر على N مشكلات: تُستبعد أجزاء من الملفات. أتنشئ المشروع بالباقي؟ لرؤية المشكلات أولًا، افتح مشروع SysML v2 واستخدم الاستيراد والتصدير.” انقر إنشاء مشروع للمتابعة.

تحديث حزمة من إصدار جديد

  1. صدّر الإصدار الجديد أو استلمه كملفات .sysml أو JSON.
  2. استورده إلى هذا المشروع.

    تُظهر الحزمة متغيرة، مع عدد العناصر المضافة والمتغيرة والمحذوفة.

  3. انقر استيراد حزمة واحدة.

    تحتفظ العناصر المتطابقة بمعرّفاتها، فتبقى الروابط إليها (روابط المتطلبات والمخاطر وتخطيطات العروض والتعليقات). وتنتقل العناصر التي لم تعد في الملف إلى سلة المحذوفات.

إعادة تسمية العناصر ونقلها في النص مع الاحتفاظ بمعرّفاتها

  1. صدّر الحزم بصيغة نص SysML v2 مع تحديد تضمين معرّفات العناصر.
  2. عدّل الملفات: أعد تسمية العناصر، وانقلها إلى مالكين آخرين أو إلى ملف حزمة آخر، وأعد ترتيبها. أبقِ كل سطر @HolarchMetadata::ElementId داخل جسم عنصره.
  3. استورد الملفات المعدّلة إلى هذا المشروع.

    تُظهر الحزم متغيرة. وتُحسب العناصر المعاد تسميتها والمنقولة متغيرة، لا مضافة ومحذوفة.

  4. انقر استيراد N حزم.

    تحتفظ العناصر بمعرّفاتها: فتبقى مواضعها في المخططات وتعليقاتها وتتبعاتها وروابطها. والعناصر المنقولة إلى حزمة أخرى تغادر الحزمة التي كانت فيها.

عمليات الاستيراد الكبيرة على الخدمة المستضافة

على الخدمة المستضافة، يطبّق الخادم، لا متصفحك، أي استيراد من 5,000 عنصر أو أكثر. وعندما تكون كل حزمة محددة جديدة أو تستبدل تعارضًا، يقرأ الخادم الملفات بنفسه (الخطوات أدناه). وعندما تكون حزمة محددة متغيرة، يحسب متصفحك الدمج كالمعتاد ويرفع التغييرات مرة واحدة؛ ثم يكتبها الخادم في خطوة واحدة، مع بطاقة التقدم نفسها و«إلغاء الاستيراد» و«التراجع عن الاستيراد».

  1. اختر الملفات وافحص المعاينة كما في أي استيراد.
  2. انقر استيراد N حزم (أو إنشاء مشروع).

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

  3. تابع بطاقة التقدم أسفل النافذة: فهي تُظهر المرحلة (الرفع، القراءة، الفحص، التطبيق، تحديث فهرس المشروع) والوقت المتبقي.

    يمكنك مغادرة الصفحة أو إغلاق علامة التبويب. يستمر الاستيراد على الخادم، وعندما تفتح المشروع مجددًا تجد نتيجته. وتُعاد تحميل كل نسخة مفتوحة من المشروع عند تطبيق الاستيراد؛ وتُرسل التعديلات غير المرسلة مجددًا بعد إعادة التحميل.

  • يرى الأعضاء الآخرون “Name يستورد file…” في البطاقة نفسها وفي صفحة الاستيراد والتصدير.
  • استيراد واحد في كل مرة: ينتظر استيراد كبير ثانٍ إلى المشروع نفسه حتى ينتهي الأول.
  • يوقف إلغاء الاستيراد (لمن بدأه، أو لمالك) الاستيراد قبل تطبيقه. ولا يتغير شيء.
  • التراجع عن الاستيراد: لا يُلغي ⌘Z / Ctrl+Z في المتصفح استيراد الخادم. انقر التراجع عن الاستيراد في صفحة الاستيراد والتصدير لإعادة المشروع إلى حالته قبل آخر استيراد. وتُحفظ الحالة السابقة للتراجع في السجل، فيمكن استرداد التعديلات التي أُجريت بعد الاستيراد من هناك.
  • يدرج نشاط المشروع والسجل الاستيراد كإدخال واحد باسم من بدأه.

تصدير النموذج أو حزمة

  1. افتح النموذج ← الاستيراد والتصدير.
  2. تحت تصدير، اختر ما تريد تصديره: النموذج كله، أو حزمة باسمها المؤهل.
  3. اختر الصيغة: نص SysML v2 (.sysml؛ أو .zip لعدة حزم) أو SysML v2 JSON (.json).
  4. للنص الذي ستعدّله وتستورده مجددًا، حدّد تضمين معرّفات العناصر.
  5. انقر تصدير.

    يُنزَّل ملف واحد، أو ملف zip عندما يضم التصدير عدة ملفات. ويقول الإشعار “صُدّر <file>.” أو “صُدّرت N ملفات كملف zip.”

لتصدير حزمة واحدة بسرعة، استخدم المستعرض: تحتوي قائمة صف الحزمة على تصدير بصيغة .sysml وتصدير بصيغة JSON.

استيراد متطلبات ReqIF وتصديرها

ReqIF هي صيغة التبادل لأدوات المتطلبات. يُستورد ملف ReqIF كحزمة واحدة من متطلبات SysML v2، وتُصدَّر المتطلبات عائدةً بصيغة ReqIF، فتتبادل أداة متطلبات ومشروع SysML v2 المتطلبات نفسها في الاتجاهين.

استيراد ملف ReqIF:

  1. افتح النموذج ← الاستيراد والتصدير (أو انقر استيراد… في صفحة المتطلبات، أو اختر استيراد ReqIF… في ⌘K / Ctrl+K).
  2. أفلت الملف .reqif أو .reqifz على المربع، أو انقر المربع لاختياره. ملف ReqIF واحد لكل استيراد.
  3. تُظهر لوحة ReqIF عدد المتطلبات والفصول والعلاقات، وكم منها حُوّل أو قُرّب أو استُبعد، وما إذا كان نص SysML v2 يجتاز الفحص دون مشكلات.
  4. تحت الأسماء المختصرة من، اختر المعرّف الخارجي (الرقم الذي يراه الناس في الأداة المصدر، مثل SRS-12) أو معرّف ReqIF (المعرّف الداخلي للأداة). والمتطلبات التي لا معرّف خارجيًا لها تأخذ المعرّف.
  5. تحت أنواع العلاقات، اختر ما يصير إليه كل نوع علاقة: اشتقاق أو تنقيح أو تبعية أو استبعاد. تُحسب المعاينة مجددًا، ويُحفظ الاختيار للاستيراد التالي للملف نفسه.
  6. انقر استيراد حزمة واحدة. ويُلغي تراجع واحد الاستيراد كله. ويقول الإشعار “استُوردت N متطلبات من <title>.”

ما ينشئه الاستيراد:

ReqIFSysML v2
متطلب (كائن مواصفة)requirement، مع المعرّف الخارجي أو المعرّف كاسم مختصر، والاسم، والنص بوصفه doc
نوع المتطلبrequirement def، مع سمة واحدة لكل سمة ReqIF
نوع بيانات تعدادenum def
سمة الحالة (Draft وProposed وApproved وما إلى ذلك)حالة المتطلب في Holarch
عنوان فصلpackage برقم الفصل كاسم مختصر
متطلب متداخلrequirement متداخل
علاقة derived fromاتصال اشتقاق
علاقة refinesتبعية مع التعليق التوضيحي Refinement
satisfies وverified by وعلاقات أخرىتبعية (يذكر التقرير السبب)
مواصفةpackage داخل حزمة الملف

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

استيراد نسخة أحدث من الملف: استوردها إلى المشروع نفسه. يجد Holarch حزمة الاستيراد السابق ويقارن متطلبًا متطلبًا:

  • تحتفظ المتطلبات بمعرّفات عناصرها، فتبقى المخططات وروابط satisfy وverify والمراجعات والسجل مرتبطة بها. وتُحدَّث المتطلبات المعاد تسميتها والمنقولة في مكانها.
  • تُحفظ المتطلبات المفقودة من الملف الجديد. حدّد إزالة N متطلبات مفقودة من هذا الملف لنقلها إلى سلة المحذوفات.
  • تُحفظ الأجزاء وحالات التحقق والروابط التي أضفتها في Holarch.
  • المتطلب الذي تغيّر في Holarch فقط يحتفظ بتغييرك. والمتطلب الذي تغيّر هنا وفي الملف معًا يأخذ نص الملف؛ ويبقى النص السابق في السجل. وتدرج المعاينة هذه تحت متغير هنا وفي الملف.

التصدير بصيغة ReqIF:

  1. تحت تصدير، اختر حزمة أو النموذج كله، وReqIF (.reqif) أو أرشيف ReqIF (.reqifz).
  2. انقر تصدير. ويقول الإشعار “صُدّرت N متطلبات كـ <file>.”

يصدّر تصدير… ← المتطلبات (ReqIF) في قاعدة البيانات أو صفحة المتطلبات المتطلبات المدرجة (أو المحددة) بالطريقة نفسها.

يحوي الملف الاسم المختصر لكل متطلب (بوصفه ReqIF.ForeignID)، واسمه، وdoc (بصيغة XHTML)، وحالته وقيم سماته، والتسلسل الهرمي للحزم بوصفه المواصفة، وعلاقات الاشتقاق والتنقيح والتبعية. وتحتفظ المتطلبات المستوردة من ReqIF بمعرّفاتها وأنواعها وأنواع علاقاتها الأصلية، فتحدّث الأداة المصدر متطلباتها بدل إضافة نسخ؛ وتصدير الملف واستيراده مجددًا يُظهر كل حزمة دون تغيير. وتُكتب قيم السمات المحسوبة نصًا. وتبقى روابط satisfy وverify في Holarch: فلا أجزاء ولا حالات تحقق في ReqIF.

السحب من مستودع والدفع إليه

اربط المشروع بفرع واحد من مستودع نماذج SysML v2 لقراءة أحدث إيداع فيه وإرسال تغييراتك إليه.

  1. افتح النموذج ← الاستيراد والتصدير وابحث عن قسم المستودع.
  2. أدخل عنوان المستودع (عنوان https لـ Systems Modeling API الخاصة به)، ورمز الوصول إن كان المستودع يحتاج إليه.
  3. انقر تحميل المشاريع، ثم اختر المشروع وفرع. ولبدء مشروع مستودع جديد من هذا النموذج، انقر مشروع مستودع جديد بدلًا من ذلك.
  4. انقر سحب…. يقرأ Holarch أحدث إيداع في الفرع ويدرج كل فرق: جديد أو متغير أو محذوف أو تعارض. وترى “محدَّث: لا تغييرات في المستودع.” حين لا يوجد ما يُسحب.
  5. ألغِ تحديد الفروق التي لا تريدها، ثم انقر تطبيق السحب. ويُلغي تراجع واحد السحب كله.
  6. بعد أن تغيّر النموذج، انقر دفع. تذهب تغييراتك منذ آخر إيداع مُزامَن إلى الفرع كإيداع جديد واحد. وترى مثلًا “دُفعت 3 متغيرة كإيداع 1a2b3c4d.”

التعارض عنصر تغيّر هنا وفي المستودع معًا منذ آخر مزامنة. والتعارض غير المحدد يحتفظ بنسخة هذا المشروع.

ملاحظة: يُرفض الدفع حين يضم الفرع إيداعات لم يسحبها هذا المشروع: “يضم فرع المستودع إيداعات لم يسحبها هذا المشروع. اسحب أولًا، ثم ادفع مجددًا.”

مثال تطبيقي: المشروع التوضيحي Hybrid Car

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

  1. افتح النموذج ← الاستيراد والتصدير. تحت تصدير، اختر النموذج كله ونص SysML v2، ثم انقر تصدير.

    يُنزَّل ملف zip فيه ملف لكل حزمة ذات مستوى أعلى، مثل Vehicles.sysml وVehicleRequirements.sysml وVehicleBehavior.sysml وVehicleViews.sysml.

  2. افتح VehicleRequirements.sysml في محرر نصوص. غيّر attribute maxCurbMass : MassValue = 1650 [kg]; إلى 1600 [kg] واحفظ.
  3. بالعودة إلى الاستيراد والتصدير، اختر إلى هذا المشروع وأفلت VehicleRequirements.sysml.

    تُظهر المعاينة VehicleRequirements متغيرة، مع عدد العناصر المتغيرة. والحزم الأخرى ليست في الملف، فلا تُدرج.

  4. انقر استيراد حزمة واحدة.

    تتغير القيمة في النموذج. ويذكر المتطلب Sedan Mass (VR-1.1) maxCurbMass، فتُعلَّم روابطه للمراجعة (انظر المتطلبات والتحقق في مشاريع SysML v2). اضغط ⌘Z / Ctrl+Z للتراجع عن الاستيراد.

  5. لبدء مشروع ثانٍ من الملفات نفسها، اختر إلى مشروع SysML v2 جديد، وأفلت ملف zip وانقر إنشاء مشروع.

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

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

أخطاء شائعة

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

كيف يرتبط بالميزات الأخرى

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

صفحة الاستيراد والتصدير

استيراد

عنصر التحكمالاستخدام
إلى هذا المشروعدمج الملفات في المشروع المفتوح. غير متاح لمن يملكون عرض المشروع فقط؛ فلهم تنشئ عمليات الاستيراد مشروعًا جديدًا.
إلى مشروع SysML v2 جديدإنشاء مشروع جديد من الملفات.
منطقة الإفلات“أفلت الملفات هنا أو انقر لاختيارها”. تقبل ملفات .sysml، أو ملف .zip من ملفات .sysml، أو ملف SysML v2 JSON واحدًا.
جدول المعاينةاستيراد (مربع تحديد)، والحزمة (الاسم والنوع)، والعناصر (العدد)، والنتيجة (جديدة أو متغيرة أو دون تغيير أو تعارض، مع تفصيل).
اسم المشروع(للمشروع الجديد فقط) اسم المشروع الجديد، حتى 200 حرف.
استيراد N حزم / إنشاء مشروعتطبيق الاستيراد.
إلغاءإغلاق المعاينة دون استيراد.

تُدرج العناصر الواقعة خارج أي حزمة في نص .sysml معًا في صف واحد، هو خارج الحزم.

عندما يتغير النموذج والمعاينة مفتوحة (علامة تبويب أخرى، أو متعاون، أو تراجع)، تُحسب المعاينة مجددًا.

تصدير

عنصر التحكمالاستخدام
تصدير (النطاق)النموذج كله، أو أي حزمة باسمها المؤهل.
بصيغة (الصيغة)نص SysML v2 (.sysml؛ أو .zip لعدة حزم) أو SysML v2 JSON (.json).
تضمين معرّفات العناصر(للنص فقط؛ معطّل افتراضيًا) كتابة معرّف كل عنصر مسمّى في النص بصيغة @HolarchMetadata::ElementId { id = "…"; }، لتحتفظ النسخة المعدّلة المستوردة مجددًا بالمعرّفات عبر إعادة التسمية والنقل.
تصديرتنزيل الملف.

يكتب تصدير النص ملفًا لكل حزمة ذات مستوى أعلى، مسمّى باسمها (Vehicles.sysml). وتذهب العناصر الواقعة خارج الحزم إلى Outside packages.sysml. ويكتب تصدير JSON ملفًا واحدًا مسمّى باسم المشروع أو الحزمة.

المستودع

يربط قسم المستودع المشروع بفرع واحد من مستودع يوفر Systems Modeling API.

  • عنوان المستودع: عنوان https لواجهة API الخاصة بالمستودع. لا يتصل Holarch إلا بعناوين https على مضيفين عامين؛ ويمكن لمسؤولي الموقع تقييد المضيفين والمنافذ.
  • رمز الوصول: يُخزَّن مشفّرًا لحسابك ولهذا المشروع، ولا يُرسل إلا إلى ذلك العنوان. ولا يُعرض مجددًا أبدًا؛ اترك الحقل فارغًا للإبقاء على الرمز المخزّن.
  • تحميل المشاريع والمشروع وفرع: اختر مكان المزامنة. وينشئ مشروع مستودع جديد مشروعًا في المستودع لهذا النموذج.
  • سحب… وتطبيق السحب: قراءة أحدث إيداع، ومراجعة الفروق وتطبيقها، ويُلغي تراجع واحد ذلك كله. يقارن Holarch مع الإيداع الذي زامنه آخر مرة، فيميّز تغييراتك من تغييرات المستودع.
  • دفع: إرسال التغييرات منذ آخر إيداع مُزامَن كإيداع واحد. وتعني “لا شيء للدفع: يطابق النموذج آخر إيداع مُزامَن.” أنه لا جديد.
  • يغيّر الإعدادات… الاتصال. ويزيل قطع الاتصال الرمز المخزّن وحالة المزامنة؛ ويبقى النموذج.
  • تحتاج عمليات المستودع إلى دور المحرر. ولا يستطيع المشاهدون السحب أو الدفع.
  • يُرفض الدفع للمشاريع ذات علامات البيانات الخاضعة للتنظيم.

كيف تُقرأ الملفات

  • تُفحص الملفات قبل قراءة أي شيء: أحجامها وأعدادها وتداخلها وأطوال نصوصها.
  • في ملف zip، تُتجاهل الملفات المخفية ومجلدات __MACOSX. وتُتخطى الروابط والملفات غير .sysml والنسخة الثانية من المسار نفسه، وتذكر قائمة المشكلات السبب.
  • يجب أن يكون النص UTF-8. ويُسمح بعلامة ترتيب البايتات.
  • يُفحص كل عنصر مستورد قبل كتابته. والعنصر المرفوض يأخذ معه أعضاءه المملوكة؛ وتعدّها قائمة المشكلات.
  • في JSON، تُحفظ العناصر من أنواع لا يفسّرها Holarch كما استُوردت: انظر العناصر التي لا يفسّرها Holarch.

العناصر التي لا يفسّرها Holarch

يمكن أن يحوي SysML v2 JSON أنواع عناصر لا ينمذجها Holarch، مثل سلوكيات KerML أو خطواتها أو تفاعلاتها. ويحتفظ بها Holarch بدل استبعادها:

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

لا يُحفظ: فضاء الأسماء الجذري غير المسمّى الذي تلف فيه بعض الأدوات تصديرًا كاملًا (يصير أعضاؤه عناصر ذات مستوى أعلى)، والعناصر غير المدعومة داخل قيمة، وهي تُدرج كمشكلات. والعنصر الذي يزيد JSON الخاص به على 256 KB لا يحتفظ إلا بنوعه ومعرّفه.

الرسائل

الرسالةالمعنى والحل
اختر ملفات .sysml، أو ملف .zip من ملفات .sysml، أو ملف SysML v2 JSON.لم تُختر أي ملفات.
لم يُعثر على ملفات .sysml. اختر ملفات .sysml، أو ملف .zip من ملفات .sysml، أو ملف SysML v2 JSON.لا يحوي الأرشيف أو التحديد ملفات .sysml.
استورد ملف SysML v2 JSON واحدًا في كل مرة، دون ملفات .sysml.اختيرت عدة ملفات JSON، أو JSON مختلط بنص.
<file> ليس ملف ReqIF (…). صدّره من الأداة المصدر بصيغة ReqIF 1.0 أو أحدث واستورده مجددًا.الملف ليس ReqIF XML، أو يحوي DOCTYPE، وهو ما لا يقرؤه Holarch.
لا يحوي <file> أي متطلبات (لا عناصر SPEC-OBJECT). صدّر المواصفات مع كائناتها واستورد الملف مجددًا.في ملف ReqIF أنواع ولكن لا متطلبات.
في <title> N متطلبات، أكثر مما يأخذه استيراد واحد (نحو M). صدّر المواصفات كملفات ReqIF منفصلة.سيتجاوز نص SysML v2 حد 8 MB. استورد المواصفات ملفًا واحدًا في كل مرة.
<file> ليس نصًا بترميز UTF-8. احفظه بترميز UTF-8 واستورده مجددًا.حوّل ترميز الملف.
<file> ليس أرشيف ZIP صالحًا. أنشئ الأرشيف مجددًا.الأرشيف تالف.
يحوي <file> ملفات مشفّرة. أنشئ الأرشيف دون كلمة مرور.لا تُقرأ الأرشيفات المحمية بكلمة مرور.
<path> مضغوط بأكثر من 200:1، وهو أمر نموذجي لقنبلة zip. أنشئ الأرشيف مجددًا.رُفض الأرشيف حفاظًا على السلامة.
يستخدم الأرشيف طريقة ضغط غير مدعومة. أنشئه بضغط ZIP القياسي.استخدم الضغط القياسي (deflate).
لا تُستورد ملفات KerML بعد.تُتخطى ملفات .kerml.
لا تُستورد من الأرشيف إلا ملفات .sysml.تُتخطى الملفات الأخرى في ملف zip.
لا تُستورد الروابط.تُتخطى الروابط الرمزية في ملف zip.
يحوي الأرشيف هذا الملف مرتين؛ تُستورد النسخة الأولى.لإدخالين المسار نفسه.
<file> ليس JSON صالحًا. صدّر النموذج مجددًا.ملف JSON تالف.
<file> ليس SysML v2 JSON (قائمة عناصر بـ @id و@type). اختر تصدير SysML v2 JSON.JSON بصيغة أخرى.
السطر N من <file> أطول من 64 KB. قسّم السطر، ثم استورد الملف مجددًا.تُرفض الأسطر الطويلة جدًا.
هذا العضو لا يُحلَّل ويُستبعد.أصلح السطر المذكور في قائمة المشكلات.
يقع عنصر بهذا المعرّف داخل <element> في هذا المشروع. انقله إلى المستوى الأعلى أولًا، أو استورد إلى مشروع جديد.(تعارض) الحزمة ذات المستوى الأعلى في JSON موجودة بالفعل في موضع أعمق من النموذج.
تُستخدم N من معرّفات عناصرها في مواضع أخرى من هذا المشروع. استورد إلى مشروع جديد بدلًا من ذلك.(تعارض) يعيد JSON استخدام معرّفات عناصر أخرى.
لا يُحلَّل نص الحزمة بعد طباعته. استورده إلى مشروع جديد.(تعارض) تعذّر دمج الحزمة.
تُحفظ N من عناصر <kind> كما استُوردت (غير مفسَّرة): …(ملاحظة) تُحفظ العناصر من نوع لا يفسّره Holarch دون تغيير. انظر العناصر التي لا يفسّرها Holarch.
عنصر من نوع <kind> داخل قيمة غير مدعوم ويُستبعد.تحوي قيمة (تعبير) عنصرًا لا يستطيع Holarch قراءته. ويُحفظ باقي القيمة نصًا.
عنصر من نوع <kind> أكبر من أن يُحفظ كاملًا؛ ولا يُحفظ إلا نوعه ومعرّفه.يزيد JSON الخاص به على 256 KB.
لم يُطبَّق الاستيراد: … لم يتغير شيء.فشل الاستيراد؛ والمشروع دون تغيير.
النموذج فارغ. أضف حزمة، ثم صدّر مجددًا.لا يوجد ما يُصدَّر.
لم تعد الحزمة المراد تصديرها موجودة. اختر حزمة أخرى.حُذفت الحزمة والصفحة مفتوحة.

الحدود

الحدالقيمة
الملفات لكل استيراد2,000
نص .sysml لكل استيراد (بعد فك الضغط)8 MB
أرشيف zip16 MB، و10,000 إدخال
تداخل المجلدات في ملف zip32 مجلدًا
العناصر لكل استيراد (نص أو JSON)100,000
ملف JSON24 MB، وتداخل حتى 64 مستوى
JSON لعنصر واحد لا يفسّره Holarch256 KB، وتداخل حتى 12 مستوى
طول السطر64 KB
ملف ReqIF (.reqif، أو .reqif داخل .reqifz)64 MB؛ ويجب أن يتسع نص SysML v2 الناتج عنه لحد النص البالغ 8 MB (نحو 8,000 إلى 20,000 متطلب)
  • تُحدّ ردود المستودع بـ 64 MB لعملية سحب كاملة، وتتوقف كل عملية مستودع بعد 120 ثانية.
  • يمكن لكل حساب تشغيل 300 عملية مستودع على الأكثر في الساعة.
  • لا تُستورد ملفات KerML (.kerml) بعد.
  • في التطبيق المستضاف، يقرأ الخادم عمليات الاستيراد حتى 1.5 MB من نص .sysml. وتُقرأ عمليات الاستيراد الأكبر في متصفحك، بالنتيجة نفسها.
  • بيانات Holarch المجاورة للنموذج (حالة المتطلبات والمخاطر والميزانيات وإعدادات المحاكي وتخطيطات العروض) ليست جزءًا من ملفات .sysml أو JSON. استخدم تصدير هذا المشروع… في إدارة المشاريع للاحتفاظ بها.

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