Holarch

SysML v2

محرر النص والمستعرض

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

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

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

نظرة عامة

يعدّل المحرر (النموذج ← المحرر) نموذج SysML v2 كنص. ويعرض المستعرض (النموذج ← المستعرض) النموذج نفسه كشجرة من الحزم وأعضائها.

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

المفاهيم

المستندات النصية

يعرض المحرر مستندًا نصيًا واحدًا لكل حزمة على المستوى الأعلى. وتبدّل قائمة الحزم على اليمين بينها. والعناصر على المستوى الأعلى التي ليست في حزمة تتشارك مستندًا إضافيًا واحدًا، هو خارج الحزم.

لا يحتوي المشروع على ملفات: فالمستندات تُطبع من النموذج. وللحصول على ملفات .sysml، صدّر النموذج (انظر تبادل نماذج SysML v2).

تطبيق النص على النموذج

لا تغيّر الكتابة في البداية إلا النص. ويُطبَّق النص على النموذج عند نقطة إيداع:

  • عندما تتوقف عن الكتابة لحظة (نحو 0.6 s)؛
  • عندما تغادر المحرر؛
  • عندما تضغط ⌘S / Ctrl+S أو ⌘↩ / Ctrl+Enter.

يمكن التراجع عن كل إيداع بتراجع واحد. يقارن Holarch النص بالنموذج ولا يغيّر إلا ما يختلف، فتحتفظ العناصر بهويتها. ويبقى العنصر المعاد تسميته العنصرَ نفسه: تتبعه مواضعه في العروض وتعليقاته وتتبعاته وروابطه.

الأخطاء والمسودات

لا يضيع النص الذي فيه خطأ. تُطبَّق الأعضاء التي تُحلَّل بنجاح؛ أما العضو الذي فيه خطأ فـلا يُطبَّق ويحتفظ بآخر حالة سليمة له في النموذج. ويذكر سطر الحالة لم يُطبَّق: أصلح السطر N.

يبقى النص الذي لم يُطبَّق بعد مسودة في هذا المتصفح حتى يُحلَّل بنجاح. وعندما تفتح الحزمة مجددًا، يقول شريط يحتوي هذا النص على تغييرات من <date> لم تُطبَّق على النموذج. أصلح النص لتطبيقه، أو انقر تجاهل المسودة للعودة إلى نص النموذج.

لا تُحفظ المسودات إلا في المتصفح الذي كتبتها فيه. ويرى الآخرون آخر حالة سليمة للنموذج.

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

فتح نص حزمة

  1. افتح النموذج ← المحرر. تُفتح الحزمة الأولى. وإذا لم يكن في النموذج حزم، فانقر + حزمة جديدة.
  2. انقر حزمة في قائمة الحزم لفتح نصها.
  3. للانتقال إلى عنصر، استخدم إظهار في النص في المستعرض أو لوحة الخصائص أو عرض. يفتح المحرر حزمته ويحدّد تصريحه.

تعديل النص وتطبيقه

  1. اكتب كما في أي محرر شيفرة. يحافظ Enter على المسافة البادئة ويزيدها بعد {؛ وكتابة } تحاذيه مع سطر فتحه.
  2. توقف عن الكتابة. يُظهر سطر الحالة تحت النص لم يُطبَّق بعد، ثم جارٍ التطبيق…، ثم مُطبَّق. ويُظهر المستعرض والعروض والصفحات التغيير الآن.
  3. اضغط ⌘Z / Ctrl+Z للتراجع عن الكتابة. وعندما لا يبقى في المحرر كتابة للتراجع عنها، يتراجع ⌘Z / Ctrl+Z عن آخر تغيير في المشروع، كما في أي مكان آخر في Holarch.

يُظهر التغيير الذي يعيد تنسيق النص فقط لا تغييرات في النموذج.

إدراج بنية

يكتب إدراج ▾ بنية SysML نيابةً عنك، مثل جزء مع نوعه وتعدديته.

  1. ضع المؤشر على سطر فارغ في الجسم الذي تنتمي إليه البنية.
  2. انقر إدراج ▾ في ترويسة الصفحة، أو اضغط ⌃⇧Space / Ctrl+Shift+Space. لا تعرض القائمة إلا البنى التي تناسب موضع المؤشر، في أربع مجموعات: البنية والسلوك والمتطلبات وأخرى. وتذكر ترويستها أين أنت، مثلًا مستوى الحزمة أو داخل تعريف جزء.
  3. اكتب لتصفية القائمة. تُظهر المعاينة النص وما يعنيه.
  4. اضغط Enter (أو انقر) لإدراجها في سطر مستقل.
  5. اكتب فوق الحقل المحدّد (اسم أو نوع أو تعددية)، ثم اضغط Tab للحقل التالي. ويعود ⇧Tab / Shift+Tab إلى الخلف. وتدرج حقول النوع تعريفات النموذج: اضغط Enter (أو اختر بـ↑ ↓) لأخذ واحد؛ ويحتفظ Tab بما كتبته.
  6. اضغط Tab بعد الحقل الأخير، أو Esc، لمغادرة المقتطف. وتُطبَّق البنية على النموذج.

يقدّم الإكمال المقتطفات نفسها: كتابة par تقدّم الكلمة المفتاحية part والمقتطف جزء.

إكمال الأسماء والكلمات المفتاحية

  1. اكتب حرفين من اسم أو كلمة مفتاحية، أو :: أو . بعد اسم. أو اضغط ⌃Space / Ctrl+Space. تقدّم قائمة الكلمات المفتاحية والأسماء والمقتطفات التي تناسب موضع المؤشر.
  2. تنقّل بـ↑ و↓ (يقفز PageUp وPageDown 8 صفوف).
  3. اضغط Enter أو Tab للقبول، أو Esc لإغلاق القائمة. والقائمة التي فُتحت أثناء كتابتك تُغلق أيضًا بعد 4 ثوانٍ دون ضغط مفتاح، أو عندما يكتمل الاسم، أو عندما لا يطابق شيء، أو عندما تنقل المؤشر بعيدًا أو تغادر المحرر.

الانتقال إلى تعريف وإعادة التسمية

  1. أشر إلى اسم لترى بطاقة بنوعه واسمه المؤهل وتوثيقه، وأي مشكلة فيه. ويُظهر ⌘I / Ctrl+I البطاقة نفسها من لوحة المفاتيح. وتُغلق البطاقة عندما تعدّل أو تضغط Esc أو تمرّر أو تغادر المحرر أو تبعد المؤشر، ولا تغطي قائمة الإكمال أبدًا.
  2. انقر اسمًا مع ⌘ / Ctrl، أو اضغط F12، للانتقال إلى تصريحه. والتصريح في حزمة أخرى يفتح تلك الحزمة.
  3. لإعادة التسمية، ضع المؤشر على اسم مُصرَّح به واضغط F2. أدخل الاسم الجديد وأكّد. يتغير كل مرجع إليه، في كل حزمة، ويُلغي تراجع واحد ذلك كله. ويقول الإشعار أُعيدت التسمية إلى “name”.

البحث والاستبدال

  1. اضغط ⌘F / Ctrl+F أو انقر بحث في ترويسة الصفحة.
  2. اكتب النص المراد البحث عنه. يُظهر الشريط n من m تطابقات.
  3. شغّل Aa (مطابقة حالة الأحرف) أو W (الكلمة كاملة) أو .* (تعبير نمطي) حسب الحاجة.
  4. اضغط Enter أو ⌘G / Ctrl+G للتطابق التالي، و⇧Enter / Shift+Enter أو ⇧⌘G / Ctrl+Shift+G للسابق.
  5. انقر استبدال…، واكتب البديل، ثم استبدال (هذا التطابق) أو استبدال الكل.
  6. اضغط Esc أو انقر ✕ لإغلاق الشريط.

إصلاح الأخطاء

  1. انظر إلى سطر الحالة: فهو يعدّ المشكلات، مثلًا خطآن، تحذير واحد، أو يقول لا مشكلات.
  2. اضغط F8 للانتقال إلى المشكلة التالية (⇧F8 / Shift+F8: السابقة). أو انقر علامة في الهامش. تُحدَّد المشكلة وتظهر رسالتها: المشكلة أولًا، ثم الإصلاح.
  3. أصلح النص. وعندما يُحلَّل العضو بنجاح، يُطبَّق.

تصفّح شجرة النموذج

  1. افتح النموذج ← المستعرض.
  2. انقر ▸ بجانب حزمة لفتحها، أو انقر توسيع الكل.
  3. اكتب في التصفية حسب الاسم، أو اختر نوعًا مثل part def في كل الأنواع. تُظهر الشجرة التطابقات مع مالكيها. ويُظهر العدد n من N عنصر.
  4. حدّد عنصرًا لترى تفاصيله في لوحة الخصائص.
  5. انقره نقرًا مزدوجًا، أو اضغط Enter، لإظهاره في المحرر.

حذف العناصر واستعادتها

  1. في المستعرض، افتح قائمة الصف (⋯، أو النقر بزر الماوس الأيمن أو Shift+F10) واختر حذف…. أكّد. ينتقل العنصر وأعضاؤه إلى سلة المحذوفات في المشروع. وحذف النص في المحرر له الأثر نفسه.
  2. لإعادته، افتح أداة سلة المحذوفات في أسفل الشريط وانقر استعادة في صفه. يعود بالهوية نفسها، فتُحلّ المراجع إليه مجددًا.

مثال تطبيقي: إضافة مستشعر عجلة إلى Hybrid Car

يستخدم هذا المثال المشروع التوضيحي Hybrid Car (SysML v2).

  1. افتح النموذج ← المحرر وانقر Vehicles في قائمة الحزم.
  2. ابحث عن part def Wheel :> Component. ضع المؤشر على سطر فارغ جديد داخل جسمه، بعد port hub : ~TorquePort;.
  3. اضغط ⌃⇧Space / Ctrl+Shift+Space. تقول الترويسة داخل تعريف جزء. اكتب att واضغط Enter لإدراج سمة.
  4. اكتب speedSensorMass فوق حقل الاسم، واضغط Tab، واكتب MassValue فوق حقل النوع واضغط Tab مجددًا لمغادرة المقتطف. يصبح السطر attribute speedSensorMass : MassValue; ويُطبَّق.
  5. اكتب = 0.2 [kg] قبل ; وتوقف عن الكتابة. يذكر سطر الحالة مُطبَّق.
  6. افتح النموذج ← المستعرض، واكتب speedSensor في التصفية حسب الاسم. تظهر السمة تحت Vehicles › Wheel؛ وتُظهر لوحة خصائصها المالك Wheel ومنمَّط بـ MassValue.
  7. عُد إلى المحرر، واضغط F2 على speedSensorMass، وأدخل sensorMass وأكّد. يُظهر المستعرض الاسم الجديد.
  8. احذف السطر وتوقف. تنتقل السمة إلى سلة المحذوفات؛ استعدها هناك بـاستعادة.

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

  • الحفظ تلقائي. لا يفعل ⌘S / Ctrl+S سوى تطبيق النص الآن؛ فلا يوجد شيء آخر يُحفظ.
  • خطأ واحد لا يمنع الباقي. تبقى الأعضاء التي قبل العضو المعطوب وبعده تُطبَّق.
  • الكتابة فوق تغييرات زميل. إذا تغيّر النموذج أثناء كتابتك، يدمج Holarch نصك مع النموذج الجديد. وعندما يغيّر كلاكما العضو نفسه، اختر الإبقاء على نسختي أو أخذ نسختهم.
  • إعادة التسمية بإعادة الكتابة. تغيير اسم في مكانه يحتفظ أيضًا بالعنصر (يطابقه Holarch بالموضع والنوع)، لكن المراجع في أماكن أخرى تبقى تستخدم الاسم القديم ولا تعود تُحلّ. استخدم F2 لإعادة التسمية في كل مكان.
  • حذف عنصر مستخدَم. عندما يزيل نص محذوف عنصرًا تستخدمه عناصر أو عروض أخرى، يسأل Holarch أولًا. ألغِ للإبقاء عليه؛ ويبقى النص عندئذٍ غير مُطبَّق حتى تضغط ⌘S / Ctrl+S لتقرر مجددًا.
  • عند حد العناصر. عندما يضيف النص عناصر من شأنها أن تتجاوز بالمشروع حد العناصر في خطته، لا يُطبَّق شيء من ذلك التغيير. ويبقى النص مسودة ويذكر سطر الحالة لم يُطبَّق: سيتجاوز المشروع حده البالغ 1,000 عنصر. أزل التصريحات الجديدة أو احذف العناصر غير المستخدمة. في مشروع SysML v2، العناصر هي عناصر النموذج عدا العلاقات: تُحتسب الحزم والتعريفات والاستخدامات (الأجزاء، والسمات، والمراجع، والمنافذ، والإجراءات، والحالات، والمتطلبات، …)؛ ولا تُحتسب العلاقات (الاستيرادات وعمليات الكشف، والاتصالات، والواجهات، والتدفقات، والروابط، والتعاقبات، والانتقالات، والتخصيصات، وsatisfy وverify، والتبعيات، والتصنيفات الفرعية، والتنميطات، والمجموعات الفرعية، وإعادات التعريف). يحتوي المشروع التوضيحي Hybrid Car على 549 عنصرًا ومشروع Earth Observation Satellite التوضيحي على 1,549 عنصرًا، لذا في خطة Free يوقف مشروع توضيحي جديد إدخال Earth Observation Satellite مع “يحتاج إلى خطة Individual (1,549 عنصرًا)”. انظر الخطط والحدود.

المحرر

التخطيط

  • الحزم (على اليمين): إدخال واحد لكل حزمة على المستوى الأعلى، إضافةً إلى خارج الحزم عند الحاجة. والرقم بعد الحزمة المفتوحة يعدّ أخطاءها. وفي المشروع المشترك، تُظهر الأحرف الأولى من الأسماء من غيرك يفتح حزمة.
  • ترويسة الصفحة: + حزمة جديدة وإدراج ▾ وبحث.
  • منطقة النص: تمييز بناء الجملة، وأرقام الأسطر، وهامش بعلامات المشكلات. انقر رقم سطر لتحديد السطر؛ وانقر علامة لتحديد المشكلة وإظهار رسالتها.
  • سطر الحالة (تحت النص): موضع المؤشر (Ln 12, Col 5)، وعدد المشكلات، وحالة التطبيق.

يرى المشاهدون النص للقراءة فقط.

بنى إدراج ▾

المجموعةالتراكيب
البنيةحزمة، تعريف جزء، جزء، سمة، تعريف سمة، تعريف منفذ، منفذ، واجهة، اتصال، تعريف تخصيص، تخصيص، عنصر متدفق، تعداد، تباين، متغير، التكوين، اختيار المتغير
السلوكتعريف إجراء، إجراء، تعاقب، تعريف حالة، حالة، انتقال، تدفق، إجراء Then، تنفيذ، تفرّع، قرار، ضمّ، دمج، قبول، إرسال، تعيين، إذا، حلقة While، حلقة For، إجراءات الحالة، الحالة الأولية، انتقال قبول، تعريف حالة متوازية، إظهار حالة، رسالة
المتطلباتتعريف متطلب، متطلب، قيمة TBD، قيمة TBR، تعريف تحقق، استيفاء، تحقق، قيد، حساب، الموضوع، فاعل، صاحب مصلحة، افتراض، حالة استخدام، حالة تحليل، اهتمام، وجهة نظر، عرض
أخرىاستيراد، اسم بديل، تعليق، التوثيق

لا تُقدَّم كل بنية إلا حيث تكون صالحة. تحتاج قيمة TBD وقيمة TBR إلى private import HolarchMetadata::*; في الحزمة (انظر وضع علامة TBD أو TBR على قيمة). ولا يُقدَّم متغير إلا داخل تباين، لا يحتوي إلا على متغيراته. ويكتب التكوين استخدامًا معلَّمًا بـ@HolarchConfiguration ويحتاج إلى private import HolarchVariability::*;؛ وداخله، يختار اختيار المتغير متغير نقطة تباين واحدة (انظر التباينات والمتغيرات والتكوينات).

اختصارات لوحة المفاتيح

في Windows وLinux، استخدم Ctrl مكان ⌘. / Ctrl+.

المفاتيحالفعل
⌘S / Ctrl+S أو ⌘↩ / Ctrl+Enterتطبيق النص الآن
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Zتراجع / إعادة (يعيد Ctrl+Y أيضًا في Windows وLinux)
⌃Space / Ctrl+Spaceالإكمال عند المؤشر
⌃⇧Space / Ctrl+Shift+Spaceفتح إدراج ▾
Tab / ⇧Tab / Shift+Tabزيادة المسافة البادئة / إنقاصها؛ وفي المقتطف، الحقل التالي / السابق
Esc، ثم Tabمغادرة المحرر (وإلا فإن Tab يزيد المسافة البادئة)
⌘/ / Ctrl+/تعليق الأسطر المحدّدة أو إلغاء تعليقها بـ//
⌘F / Ctrl+Fالبحث؛ ويفتحه ⌥⌘F / Ctrl+Alt+F مع الاستبدال
⌘G / Ctrl+G أو F3 / ⇧⌘G / Ctrl+Shift+Gالتطابق التالي / السابق
F8 / ⇧F8 / Shift+F8المشكلة التالية / السابقة
F12 أو النقر مع ⌘ / Ctrlالانتقال إلى التصريح
F2إعادة تسمية الاسم عند المؤشر في كل مكان
⌘I / Ctrl+Iإظهار بطاقة المعلومات عند المؤشر

النص والعروض يبقيان متزامنين

النص والعروض والجداول ولوحة الخصائص كلها طرق لتعديل نموذج واحد.

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

لا تُكتب بيانات Holarch (الحالة، والنتائج، والتسميات، والتخطيطات، وإعدادات المحاكي) في النص أبدًا. انظر بيانات النموذج وبيانات Holarch.

العمل مع الآخرين

في المشروع المشترك، يمكن لعدة أشخاص تعديل النموذج في الوقت نفسه.

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

المستعرض

يعرض المستعرض النموذج كشجرة: الحزم على المستوى الأعلى، ثم أعضاؤها بالترتيب.

ترويسة الصفحة والمرشحات

  • يفتح توسيع الكل وطيّ الكل كل عنصر أو يغلقانه. ويتذكر المستعرض ما هو مفتوح في هذا المتصفح.
  • يطابق التصفية حسب الاسم الأسماء والأسماء المختصرة.
  • يقصر كل الأنواع الشجرة على نوع واحد، مثل part def أو requirement أو port. ولا تُدرج إلا الأنواع الموجودة في النموذج. ويُظهر الأفراد (المُدرج عندما يحتوي النموذج على أفراد) كل عنصر مُصرَّح به individual، من أي نوع.
  • مع مرشح، تُظهر الشجرة التطابقات مع مالكيها، مفتوحة كلها. ويُظهر العدد n من N عنصر.

الصفوف

يُظهر كل صف نوع العنصر واسمه واسمه المختصر بين قوسين زاويين (<VR-1.1>). وتظهر العناصر التي لا اسم لها بصيغة (نوع بلا اسم)، مثلًا (succession بلا اسم)، مع هذه الاستثناءات:

  • التصريح المكتوب بكلمة مفتاحية للمستخدم فقط يُظهر الكلمة المفتاحية نوعًا له، مثلًا #fault def لـ#fault def BatteryOverheat;.
  • مُشغِّل الانتقال وتأثيره عضوان في الانتقال. ويظهران بوصفهما trigger وeffect، مسمّيَين بنصهما، مثلًا trigger StartRequest.
  • يظهر إجراء الإنهاء غير المسمّى بوصفه terminate، أو terminate drive عندما يسمّي ما ينهيه.
  • تُظهر الأفراد واللقطات والشرائح الزمنية كلماتها المفتاحية مع النوع، مثلًا individual part def أو snapshot أو timeslice part، بعد أيقونة: حلقة للفرد، ونقطة على خط زمني للّقطة، وشريط على خط زمني للشريحة الزمنية.

لوحة الخصائص

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

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

تُكتب التعديلات في النموذج، ويُلغي تراجع واحد كل تعديل منها. انظر ميزات Holarch.

قائمة الصف

افتحها بـ⋯ في الصف، أو بالنقر بزر الماوس الأيمن، أو Shift+F10، أو مفتاح قائمة السياق، أو F2.

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

لوحة المفاتيح

المفاتيحالفعل
↑ / ↓الصف السابق / التالي
Home / Endالصف الأول / الأخير
→فتح العنصر، أو الانتقال إلى أول عضو فيه
←إغلاق العنصر، أو الانتقال إلى مالكه
Enterإظهار في النص
F2, Shift+F10فتح قائمة الصف

العناصر التي لا تُفسَّر

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

العناصر في غير موضعها

العنصر الذي فُقد مالكه، مثلًا بعد أن حذف زميل حزمته في اللحظة نفسها، يُدرج تحت في غير موضعها (المالك مفقود): انقلها إلى حزمة. وتُظهر الرئيسية بطاقة العناصر في غير موضعها أيضًا. افتح العنصر في المحرر وانقل نصه إلى حزمة.

العناصر المحذوفة

حذف عنصر في مشروع SysML v2 ينقله إلى سلة المحذوفات في المشروع. ويأخذ معه كل ما يملكه، والاتصالات وعلاقات الاستيفاء التي تسمّيه، وتخطيطاته في العروض وتعليقاته.

  • افتح أداة سلة المحذوفات في أسفل الشريط. يُظهر كل صف نوع العنصر واسمه ووقت حذفه والسبب (حُذف مع 3 أعضاء) ومدة الاحتفاظ به.
  • يعيده استعادة بالهوية نفسها، فتُحلّ المراجع إليه مجددًا. ويستعيد استعادة الكل كل الإدخالات.
  • يُظهر ⋯ ← معاينة نوعه واسمه المختصر وتوثيقه وأعضاءه والعناصر التي لا تزال تشير إليه (مُشار إليه من).
  • يزيل ⋯ ← حذف نهائي… إدخالًا واحدًا فورًا. ويزيلها إفراغ سلة المحذوفات كلها. ويمكن التراجع عن كليهما بـ⌘Z / Ctrl+Z.
  • تُزال الإدخالات تلقائيًا بعد 30 يومًا.

عندما يزيل نص محذوف عنصرًا لا يزال مستخدمًا، يسأل المحرر أولًا: تستخدم <n> مراجع و<m> عروض <name>. هل تريد حذفه؟

إمكانية الوصول

يعمل المحرر والمستعرض بلوحة المفاتيح وحدها ومع قارئ الشاشة.

  • المحرر مربع نص ذو تسمية. يزيد Tab المسافة البادئة؛ ولمغادرة المحرر، اضغط Esc، ثم Tab.
  • ينتقل F8 وShift+F8 إلى المشكلة التالية والسابقة ويقرآنها مع سطرها. وتُعلَن المشكلات أيضًا بعد نحو ثانية من تغيّرها.
  • ينتقل F12 إلى التعريف، ويعيد F2 التسمية، ويبحث ⌘F / Ctrl+F، ويكمل Ctrl+Space ويفتح Ctrl+Shift+Space إدراج. والإكمال وإدراج قوائم تعلن الإدخال المحدّد. وفي المقتطف، يُعلَن كل حقل (“الحقل 1 من 3: name”).
  • المستعرض شجرة. يُقرأ كل صف باسمه ونوعه، مثل “Car، تعريف جزء”. وتتنقل مفاتيح الأسهم خلالها؛ ويفتح → حزمة ويغلقها ←. ويفتح Shift+F10 قائمة الصف.

الرسائل

الرسالةالمعنى والحل
لم يُطبَّق بعدأنت تكتب؛ ويُطبَّق النص عندما تتوقف.
مُطبَّق / لا تغييرات في النموذجالنص موجود في النموذج / كان النص مطابقًا للنموذج بالفعل.
لم يُطبَّق: أصلح السطر N.يحتوي عضو على خطأ. أصلح السطر N؛ ويُطبَّق باقي النص.
لم يُطبَّق: تغيّر النموذج أثناء كتابتك. اختر «الإبقاء على نسختي» أو «أخذ نسختهم».يمسّ نصك وتغيير آخر العضو نفسه.
لم يُطبَّق: أُلغي حذف <name>. اضغط ⌘S / Ctrl+S لتقرر مجددًا.رفضت حذفًا. استعد النص، أو اضغط ⌘S / Ctrl+S وأكّد.
توقف مدقق SysML. نصك محفوظ؛ وقد أُعيد تشغيله.أُعيد تشغيل المدقق. تابع الكتابة؛ فنصك في أمان.
الفحوص متوقفة مؤقتًا: توقف مدقق SysML مرتين. نصك محفوظ. اختر «إعادة المحاولة» في الإشعار، أو أعد تحميل الصفحة.توقف المدقق مرتين متتاليتين، عادةً لأن النموذج أكبر من أن يستوعبه، وهو متوقف مؤقتًا. اختر إعادة المحاولة في الإشعار، أو أعد تحميل الصفحة. انظر المدقق متوقف مؤقتًا.
ضع المؤشر على اسم لإعادة تسميته.ضُغط F2 على كلمة مفتاحية أو مسافة فارغة.
أصلح الأخطاء في هذا النص قبل إعادة التسمية.تحتاج إعادة التسمية إلى نص يُحلَّل بنجاح.
لا يمكن إعادة تسمية عناصر المكتبة. أعد تسمية أحد عناصرك.ينتمي الاسم إلى المكتبة القياسية.
التصريح موجود في المكتبة أو في ملف آخر ولا يمكن فتحه هنا.عثر الانتقال إلى التعريف على عنصر من المكتبة القياسية. ابحث عنه في صفحة المكتبة القياسية.
لم يُعثر على تصريح لـ“name”.لا يُحلّ الاسم. تحقق من إملائه أو من الاستيرادات.
لا يناسب <Snippet> هنا. انقل المؤشر إلى سطر فارغ في جسم يسمح به.البنية غير صالحة عند موضع المؤشر.
لا تناسب أي مقتطفات داخل تعليق أو سلسلة نصية. انقل المؤشر خارجه.فُتح إدراج ▾ داخل تعليق أو سلسلة نصية.
هذا النمط ليس تعبيرًا نمطيًا صالحًا. أصلحه، أو أوقف .*نمط البحث غير صالح مع تشغيل .*.
لا يحتوي هذا النموذج على حزم بعد. أنشئ حزمة لتبدأ كتابة SysML.انقر + حزمة جديدة.
لا يطابق أي عنصر. غيّر المرشح.لا يطابق مرشح المستعرض شيئًا.
لم يُستعد: العنصر موجود في النموذج بالفعل.يوجد بالفعل عنصر بتلك الهوية.
عرض فقط: اطلب صلاحية التعديل من أحد المالكين.لديك صلاحية العرض؛ والنص للقراءة فقط.

تُدرج رسائل المدقق حول نص SysML نفسه في الصيغة النصية لـSysML v2.

الحدود

  • مستند نصي واحد لكل حزمة على المستوى الأعلى؛ ولا توجد ملفات داخل المشروع.
  • لا يُفحص مستند أكبر من 8 MB، أو سطر أطول من 64 KB، أو تداخل أعمق من 256 مستوى.
  • الاسم الذي يمر عبر أكثر من 512 استيرادًا أو تخصيصًا متداخلًا (الحزمة P2 تستورد P1، التي تستورد P0، وهكذا) لا يُفحص إلا جزئيًا؛ وتذكر قائمة المشكلات أين. اختصر السلسلة.
  • لا توجد المسودات إلا في المتصفح الذي كتبتها فيه.
  • يُظهر البحث 10,000 تطابق على الأكثر (10,000+).
  • تبقى العناصر المحذوفة في سلة المحذوفات 30 يومًا.
  • يعمل مدقق SysML في متصفحك. وفي Safari يستوعب نماذج تصل إلى نحو 750,000 سطر من نص SysML.

المدقق متوقف مؤقتًا

ترى هذا النموذج أكبر من أن يستوعبه مدقق SysML في هذا المتصفح. يبقى التعديل والمخططات يعملان؛ والفحوص متوقفة مؤقتًا. (أو توقف مدقق SysML مرتين على هذا النموذج…) في إشعار مع إعادة المحاولة.

  • السبب: توقف المدقق مرتين متتاليتين على هذا النموذج، غالبًا لأن النموذج أكبر مما يستطيع استيعابه. فيتوقف مؤقتًا بدلًا من إعادة التشغيل مجددًا.
  • الإصلاح: تابع العمل: فالصفحات والمخططات والتعديلات خارج المحرر لا تزال تعمل. وتنتظر الفحوص والبحث عن الأسماء وتطبيق نص المحرر حتى يعمل المدقق مجددًا. اختر إعادة المحاولة في الإشعار، أو أعد تحميل الصفحة. وإذا توقف مجددًا، فقسّم النموذج إلى عدة مشاريع، أو أرسل طلب دعم مع حجم المشروع.

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