Holarch

التحقق

فحوص النموذج

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

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

في هذه الصفحة
  1. نظرة عامة
  2. المفاهيم
  3. طريقة استخدامها
    1. العمل على النتائج
    2. التركيز على مجال واحد
    3. مراجعة نتائج عنصر واحد معًا
    4. مثال عملي: المشروع التوضيحي CubeSat EO-1
    5. كتابة قاعدة خاصة بك
    6. فحص ميزانية كتلة بالوحدات
    7. مشاركة القواعد مع مشروع آخر
    8. نصائح
  4. الصفحة
    1. ترويسة الصفحة
    2. سطر الرأس
    3. شريط الأدوات
    4. الأوجه
    5. النتائج
    6. الإصلاحات
  5. الإعدادات
  6. مجموعات القواعد
    1. مربع الحوار مجموعات القواعد
    2. محرر القواعد
    3. قواعد التعابير
    4. ملفات مجموعات القواعد
  7. القواعد
    1. قواعد خط المنتجات
  8. الرسائل
  9. الحدود
  10. ذات صلة

نظرة عامة

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

تعمل الفحوص مجددًا كلما تغيّر النموذج، لذا تتفق دائمًا الصفحة والبطاقة فحوص النموذج في الرئيسية والشارة على التحقق.

المفاهيم

  • القاعدة: فحص واحد له رقم (مثلًا Requirement.10)، وعنوان يسمّي ما يجده، وبيان لما يبدو عليه النموذج الجيد، وإصلاح. وتُجمَّع القواعد حسب الفئة التي تفحصها: Global (كل عنصر)، وAction، وAsset، وConduit، وInput/Output، وRequirement، وRisk، وTest Case، وMeasure.
  • النتيجة: عنصر واحد يخالف قاعدة واحدة. ويمكن أن تسمّي النتيجة عناصر مرتبطة، مثل الأسماء المكررة أو أبناء أصل.
  • الخطورة: تبلّغ كل قاعدة بوصفها خطأ أو تحذير، أو تُضبط على تجاهل فلا تعمل. والافتراضي هو Warning، باستثناء قاعدتي LML 2.0 Global.10 وGlobal.11 في مشروع تسبق نسخة مخططه الهيكلي LML 2.0 (انظر القواعد).
  • النتيجة المتجاهَلة: نتيجة قبلتها لعنصر واحد. فلم تعد تُحتسب، ويسردها إظهار المتجاهَل مع استعادة.
  • الفحص المنطبق: قاعدة عملت على عنصر واحد على الأقل من فئتها. ويعدّ سطر الرأس كم فحصًا منطبقًا ليست له نتيجة.
  • مجموعة القواعد: مجموعة مسمّاة من قواعدك الخاصة، مخزنة في المشروع وتُفعَّل أو تُوقف ككل. وتعمل قواعدها مع الفحوص المدمجة، وتستخدم نتائجها القائمة نفسها و«إصلاح» و«تجاهل». انظر مجموعات القواعد.

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

شغّل الفحوص قبل كل مراجعة، وبعد استيراد كبير، وكلما عرضت الرئيسية أخطاء فحص النموذج. فهي تجيب عن سؤال واحد: ما الذي يحتاج إلى انتباه في النموذج قبل أن يقرأه شخص آخر؟

العمل على النتائج

  1. افتح التحقق ← فحوص النموذج. يعرض سطر الرأس مثلًا “84% من الفحوص المنطبقة ناجحة”، يليه عدد الأخطاء والتحذيرات والتغيّر منذ آخر تشغيل.
  2. القائمة مجمّعة حسب القاعدة، والأخطاء أولًا. انقر عنوان قاعدة لفتحها؛ ويشرح وصفها سبب أهمية القاعدة.
  3. لكل نتيجة، انقر إصلاح. يعرض مربع حوار الإصلاح العنصر والقاعدة والإصلاح المقترح: حقلًا لملئه، أو علاقات لإضافتها، أو مكررات لدمجها، أو زرًا يفتح العنصر أو مخططه.
  4. احفظ الإصلاح. فتختفي النتيجة وتتحدث الأعداد.
  5. عندما تكون النتيجة مقصودة (مثلًا إجراء مُعاد استخدامه تحت أصلين)، انقر تجاهل.

التركيز على مجال واحد

  1. في الأوجه على اليمين، حدّد الأخطاء تحت الخطورة لرؤية الأخطاء فقط.
  2. حدّد فئة تحت الفئة (فئة العنصر صاحب النتيجة)، أو قاعدة تحت القاعدة أو تسمية تحت التسمية. وتُجمع التحديدات في وجه واحد بـ OR؛ وتُجمع الأوجه بـ AND. وتعرض كل قيمة عدد نتائجها.
  3. اكتب في تصفية النتائج لمطابقة اسم عنصر أو عنوان قاعدة.
  4. انقر مسح الأوجه لإظهار كل شيء مجددًا.

مراجعة نتائج عنصر واحد معًا

  1. اختر التجميع حسب الكيان بجوار عامل التصفية.
  2. يُسرد كل عنصر مرة واحدة مع كل نتائجه، بترتيب الأرقام. ويعرض العنصر الذي فيه خطأ الشارة خطأ في عنوانه.

مثال عملي: المشروع التوضيحي CubeSat EO-1

  1. افتح المشروع التوضيحي CubeSat EO-1 وانتقل إلى التحقق ← فحوص النموذج.
  2. حدّد Requirement تحت الفئة. وتُظهر القواعد المتبقية أي المتطلبات ليس لها أصل، أو تخصيص (Requirement.8)، أو حالة اختبار تتحقق منها (Requirement.10).
  3. افتح Requirement.10، وانقر إصلاح على نتيجة، واربط حالة الاختبار التي تتحقق منها. فتغادر النتيجة القائمة، ويرتفع سطر الرأس.
  4. اختر التجميع حسب الكيان لرؤية كل النتائج المتبقية لمتطلب واحد دفعة واحدة.

كتابة قاعدة خاصة بك

  1. انقر مجموعات القواعد… في رأس الصفحة، ثم + مجموعة قواعد جديدة. سمِّ المجموعة، مثلًا “قواعد البرنامج”، وانقر موافق.
  2. تحت المجموعة، انقر + إضافة قاعدة. يفتح محرر القواعد بالمعرّف R1.
  3. اكتب الاسم الذي يذكر ما تجده القاعدة، مثلًا “متطلبات بلا حالة اختبار تتحقق منها”.
  4. في ينطبق على، اختر Requirement.
  5. في الإبلاغ عن عنصر عندما، اختر علاقة مفقودة، ثم اختر verified by في العلاقة.
  6. اضبط الخطورة على خطأ واكتب الرسالة، مثلًا “اربط حالة الاختبار التي تتحقق من المتطلب.”
  7. اقرأ المعاينة تحت الحقول، مثلًا “يبلّغ الآن عن 3 عناصر: SYS-2 Top Speed، …”. انقر حفظ.
  8. انقر إغلاق. تظهر نتائج القاعدة في القائمة تحت R1، والأخطاء أولًا. انقر إصلاح لربط حالة اختبار؛ فتغادر النتيجة القائمة.

فحص ميزانية كتلة بالوحدات

  1. في المشروع التوضيحي CubeSat EO-1، افتح مجموعات القواعد…، وانقر + مجموعة قواعد جديدة وسمّها “ميزانية الكتلة”.
  2. انقر + إضافة قاعدة. سمّها “تجميعات تتجاوز مخصص كتلتها” واختر Asset في ينطبق على.
  3. في الإبلاغ عن عنصر عندما، اختر مجموع القيم المرتبطة مقارنةً بقيمة. اضبط الدالة على المجموع، والعلاقة على decomposed by، وقيمة كل عنصر مرتبط على Mass، والمقارنة على أكبر من، والمقارنة مع على Mass Allocation.
  4. اضبط الخطورة على خطأ وانقر حفظ، ثم إغلاق.
  5. يُسرد التجميع الذي تزن أجزاؤه أكثر من مخصصه، مثلًا “إجمالي Mass لـ “decomposed by” وقدره 2.34 kg أكبر من Mass Allocation وقدره 1.35 kg”. وتُجمع الكتل بالغرامات والكيلوغرامات معًا؛ أما الكتلة المُدخلة بالأمتار فتُسرد بالرسالة “لا يمكن جمع الكتلة والطول: الأبعاد مختلفة (kg مقابل m).”

مشاركة القواعد مع مشروع آخر

  1. في مجموعات القواعد…، انقر تصدير بجوار المجموعة. فيُنزَّل ملف باسم مثل program-rules.holarch-rules.json.
  2. في المشروع الآخر، افتح مجموعات القواعد…، وانقر استيراد…، ثم اختيار ملف… (أو الصق نص الملف) وانقر استيراد.
  3. للمشاركة عبر مكتبة، احتفظ بمجموعات القواعد في مشروع المكتبة وانشر إصدارًا. وفي مشروع يستخدم المكتبة، انقر من المكتبة…، وحدّد المجموعات وانقر نسخ.
  4. عندما تنشر المكتبة إصدارًا أحدث يحتوي على المجموعة، يعرض مجموعات القواعد… الرسالة “يتوفر إصدار أحدث” بجوار النسخة. انقر تحديث…، وراجع التغييرات، واختر الاحتفاظ بنسختي أو اعتماد نسخة المكتبة لكل قاعدة تغيّرت في الموضعين، وانقر تحديث. وتُحفظ تعديلاتك الأخرى على النسخة.

نصائح

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

الصفحة

عنصر التحكمما الذي يفعله
تصدير…يفتح مربع حوار التصدير مع Findings (CSV): كل نتيجة غير متجاهَلة، مع القاعدة والخطورة والعنوان ومعرّف العنصر والرقم والاسم والفئة والملاحظة والعناصر المرتبطة.
الإعداداتيضبط خطورة كل قاعدة وعدد الأبناء لكل مستوى (انظر الإعدادات).
↻ تشغيل الفحوصيشغّل كل فحص مجددًا ويسجّل الأعداد بوصفها آخر تشغيل.

سطر الرأس

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

في المشروع الكبير تعمل الفحوص في الخلفية، فتبقى الصفحة قابلة للاستخدام: تعرض الزيارة الأولى “جارٍ تشغيل فحوص النموذج…”، وتعرض الزيارات اللاحقة النتائج السابقة إلى أن تجهز الجديدة، وتعرض بطاقة تقدم أي تشغيل يستغرق أكثر من ثانية.

شريط الأدوات

  • التجميع حسب القاعدة (الافتراضي) أو التجميع حسب الكيان. ويُتذكَّر الاختيار على هذا الجهاز.
  • تصفية النتائج: تطابق أسماء العناصر وأرقام القواعد وعناوينها.
  • يفتح توسيع الكل وطي الكل كل المجموعات أو يغلقانها.

الأوجه

الوجهالقيم
الخطورةالأخطاء، التحذيرات
الفئةفئة كل عنصر له نتيجة
القاعدةكل قاعدة لها نتيجة، حسب الرقم والعنوان
التسميةكل تسمية على عنصر له نتيجة
المتجاهَلةيضيف إظهار المتجاهَل النتائج المتجاهَلة إلى القائمة، معلَّمة بـ «متجاهَلة»، مع استعادة

تتبع الأعداد الأوجه الأخرى وعامل التصفية، فتعرض ما سيبقى إذا حددت قيمة.

النتائج

تعرض كل نتيجة العنصر (أو القاعدة، عند التجميع حسب الكيان)، والملاحظة (مثلًا “كلمات مبهمة: adequate، TBD” أو “14 ابنًا”)، والعناصر المرتبطة، والزرين إصلاح وتجاهل، أو استعادة للنتيجة المتجاهَلة. ويُلغي تراجع واحد عملية التجاهل أو الاستعادة.

الإصلاحات

الإصلاحتستخدمهما الذي يفعله
تحرير حقلالاسم أو الرقم أو الوصف المفقود؛ فحوص الفعل والاسميفتح الحقل بالقيمة الحالية.
تكبير الحرف الأولالأسماء بأحرف صغيرةيقترح الاسم بحرف أول كبير.
إضافة علاقاتالأصل أو المؤدي أو المدخلات أو المخرجات أو القنوات أو المعايير أو التتبعات المفقودةيسرد العناصر التي يسمح بها المخطط الهيكلي للعلاقة؛ حدّدها وانقر إضافة علاقات.
دمجالأسماء المتشابهة، والأبناء المنفردونيحتفظ بعنصر واحد، وينقل إليه كل علاقات العناصر الأخرى، ويجمع الأوصاف ويحذف العناصر الأخرى (ويُلغي تراجع واحد ذلك كله).
حذف المرتبطالإجراءات ذات مُدخل يُنتَج بعد استخدامهيحذف عناصر Input/Output التي تُستهلك قبل وجودها.
إضافة traced toمتطلبات تذكر كيانات غير مرتبطةيضيف traced to من المتطلب إلى كل عنصر يسمّيه نصه.
إنشاء مشكلةحالات الاختبار الفاشلة دون مشكلة مرتبطةينشئ Issue مرتبطة بحالة الاختبار والمتطلبات التي تتحقق منها.
الفتحقوائم الأبناء الطويلة، والتبادلات، والمعايير، والعتبات، والعلاقات التي لا يسمح بها المخطط الهيكلييفتح العنصر أو مخططه.
فتح عرض UAFعروض UAF التي لا يمكن عرضهايسرد عروض الجذر مع مشكلاتها ويفتح أولها.

الإعدادات

  • الأبناء لكل مستوى: تبلّغ Action.9 وAsset.9 عن أصل له أبناء أكثر من هذا الرقم. والافتراضي 9، من الإرشاد القائل إن الناس يتعاملون مع نحو 7 ± 2 عناصر في المستوى الواحد. والقيم المسموح بها من 2 إلى 99؛ وتعرض أي قيمة أخرى “يجب أن يكون عدد الأبناء لكل مستوى عددًا صحيحًا من 2 إلى 99.”
  • الخطورة لكل قاعدة: Error أو Warning أو Ignore. والقاعدة المتجاهَلة لا تعمل.
  • يعيد استعادة الإعدادات الافتراضية كل قاعدة إلى قيمتها الافتراضية (Warning؛ وRequirement.11 على Ignore؛ وGlobal.10 وGlobal.11 على Ignore في مشروع تسبق نسخة مخططه الهيكلي LML 2.0) ويعيد الأبناء لكل مستوى إلى 9.

تُخزَّن الإعدادات في المشروع، وتُشارك مع كل من فيه، ويمكن التراجع عنها.

مجموعات القواعد

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

مربع الحوار مجموعات القواعد

عنصر التحكمما الذي يفعله
+ مجموعة قواعد جديدةيطلب اسمًا ويضيف مجموعة فارغة مفعّلة.
استيراد…يضيف مجموعات القواعد من ملف مجموعة قواعد: اختيار ملف… أو الصق نصه، ثم استيراد. وتُفحص كل قاعدة أولًا؛ ويُرفض الملف الذي فيه مشكلة وتُسرد المشكلات. ويُضاف “ (2)” إلى الاسم المستخدم من قبل.
من المكتبة…يسرد مجموعات القواعد في إصدارات المكتبات التي يستخدمها هذا المشروع؛ حدّدها وانقر نسخ. وتتذكر النسخة مكتبتها وإصدارها.
تحديث…بجوار مجموعة منسوخة عندما تنشر مكتبتها إصدارًا أحدث يحتوي على المجموعة (“يتوفر إصدار أحدث”). يعاين القواعد المضافة والمعدّلة والمحذوفة في المكتبة، والتعديلات التي أجريتها والمحفوظة، والقواعد التي تغيّرت هنا وفي المكتبة معًا؛ اختر الاحتفاظ بنسختي أو اعتماد نسخة المكتبة لكل منها، ثم انقر تحديث. ويُلغي تراجع واحد ذلك كله.
مربع الاختيار بجوار المجموعةيفعّل المجموعة أو يوقفها. والمجموعة الموقوفة لا تعمل.
إعادة التسمية…يعيد تسمية المجموعة.
تصديرينزّل المجموعة بوصفها ملف مجموعة قواعد JSON.
حذفيحذف المجموعة وقواعدها بعد تأكيد. ويستعيدها التراجع.
+ إضافة قاعدة، تحرير، حذفأضف قاعدة إلى المجموعة، أو غيّرها، أو احذفها.

القاعدة التي لا يمكن تشغيلها في هذا المشروع، مثل قاعدة تسمّي فئة أو علاقة لا يحتويها المخطط الهيكلي، تعرض المشكلة بالأحمر تحت اسمها ولا تبلّغ عن شيء.

محرر القواعد

الحقلما يضبطه
الاسمعنوان نتائج القاعدة: ما تجده القاعدة.
المعرّفقصير وفريد في المجموعة، مثلًا R1 أو SYS-NUM؛ حتى 40 حرفًا أو رقمًا أو نقطة أو شرطة أو شرطة سفلية.
ينطبق علىأي عنصر، أو فئة (بما فيها الفئات الفرعية: Test Case هو أيضًا Action)، أو في مشروع SysML v2 نوع نموذج مثل Part أو Requirement.
العناصر المطابقة فقطاختياري: عامل تصفية بلغة تصفية قاعدة البيانات يضيّق العناصر أولًا، مثلًا is:leaf.
الإبلاغ عن عنصر عندماالشرط، أدناه.
الخطورةخطأ أو تحذير.
الرسالةالإصلاح المطلوب، ويظهر في مربع حوار الإصلاح.

يذكر السطر تحت الحقول عدد العناصر التي تبلّغ عنها القاعدة الآن ويسمّي أول خمسة منها.

الشرطالحقوليبلّغ عن عنصر عندما
سمة فارغةالسمةلا قيمة للسمة.
سمة تطابق نمطًاالسمة، النمط، تجاهل حالة الأحرفيحتوي نص السمة على تطابق مع النمط، وهو تعبير نمطي.
سمة لا تطابق نمطًاالسمة، النمط، تجاهل حالة الأحرفلا يحتوي نص السمة على تطابق، مثلًا ^SYS-\d+$ للأرقام التي يجب أن تبدأ بـ SYS-.
علاقة مفقودةالعلاقة، لعناصر منليس للعنصر رابط من تلك العلاقة (إلى عناصر من تلك الفئة).
علاقة موجودةالعلاقة، لعناصر منللعنصر رابط من هذا النوع.
عدد العناصر المرتبطة N على الأقلالعلاقة، لعناصر من، Nللعنصر N عنصرًا مرتبطًا أو أكثر، مثلًا أكثر من 9 أبناء.
عدد العناصر المرتبطة N على الأكثرالعلاقة، لعناصر من، Nللعنصر N عنصرًا مرتبطًا أو أقل.
قيمة خارج نطاقالسمة، الحد الأدنى، الحد الأقصى، الوحدةرقم السمة أقل من الحد الأدنى أو أكبر من الحد الأقصى. اترك أحد الحدين فارغًا لنطاق مفتوح.
قيمة داخل نطاقالسمة، الحد الأدنى، الحد الأقصى، الوحدةرقم السمة ضمن النطاق، بما في ذلك الحدّان.
مجموع القيم المرتبطة مقارنةً بقيمةالدالة، العلاقة، لعناصر من، قيمة كل عنصر مرتبط، المقارنة، المقارنة معيكون المجموع أو الأصغر أو الأكبر لقيمة على العناصر المرتبطة (أو عدد العناصر) أكبر من سمة للعنصر (مثلًا Mass Allocation) أو من قيمة بوحدتها (12 kg)، أو على الأقل مساويًا لها، أو أقل منها، أو على الأكثر مساويًا لها، أو مساويًا لها، أو مختلفًا عنها. وتُتخطى العناصر المرتبطة التي ليست لها القيمة.
تعبير يطابقالتعبيريطابق العنصر التعبير.

تُسمّى السمات كما على العنصر: الاسم والرقم والوصف (في مشروع SysML v2 Short Name والتوثيق) أو أي سمة من سمات الفئة. وفي مشروع SysML v2، يمكن أيضًا تسمية استخدام سمة للعنصر، مثل mass. ويُتخطى العنصر الذي ليست لفئته هذه السمة. وتشمل قيم عنصر LML أيضًا الخصائص التي هو specified by لها (تُقرأ خاصية Mass بالقيمة 2.4 والوحدات kg على أنها 2.4 kg) وتخصيصات ميزانيته (Mass Allocation، من الميزانيات). ودون الوحدة، يقرأ النطاق الرقم الأول في القيمة (تُقرأ 1,500 kg و1500 [kg] على أنها 1500) ويتخطى القيم التي ليست أرقامًا. ومع الوحدة مثل kg، تُحوَّل القيم أولًا (تُقرأ 25000 g على أنها 25 kg)، والقيمة من نوع آخر، مثل 3 m، نتيجة قائمة بذاتها: “لا يمكن مقارنة الطول والكتلة: الأبعاد مختلفة (m مقابل kg).” وتحوّل المجاميع والتعابير الوحدات بالطريقة نفسها وتبلّغ عن عدم التطابق بالطريقة نفسها، ولا تجري أبدًا مقارنة صامتة.

قواعد التعابير

يُكتب التعبير بلغة التصفية في شريط التصفية في قاعدة البيانات، فعامل التصفية الذي يجد العناصر المسببة للمشكلة هناك يعمل قاعدةً: كل عنصر يطابقه يُبلَّغ عنه. أمثلة:

التعبيرالتقارير
class:Requirement is:leaf NOT relationship:"verified by"متطلبات طرفية لا تتحقق منها أي حالة اختبار.
class:Requirement Requirement:"Status=Draft"متطلبات لا تزال في Draft.
class:Action is:root NOT relationship:"performed by"إجراءات المستوى الأعلى التي لا يؤديها شيء.
class:Asset (name:%TBD% OR description:TBD)أصول فيها TBD في الاسم أو الوصف.
class:Asset value:"sum(decomposed by → Mass) > Mass Allocation"تجميعات تزن أجزاؤها أكثر من مخصصها، بأي مزيج من الوحدات.

الحساب بالوحدات: يقارن value:"Mass * 1.1 <= 12 kg" أو value:"sum(decomposed by → Mass) > Mass Allocation" قيم العنصر والمجاميع على عناصره المرتبطة (sum، min، max، count)، مع + و- و* و/ والأقواس والوحدات بعد الأرقام (12 kg، 9.81 [m/s^2]). وتُحوِّل أيضًا مقارنات السمات التي فيها وحدة، مثل Asset:"Mass>2 kg".

المصطلحات: نص حر، name: (% يطابق أي نص)، number: (* يطابق أي نص)، description:، class:، label:، relationship:"…"، status:، id:، under:"<number>"، is:root، is:leaf، is:orphan، is:top، is:locked، is:diagram، ومقارنات السمات مثل Requirement:"Priority>=3" (=، ~ يحتوي، <، <=، >، >=؛ و= دون قيمة تعني فارغًا)، وAND وOR وNOT والأقواس. والمصطلح الذي لا يسمّي شيئًا في المشروع، مثل فئة غير معروفة، يُعرض بوصفه مشكلة.

ملفات مجموعات القواعد

ملف مجموعة القواعد هو JSON يحتوي على "format": "holarch-rule-set" و"version": 1 وname وdescription اختياري وقائمة rules، لكل منها id وname وseverity وmessage وtarget اختياري ({"class": "Requirement"}) وعامل تصفية where اختياري وcheck. صدّر مجموعة لترى الشكل الدقيق. وتعمل الملفات نفسها في فحوص النموذج في الواجهة البرمجية العامة وMCP. وتعمل على مشاريع SysML v2 أيضًا: هناك تشغّل الواجهة البرمجية وMCP مجموعات قواعد المشروع فقط (تعمل القواعد المدمجة في التطبيق)، والقاعدة التي تتناول العلاقات التي يقرؤها Holarch من الوصلات والتدفقات (connected by، transfers، generates، receives) تعمل في التطبيق فقط.

القواعد

القاعدةHeadingالنموذج الجيد
Global.1أسماء متطابقة أو شبه متطابقةداخل الفئة، لا يتشارك كيانان اسمًا. وتُقارن الأسماء بأي لغة، مع تجاهل حالة الأحرف والمسافات وعلامات الترقيم وعرض الأحرف (“ABS制御” تساوي “ABS制御”)؛ والأحرف المشكولة تُحتسب (“Größe” و“Grüße” مختلفتان).
Global.2الأسماء بأحرف صغيرةيبدأ كل اسم كيان بحرف كبير.
Global.4أرقام مكررة في فئةداخل الفئة، كل رقم فريد.
Global.5كلمات مبهمة في الأسماء أو الأوصافتستخدم الأسماء والأوصاف كلمات دقيقة.
Global.6كيانات بلا علاقاتلكل كيان علاقة.
Global.7قيم حية تشير إلى أهداف مفقودةتشير القيم الحية، وكتل المصفوفات، والجداول الحية (الجداول والأعداد والمجاميع)، والإحالات في الأوصاف إلى كيانات ومستندات وفئات وتسميات وعلاقات وأشكال وجداول موجودة.
Global.8عروض UAF التي لا يمكن عرضهايستخدم كل عرض UAF جذرًا وفئة وعلاقة يقبلها نوع عرضه.
Global.9علاقات لا يسمح بها المخطط الهيكليتربط كل علاقة فئات يسمح بها المخطط الهيكلي لصلتها.
Global.10كيانات بلا اسم ولا رقملكل كيان اسم أو رقم.
Global.11قيم خارج خيارات سمتهاكل قيمة تعداد ومتعددة الاختيار هي أحد خيارات سمتها، مختارة مرة واحدة.
Action.1أسماء Action لا تبدأ بفعليبدأ كل اسم Action بفعل.
Action.2أسماء Action بأحرف صغيرةيبدأ كل اسم Action بحرف كبير.
Action.3إجراءات بلا اسملكل إجراء اسم.
Action.4إجراءات بلا رقملكل إجراء رقم.
Action.5إجراءات بلا وصفلكل إجراء وصف.
Action.6إجراءات بلا أصل أو ابنلكل إجراء أصل أو ابن.
Action.7إجراءات لها ابن واحدلا يوجد إجراء له ابن واحد.
Action.9إجراءات لها أكثر من 9 أبناءلا يوجد إجراء له أكثر من 9 أبناء.
Action.10إجراءات لها عدة أصوللا يوجد إجراء له عدة أصول.
Action.11إجراءات لا يؤديها أي أصليؤدي أصلٌ ما كل إجراء.
Action.12إجراءات لا تُنتج شيئًايُنتج كل إجراء Input/Output.
Action.13إجراءات لا تستهلك شيئًايستهلك كل إجراء Input/Output.
Action.14إجراءات بلا مدخلات أو مخرجاتيستهلك كل إجراء Input/Output أو يُنتجه.
Action.15إجراءات تُنتج ولا تستهلك شيئًاكل إجراء يُنتج مخرجات يستهلك أيضًا مُدخلًا.
Action.16إجراءات تستهلك ولا تُنتج شيئًاكل إجراء يستهلك مدخلات يُنتج أيضًا مُخرجًا.
Action.17الإجراءات ذات مُدخل يُنتَج بعد استخدامهلا يتلقى أي إجراء Input/Output يولّده إجراء لاحق.
Action.18إجراءات غير متتبَّعة إلى متطلبيتتبع كل إجراء إلى متطلب.
Action.19حلقات لا يمكن أن تنتهييمكن أن تنتهي كل حلقة. يسمّي الحلقة وفرع OR عند 0 % الذي يمنع EXIT الخاص بها.
Asset.1أسماء Asset بلا اسم جامدكل اسم Asset اسم أو عبارة اسمية.
Asset.2أسماء Asset بأحرف صغيرةيبدأ كل اسم Asset بحرف كبير.
Asset.3أصول بلا اسملكل أصل اسم.
Asset.4أصول بلا رقملكل أصل رقم.
Asset.5أصول بلا وصفلكل أصل وصف.
Asset.6أصول بلا أصل أعلى أو ابنلكل أصل أصل أعلى أو ابن.
Asset.7أصول لها ابن واحدلا يوجد أصل له ابن واحد.
Asset.9أصول لها أكثر من 9 أبناءلا يوجد أصل له أكثر من 9 أبناء.
Asset.10أصول لها عدة أصول عليالا يوجد أصل له عدة أصول عليا.
Asset.11أصول لا تؤدي أي إجراءيؤدي كل أصل إجراءً ما.
Asset.12أصول غير موصولة بقناةكل أصل موصول بقناة.
Asset.13أصول متبادلة بلا قناة مشتركةالأصول التي تتبادل Input/Output موصولة بقناة.
Asset.14أصول متفاعلة بلا معيار مشتركتشير الأصول المتفاعلة إلى المعيار نفسه.
Asset.15أصول لا تتبادل شيئًايتبادل كل أصل Input/Output مع أصل آخر.
Conduit.1أسماء Conduit لا تبدأ باسم جامديبدأ كل اسم Conduit باسم جامد.
Conduit.2قنوات بلا اسملكل قناة اسم.
Conduit.3قنوات بلا رقملكل قناة رقم.
Conduit.4قنوات بلا وصفلكل قناة وصف.
Conduit.5قنوات لها أكثر من أصلينلا توجد قناة تصل أكثر من أصلين.
Conduit.6قنوات لها أقل من أصلينتصل كل قناة أصلين.
Conduit.7قنوات بلا معيار مشترك مع أصولهاتشير القناة والأصول التي تصلها إلى المعيار نفسه.
Conduit.8قنوات لا تنقل شيئًاتنقل كل قناة Input/Output ما.
Conduit.9قنوات غير متتبَّعة إلى متطلبتتتبع كل قناة إلى متطلب.
IO.1عناصر Input/Output بلا اسملكل Input/Output اسم.
IO.2عناصر Input/Output بلا رقملكل Input/Output رقم.
IO.3عناصر Input/Output بلا وصفلكل Input/Output وصف.
IO.4عناصر Input/Output لها عدة أصوللا يوجد Input/Output له أكثر من أصل واحد.
IO.5عناصر Input/Output لا يُنتجها أي إجراءيُنتج إجراءٌ ما كل Input/Output.
IO.6عناصر Input/Output لا يستهلكها أي إجراءيستهلك إجراءٌ ما كل Input/Output.
IO.7عناصر Input/Output لا يستخدمها أي إجراءيُنتج إجراءٌ كل Input/Output أو يستهلكه.
IO.8عناصر Input/Output يُنتجها إجراء ويستهلكها معًالا يستهلك أي إجراء Input/Output يُنتجه.
IO.9عناصر Input/Output بلا معيار مشترك مع أصولهايشير الـ Input/Output والأصول التي تتبادله إلى المعيار نفسه.
IO.10عناصر Input/Output غير متتبَّعة إلى متطلبيتتبع كل Input/Output إلى متطلب.
Requirement.1متطلبات تذكر كيانات غير مرتبطةيرتبط المتطلب بكل كيان يسمّيه.
Requirement.2متطلبات طرفية بلا “shall”يستخدم كل متطلب طرفي الكلمة “shall”.
Requirement.3متطلبات بلا اسملكل متطلب اسم.
Requirement.4متطلبات بلا رقملكل متطلب رقم.
Requirement.5متطلبات بلا وصفلكل متطلب وصف.
Requirement.6متطلبات بلا أصل أو فرعلكل متطلب أصل أو ابن.
Requirement.7متطلبات لها عدة أصوللا يوجد متطلب له عدة أصول.
Requirement.8متطلبات طرفية لا يلبيها أي كيان تصميميرتبط كل متطلب طرفي بـ Action أو Asset أو Input/Output أو Conduit.
Requirement.9متطلبات satisfied by عدة عناصر Input/Outputلا يوجد متطلب satisfied by أكثر من Input/Output واحد.
Requirement.10متطلبات طرفية بلا حالة اختبار تتحقق منهاكل متطلب طرفي verified by Test Case.
Requirement.11متطلبات خارج أنماط EARSيتبع كل متطلب طرفي فيه “shall” أحد أنماط EARS. موقوف (Ignore) إلى أن تضبط خطورته.
Risk.1مخاطر المستوى الأعلى بلا تخفيفكل خطر مفتوح في أعلى مستوى من مصفوفة المخاطر mitigated by شيءٍ ما.
Risk.2قبولات مخاطر على السلامة أقدم من تغيير في الضوابطلا يسبق قبول المخاطرة المتبقية لأي خطر على السلامة تغييرًا في ضوابطه أو في التحقق منها.
TestCase.1حالات الاختبار الفاشلة دون مشكلة مرتبطةكل Test Case فاشلة مرتبطة بـ Issue.
Measure.1مقاييس تتجاوز عتبتهاالقيمة المتوقعة (أو الحالية) لكل Measure تستوفي عتبتها.

ملاحظات على القواعد:

  • تستند قواعد كتابة المتطلبات إلى دليل INCOSE لكتابة المتطلبات: الكلمات المبهمة (R7، المصطلحات المبهمة؛ R8، عبارات التملص)، و“shall” (R1، العبارات المهيكلة)، والأحرف الكبيرة (R39، دليل الأسلوب). والفحص الكامل للكتابة هو جودة المتطلبات.
  • تتخطى قواعد Action وAsset المهام وحالات الاختبار وانتقالات الحالة والمنافذ والموارد؛ وتظل القواعد Global تنطبق عليها.
  • يُحتسب العنصر المفكك مؤدًّى أو مغذًّى أو منتجًا أو متتبَّعًا عندما يكون أي من أحفاده كذلك. والعناصر التي يفكك بعضها بعضًا في حلقة تُحتسب معًا.
  • تبلّغ Global.9 عن كل عنصر مرة واحدة، مع الأطراف الأخرى لعلاقاته التي لا يسمح بها المخطط الهيكلي، ومع الصلة والفئة في الملاحظة، مثلًا “غير مسموح: decomposed by → Risk”. وتُعد العلاقة مسموحًا بها عندما يسمح بها المخطط الهيكلي في أي من الاتجاهين. وتبقى هذه العلاقات بعد إزالة هدف في محرر المخطط الهيكلي ويمكن أن تأتي مع عمليات الاستيراد.
  • تأتي Global.10 وGlobal.11 من LML 2.0: يُعرَّف الكيان باسم أو رقم (§2.1)، وتُختار قيمة التعداد أو القيمة المتعددة الاختيار من قائمة سمتها (§2.5.6، §2.5.12). وتضع Global.11 كل مشكلات العنصر الواحد في ملاحظته، مثلًا Status: "Pending" is not a choice أو Verification Method: "Test" chosen twice. وتعمل كلتاهما افتراضيًا حيث يحتوي المخطط الهيكلي على العناصر المدمجة في LML 2.0: المخطط الهيكلي الافتراضي، أو نسخة المشروع الخاصة بعد المخطط الهيكلي ← إضافة عناصر مدمجة جديدة…. وفي مشروع نسخة مخططه الهيكلي أقدم، تبدآن على تجاهل، فيعرض النموذج المصنوع بـ LML 1.x النتائج نفسها كما من قبل؛ اضبطهما على Warning أو Error في الإعدادات لتشغيلهما. ويطلب محرر المخطط الهيكلي قيمتين على الأقل عند إنشاء قائمة أو تغييرها.
  • المنافذ نقاط واجهة، لا أجزاء: فهي لا تُحتسب أبناءً، والقناة على منفذ تُحتسب للأصل الذي يملكه.
  • حالات الاستخدام (عناصر Action ذات التسمية Use Case) معفاة من قاعدة الفعل وقواعد Input/Output.
  • تفحص Requirement.11 الجملة التي تحتوي على “shall” مقابل أنماط EARS الستة (الكتابة بقوالب EARS) وتسمّي أول ما يجب إصلاحه، مثلًا “Event-driven: ضع فاصلة بعد الشرط “When”، قبل اسم النظام.” ولا يُفحص المبرر والملاحظات في الجمل الأخرى.
  • تشغّل مشاريع SysML v2 سبع عشرة من القواعد، بمصطلحات SysML v2: Global.1 و.2 و.4 إلى .8، وRequirement.2 إلى .5 و.8 و.10 و.11، وRisk.1، وTestCase.1، وMeasure.1. ولا تنطبق قواعد Action وAsset وConduit وInput/Output؛ إذ تفحص تشخيصات المحرر أسماء النموذج وأنواعه وبنيته. وتفحص قواعد المتطلبات استخدامات المتطلبات: مثلًا تُقرأ Requirement.8 بالصيغة “متطلبات طرفية لا يستوفيها شيء” (جزء أو إجراء يستوفيها) وRequirement.10 بالصيغة “متطلبات طرفية بلا حالة تحقق”. وتفحص Global.1 و.2 و.6 العناصر المجاورة للنموذج، مثل المخاطر والمهام والمستندات.

قواعد خط المنتجات

بمجرد أن يحتوي المشروع على Feature أو Configuration، تشغّل فحوص النموذج أيضًا مجموعة القواعد المدمجة Product line (القواعد ProductLine.1 إلى ProductLine.11 و13 إلى 17، الفئة Product Line). وتُعد أخطاءً الميزاتُ أو التهيئات المفقودة في Applies To (ProductLine.1)، والتهيئات التي تخالف قاعدة أو غير المكتملة (ProductLine.3)، والتهيئات Released التي فيها متطلبات لم يُتحقق منها فيها (ProductLine.16)؛ والقواعد الأخرى تحذيرات. وتفحص ProductLine.10 و11 اكتمال كل تهيئة من All configurations. وتفحص ProductLine.13 و14 مراجعات عنصر (supersedes): اثنتان ساريتان للوحدة نفسها، ووحدات بلا أي منها. وفي عرض التهيئة تفحص كل قاعدة تلك التهيئة. انظر خطوط المنتجات والتهيئات.

الرسائل

الرسالةالمعنى
“لا توجد نتائج. كل الفحوص المنطبقة ناجحة.”لا شيء يحتاج إلى إصلاح.
“لا توجد نتائج. N من النتائج متجاهَلة؛ يسردها «إظهار المتجاهَل».”كل النتائج المتبقية متجاهَلة.
“لا توجد نتيجة تطابق عامل التصفية. امسح عامل التصفية أو الأوجه.”تُخفي الأوجه أو عامل التصفية كل النتائج.
“لا يسمح المخطط الهيكلي بأي من هذه العلاقات للفئة …”يحتاج الإصلاح إلى علاقة لا يسمح بها المخطط الهيكلي للمشروع لتلك الفئة. أضفها في محرر المخطط الهيكلي، أو أصلح النتيجة بطريقة أخرى.
“النمط ليس تعبيرًا نمطيًا صالحًا (…). صحّحه.”يحتوي محرر القواعد أو ملف مستورد على نمط لا يمكن قراءته.
“المعرّف “…” مستخدم بالفعل في مجموعة القواعد هذه. اختر معرّفًا آخر.”تحتاج قاعدتان في مجموعة واحدة إلى معرّفين مختلفين.
“العلاقة “…” ليست في المخطط الهيكلي لهذا المشروع.”تسمّي قاعدة علاقة لا يحتويها هذا المشروع؛ ولا تبلّغ عن شيء إلى أن تغيّرها.
“لا يسمّي التعبير شيئًا للفئة “…”.”يسمّي تعبير أو عامل تصفية فئة أو تسمية أو علاقة أو عنصرًا لا يحتويه المشروع.
“الإصدار N غير مدعوم. يقرأ هذا الإصدار من Holarch الإصدار 1.”كُتب ملف مجموعة القواعد بإصدار أحدث من Holarch.

الحدود

  • تعرض القائمة حتى 200 نتيجة لكل مجموعة؛ صفِّ القائمة لرؤية الباقي.
  • تحتوي مجموعة القواعد على 500 قاعدة كحد أقصى؛ ويحتوي الملف على 50 مجموعة قواعد و2 MB كحد أقصى. والأنماط حتى 300 حرف وتفحص أول 20,000 حرف من القيمة.
  • يُحفظ التغيّر منذ آخر تشغيل لكل جهاز ومتصفح، لا في المشروع.
  • تُرجع الواجهة البرمجية العامة وأدوات MCP النتائج نفسها بإعدادات المشروع؛ ولا تخزّن النتائج.