المتطلبات
توليد المستندات
ضع مصفوفات حية للتتبع والتحقق والواجهات وتقارير الاختبار في المستندات، وصدّرها بأربع صيغ، وأنشئها من خط أساس، وضع عليها علامات: إشعار شركة، أو بيان توزيع DoD، أو إشعار رقابة على الصادرات، أو حقوق نشر، أو رقم عقد على كل صفحة وكل تصدير.
في هذه الصفحة
نظرة عامة
يبني Holarch المُسلَّمات من النموذج، فيطابق المستند دائمًا المتطلبات والاختبارات والروابط التي تقف خلفه. وتغطي ثلاث أدوات ما يطلبه المراجعون عادةً:
- كتل المصفوفات: مصفوفة تتبع أو تحقق أو واجهات، أو تقرير اختبار، داخل نص المستند تتحدث كلما تغيّر النموذج.
- تصدير المصفوفة: المصفوفات نفسها وتقرير الاختبار في ملف مستقل بتنسيق Excel أو Word أو CSV أو صفحة ويب، من النموذج الحالي أو من خط أساس.
- الوسوم وإعداد الصفحة: وسم للمؤسسة أو المشروع أو مستند واحد (إشعار شركة، أو بيان توزيع، أو إشعار مراقبة تصدير، أو حقوق نشر، أو رقم عقد) على كل تصدير، إضافة إلى صفحة غلاف وأرقام صفحات لـ Word.
القيم والجداول الحية في النص مشروحة في صفحة المستندات: يدرج قيمة حية… سمة واحدة لكيان، والعدد أو الإجمالي… رقمًا محسوبًا من استعلام، وجدول حي… جدولًا من استعلام، وإسناد ترافقي… الرقم الحالي لقسم أو شكل أو جدول.
المفاهيم
المصفوفات
| المصفوفة | الصفوف | الأعمدة | مُبرَز بوصفه فجوة |
|---|---|---|---|
| RTM (مصفوفة تتبع المتطلبات) | المتطلبات | Number، Requirement، الأصل، Traced From، Traced To، Satisfied By | متطلب لا أصل له ولا شيء يتتبع منه |
| مصفوفة التدفق التنازلي للمتطلبات | المتطلبات | Number، Requirement، يتدفق من، يتدفق إلى، المتطلبات المشتقة | متطلب من المستوى الأعلى لا عنصر فرعيًا له ولا متطلبًا مشتقًا |
| مصفوفة تخصيص المتطلبات | المتطلبات | Number، Requirement، المكونات، الوظائف، أخرى | متطلب لا يحققه شيء |
| مصفوفة الامتثال (تظهر عند تفعيل البرنامج الرسمي) | متطلبات مواصفة عميل | Number، Requirement، الامتثال، الرد، متطلباتنا وتصميمنا، التحقق، الانحراف/الإعفاء | متطلب لا بيان امتثال له (غير مُقيَّم) |
| RVTM (مصفوفة تتبع التحقق من المتطلبات) | المتطلبات | Number، Requirement، الطريقة، المستوى، Verified By، الحالة | لا طريقة تحقق أو لا حالة اختبار تتحقق منه |
| VCRM (مصفوفة الإسناد الترافقي للتحقق) | المتطلبات | Number، Requirement، الفحص، التحليل، العرض التوضيحي، الاختبار، Verified By، الحالة | لم تُختر طريقة تحقق |
| VCRM حسب مستوى التحقق | المتطلبات | Number، Requirement، ثم I وA وD وT تحت كل مستوى تحقق، Verified By، الحالة | لا طريقة تحقق أو لا مستوى تحقق |
| تقرير الاختبار | حالات اختبار دورة اختبار | Number، Test Case، Verifies، الحالة، النتيجة الفعلية، التشغيل | حالة اختبار لم تنجح في الدورة |
| مصفوفة التخصيص | الوظائف (Action) | Number، الوظيفة، Performed By | وظيفة لا يؤديها أي مكون |
| مصفوفة الواجهات | المكونات (Asset) | المكونات نفسها؛ وتسرد الخلية عناصر Conduit من مكون الصف إلى مكون العمود | مكون لا Conduit له إلى المكونات الأخرى أو منها |
| مصفوفة N² | الوظائف (Action) | الوظائف نفسها؛ وتسرد الخلية عناصر Input/Output التي تولّدها وظيفة الصف وتستقبلها وظيفة العمود | وظيفة لا تتبادل أي مدخل أو مخرج |
| مصفوفة مخصصة | كيانات من استعلام بحث | كيانات من استعلام ثانٍ؛ وتسمّي الخلية العلاقات بين الاثنين، أو تعرض X لعلاقة واحدة مختارة | صف لا علاقة له بأي عمود |
- الأصل هو المتطلب الذي يفكّكه الصف. وتسرد Traced From وTraced To وSatisfied By الكيانات المرتبطة. وفي مصفوفة التدفق التنازلي، المتطلبات المشتقة هي المتطلبات التي يتتبع إليها الصف.
- في VCRM تشير X إلى كل طريقة مخطَّطة؛ والحالة هي نتيجة التحقق حتى الآن، مجمَّعة من حالات الاختبار كما في مركز الاختبار.
- في VCRM حسب مستوى التحقق، تُجمَّع الأعمدة حسب مستويات السمة مستوى التحقق (Component، Subsystem، System). وتقع X تحت مستوى المتطلب وكل طريقة من طرقه المخطَّطة.
- لا تُسرد حالات الاختبار أبدًا بوصفها وظائف: تعرض مصفوفتا التخصيص وN² عناصر Action التي ليست Test Case.
- النطاق: تغطي المصفوفة كيانات مستند واحد (بترتيب المستند وترقيمه)، أو كل أجزاء التجميع، أو المشروع كله. وتستخدم مصفوفة التخصيص وظائف المستند، أو كل الوظائف عندما لا يحتوي المستند على أي منها. ويمكن لمصفوفتي الواجهات وN² أيضًا أن تغطيا العناصر الفرعية لـ Asset أو Action واحد، كما تفعل مخططات I² وN²؛ وللمشروع كله تسردان المكونات أو الوظائف التي لها Conduit أو Input/Output، حتى 120. وتعرض المصفوفة المخصصة حتى 2,000 صف و120 عمودًا.
- تعرض كتلة تقرير الاختبار دورة اختبار واحدة لمجموعة اختبار واحدة، أو نتائجها الحالية. انظر تقارير الاختبار.
حية، لا منسوخة
لا تخزّن كتلة المصفوفة إلا ما يُعرض، لا الصفوف. وفي كل مرة يُعرض فيها المستند أو يُصدَّر، يعيد Holarch بناء الصفوف من النموذج. وتُخزَّن النتيجة مؤقتًا حتى التغيير التالي، فتبقى المشاريع الكبيرة سريعة.
طريقة استخدامها
إدراج مصفوفة في مستند
- افتح المستند وانقر داخل وصف المستند أو وصف عنصر.
- في شريط أدوات النص المنسَّق، افتح + واختر مصفوفة….
- اختر المصفوفة والنطاق. ويبدأ النطاق بالمستند المفتوح.
- لـ مصفوفة مخصصة، أدخل استعلامي البحث الصفوف والأعمدة (مثل
class:Requirementوclass:Asset)، واختر العلاقة أو أبقِ أي علاقة، وامنحها العنوان إن شئت. - لـ تقرير الاختبار، اختر مجموعة الاختبار ودورة الاختبار، أو النتائج الحالية.
ترى معاينة. وهي تتحدث كلما تغيّر النموذج.
- لـ مصفوفة مخصصة، أدخل استعلامي البحث الصفوف والأعمدة (مثل
- انقر إدراج.
تظهر المصفوفة في النص بإطار متقطع. وتسمّي تسميتها التوضيحية المصفوفة والنطاق وعدد الصفوف التي فيها فجوات.
لا يمكن تحرير المصفوفة خلية بخلية؛ غيّر النموذج بدلًا من ذلك. ولإزالتها، احذف الجدول في المحرر مثل أي محتوى آخر.
تصدير مصفوفة
- في مستند، افتح التسليم ▾ واختر مصفوفة التتبع…. أو اختر التسليم ▾ ← كل الصادرات… واختر مصفوفة التتبع (Excel) أو (Word) أو (CSV) أو (HTML).
- في تصدير المصفوفة، اختر المصفوفة والنطاق، وفي تصدير بتنسيق اختر المصفوفة (Excel) أو المصفوفة (Word) أو المصفوفة (CSV) أو المصفوفة (HTML).
- اختياري: في النموذج، اختر خط أساس بدلًا من النموذج الحالي. وتعرض القائمة خطوط أساس المشروع وخطوط أساس المستند المختار.
يذكر السطر تحت الحقول عدد الصفوف وعدد الصفوف التي فيها فجوات.
- انقر تصدير.
يقرأ الإشعار “صُدّرت المصفوفة.” وتُظلَّل الفجوات باللون الأحمر في Excel وWord وصفحة الويب. وتستخدم صادرات Word وصفحة الويب إعداد الصفحة الخاص بالمستند. وفي Word، تكون الأعمدة النصية عريضة وأعمدة طرق التحقق ضيقة، برؤوس I وA وD وT مع مفتاح تحت الجدول (I = الفحص، A = التحليل، D = العرض التوضيحي، T = الاختبار). وتستخدم المصفوفات التي تزيد أعمدتها على خمسة صفحة أفقية. ولـ VCRM حسب المستوى صف رأس ثانٍ بالمستويات؛ وتظلّل مصفوفات الواجهات وN² والمخصصة عناوين صفوفها وقطرها.
المصفوفات من خط أساس
يجب أن يعرض المُسلَّم الموقَّع النموذج كما كان عند خط الأساس، لا كما هو اليوم. وتستخدم المصفوفة المبنية من خط أساس كيانات خط الأساس وعلاقاته، وينتهي عنوانها بـ “(خط الأساس الاسم)”.
- تصدير المصفوفة: اختر خط الأساس في النموذج.
- يحتوي خط أساس المشروع على النموذج كله، فتعمل منه كل مصفوفة.
- يحتوي خط أساس المستند على المستند وعناصره والكيانات المرتبطة بها. ومصفوفات ذلك المستند كاملة. والمصفوفة التي تمتد خارج المستند (المشروع كله، أو مصفوفة واجهات أو N²) تحمل الملاحظة “مبنية من خط أساس مستند، لا يحتوي إلا على ذلك المستند والكيانات المرتبطة به.”
تقارير الاختبار
يقدّم تقرير الاختبار نتائج دورة اختبار واحدة: ما الذي اختُبر، وعلى أي تكوين، وما الذي نجح وفشل، وأي المتطلبات يتحقق ذلك منها.
- في مركز الاختبار، سجّل دورة اختبار بـ بدء دورة جديدة…. وأدخل التكوين / البناء ومادة الاختبار (يبدأ كلاهما بالقيم المسجلة أكثر من غيرها في التشغيل).
- على بطاقة المجموعة، افتح ⋯ واختر تقرير الاختبار…. أو افتح ⋯ ← دورات الاختبار… وانقر تقرير… على دورة.
- في تصدير تقرير الاختبار، اختر دورة الاختبار، وفي تصدير بتنسيق اختر تقرير الاختبار (Word) أو (Excel) أو (CSV) أو (HTML)، ثم انقر تصدير.
يحتوي تقرير Word (الافتراضي) على هذه الأقسام:
- التعريف: مجموعة الاختبار، ودورة الاختبار، ومتى حُفظت النتائج ومتى أُعدّ التقرير.
- بيئة الاختبار والتكوين: التكوين أو البناء، ومادة الاختبار، والمختبِرون، وتواريخ التشغيل.
- ملخص النتائج: الأعداد حسب الحالة ومعدل النجاح.
- النتائج حسب حالة الاختبار: صف واحد لكل حالة اختبار.
- النتائج التفصيلية: لكل حالة اختبار النتيجة المتوقعة والفعلية، والمختبِر، والتاريخ، والتكوين، ومادة الاختبار، وملف الدليل، ونتائج الخطوات.
- الانحرافات والمشكلات المفتوحة: حالات الاختبار الفاشلة والمحجوبة مع عناصر Issue المرتبطة بها.
- أدلة الاختبار: ملفات الأدلة المسجلة في الدورة.
- حالة التحقق من المتطلبات: المتطلبات التي تتحقق منها المجموعة، مع حالتها من نتائج هذه الدورة.
يقدّم Excel ثلاث أوراق (Results، Steps، Requirements)؛ ويقدّم CSV وصفحة الويب جدول النتائج. وتأتي النتائج من الدورة كما حُفظت، فيبقى التقرير نفسه بعد إعادة تعيين المجموعة. وتأتي الأسماء والمتطلبات المتحقَّق منها وعناصر Issue من النموذج الحالي. وتعرض الدورات المحفوظة قبل الاحتفاظ بنتائج الخطوات والأدلة تلك الحقول بوصفها “—”.
لوضع جدول النتائج في مستند، أدرج كتلة مصفوفة تقرير الاختبار (انظر أعلاه).
وسم المستندات والصادرات
الوسم نص يطبعه Holarch على كل ما تصدّره: رأس أعلى كل صفحة، وتذييل أسفل كل صفحة، وإشعار في الصفحة الأولى. عيّنه مرة واحدة للمشروع، أو للمؤسسة، فيحمله كل تصدير. ويمكن للمستند استبداله بوسمه الخاص.
ملاحظة: لا يمكن للخدمة المستضافة (app.holarch.app) أن تحتفظ بمعلومات CUI أو مصنَّفة أو خاضعة لمراقبة التصدير (شروط الاستخدام). وهناك تستبعد القائمة القياسية بيانات التوزيع من B إلى F وإشعار مراقبة التصدير، ولا يُحفظ الوسم الذي يذكر CUI، أو مستوى تصنيف (مثل SECRET//NOFORN)، أو ITAR، أو EAR، أو مراقبة التصدير، أو بيانات التوزيع من B إلى F: “لا يمكن لخدمة Holarch المستضافة أن تحتفظ بمعلومات CUI أو مصنَّفة أو خاضعة لمراقبة التصدير، لذا لا يمكن استخدام هذا الوسم هنا. أزله، أو استخدم تطبيق سطح المكتب أو تثبيتًا مستضافًا ذاتيًا.” وتبقى إشعارات الشركة مثل Company Confidential وDistribution Statement A وحقوق النشر وأرقام العقود متاحة. ويُحتفظ بالوسوم المعيّنة قبل هذه القاعدة وتظل تُطبع؛ ولتغيير أحدها، أزل الجزء المقيَّد.
يقدّم تطبيق سطح المكتب والتثبيتات المستضافة ذاتيًا القائمة كاملة ويقبلان أي وسم. والوسوم نص تختاره؛ ويطبعها Holarch لكنه لا يفرض قواعد التعامل، وتنطبق ضوابط مؤسستك الخاصة. وفي كل إصدار يوقف إشعار مراقبة التصدير في الوسم الذكاء الاصطناعي للمشروع.
تملأ قائمة وسم قياسي النص نيابةً عنك:
| الوسم القياسي | الرأس | التذييل | الإشعار |
|---|---|---|---|
| Company Proprietary | COMPANY PROPRIETARY | COMPANY PROPRIETARY | إشعار ملكية يسمّي الشركة |
| Company Confidential | COMPANY CONFIDENTIAL | COMPANY CONFIDENTIAL | إشعار سرية يسمّي الشركة |
| Distribution Statement A إلى F (من B إلى F: تطبيق سطح المكتب والاستضافة الذاتية فقط) | (لا شيء) | DISTRIBUTION STATEMENT A to F | الصياغة القياسية للبيان لدى DoD (DoDI 5230.24)، مع ملء السبب وتاريخ التحديد والمكتب المسؤول |
| إشعار مراقبة التصدير (ITAR/EAR) (تطبيق سطح المكتب والاستضافة الذاتية فقط) | (لا شيء) | Export-controlled technical data. See the notice on the first page. | تحذير بأن المستند قد يحتوي على بيانات تقنية خاضعة لـ ITAR (22 CFR 120–130) أو EAR (15 CFR 730–774) |
| Copyright | (لا شيء) | © السنة صاحب حقوق النشر. All rights reserved. | (لا شيء) |
| رقم العقد | (لا شيء) | Contract No. رقم العقد | (لا شيء) |
يبقى الحقل الذي تتركه فارغًا في النص عنصرًا نائبًا بين قوسين معقوفين، مثل [reason]. ثم يعرض المحرر “أكمل الأجزاء الواقعة بين قوسين قبل التصدير.”
تعيين وسم المشروع
- اضغط ⌘K / Ctrl+K واختر علامة المشروع…. ويمكنك أيضًا فتحه من إعداد الصفحة… في مستند، أو من تفضيلات المشروع… (الرئيسية ▾ في الصفحة الرئيسية) للمشروع المفتوح.
- اختر وسم خاص.
- في وسم قياسي، اختر إدخالًا، واملأ حقوله (مثل الشركة) وانقر إضافة إلى الوسم.
ترى الرأس والتذييل والإشعار ممتلئة. أضف إدخالًا آخر لدمجها: تُضم الرؤوس والتذييلات بـ “ · ”، ويصبح كل إشعار فقرة مستقلة.
- حرّر النص إن احتجت، ثم انقر حفظ.
يقرأ الإشعار “حُفظ وسم المشروع.” ولا يغيّر وسم المشروع إلا مالكو المشروع؛ ويراه الأعضاء الآخرون للقراءة فقط.
يفرغ مسح الحقول الثلاثة. ويوقف دون وسم الوسم للمشروع، حتى عندما يكون للمؤسسة وسم.
تعيين وسم المؤسسة
- افتح قائمة الحساب واختر إعدادات المؤسسة، ثم افتح المؤسسة.
- تحت وسم المستند، انقر تحرير الوسم….
- عيّن الوسم كما للمشروع وانقر حفظ.
يقرأ الإشعار “حُفظ وسم المؤسسة.” وينطبق على كل مشروع في المؤسسة ليس له وسم خاص. ولا يغيّره إلا مسؤولو المؤسسة.
منح مستند وسمه الخاص وصفحة غلاف وأرقام صفحات
- في مستند، افتح التسليم ▾ واختر إعداد الصفحة….
- تحت الوسم، اختر واحدًا:
- وسم المشروع أو المؤسسة (الافتراضي): يسمّي السطر أدناه الوسم الذي يستخدمه المستند.
- وسم خاص: عيّن الرأس والتذييل والإشعار كما للمشروع.
- دون وسم: لا يحمل المستند وصادراته أي وسم.
- املأ الباقي:
- صفحة الغلاف، مع الإصدار وأعدّه. وتعرض صفحة الغلاف الإشعار أيضًا.
- أرقام الصفحات (“الصفحة X من Y”) في صادرات Word.
- انقر تطبيق.
يقرأ الإشعار “حُفظ إعداد الصفحة.” ويظهر الرأس والتذييل أعلى المستند وأسفله، والإشعار تحت عنوانه. ويتراجع ⌘Z / Ctrl+Z عن التغيير في خطوة واحدة.
يغلب الوسم الأقرب: وسم المستند الخاص، وإلا فوسم المشروع، وإلا فوسم المؤسسة.
أين تُطبع الوسوم
- عرض المستند وطباعة أو PDF…: الرأس والتذييل أعلى كل صفحة وأسفلها، والإشعار تحت العنوان.
- تصدير Word (التسليم ▾ ← {template} (Word)، أو المستند (Word) في كل الصادرات…): يتكرر الرأس والتذييل في كل صفحة، مع أرقام الصفحات إن اختيرت، وتحل صفحة الغلاف محل العنوان العادي. وتصبح كتلة المصفوفة الحية في المستند جدول Word بعنوانه فوقه، وبعروض الأعمدة نفسها ورؤوس I/A/D/T، مع تظليل فجواته باللون الأحمر.
- تصدير المصفوفة ومصفوفة التتبع (Word) أو (HTML).
- ملفات Word الأخرى: تحمل صادرات مستند ICD والعرض التقديمي والمخطط والتفصيل (Word) الرأس والتذييل في كل صفحة والإشعار تحت العنوان.
- تقارير Excel: يدخل الرأس والتذييل في رأس الصفحة وتذييلها لكل ورقة، ويعرضهما Excel في طريقة عرض تخطيط الصفحة ويطبعهما.
- CSV: فقط عندما تحدد العلامة كسطر أول في جدول (CSV). وهو متوقف افتراضيًا، فيُستورد الملف مرة أخرى كما هو.
- صور المخططات: تحصل صادرات PNG وSVG على شريط فوق المخطط بالرأس وشريط تحته بالتذييل والإشعار. وتعرضها صادرات صفحة ويب (HTML) أعلى الصفحة وأسفلها. وتبقى الصور المصغّرة وصور المخططات داخل المستندات دون وسم.
- العروض التقديمية: تعرض شرائح PowerPoint وصفحة الويب وPNG وSVG الرأس والتذييل في كل شريحة والإشعار في الشريحة الأولى.
- للـ تجميع إعداد صفحة خاص به، يُستخدم عند تصدير التجميع.
فحوص النموذج
تُبلغ فحوص النموذج عن قيمة حية أو جدول حي يشير إلى شيء محذوف (القاعدة Global.7، “قيم حية تشير إلى أهداف مفقودة”):
- قيمة حية حُذف كيانها تعرض “{Entity: … Not found}”.
- كتلة مصفوفة حُذف مستند نطاقها، أو كتلة تقرير الاختبار حُذفت مجموعة اختبارها أو دورة اختبارها، أو مصفوفة مخصصة لم تعد علاقتها موجودة.
- العدد أو الإجمالي أو جدول حي يسمّي استعلامه فئة أو تسمية أو علاقة أو مستندًا غير موجود.
- إسناد ترافقي حُذف عنصره أو شكله أو جدوله.
افتح الوصف، ثم حرّر القيمة الحية أو أزلها، أو أدرجها مرة أخرى لهدف موجود. انظر فحوص النموذج.
نصائح
- ضع RVTM أو VCRM في نهاية المواصفة بوصفها قسم التحقق فيها؛ فتبقى محدَّثة حتى المراجعة.
- لحزمة مراجعة، ابنِ تجميعًا وامنحه صفحة غلاف ووسمًا في إعداد الصفحة الخاص به.
- صدّر VCRM إلى Excel لمجلس مراجعة يعلّق عليها، واحتفظ بالكتلة الحية في المستند.
- لخطة تحقق منظمة حسب مستوى التكامل، استخدم VCRM حسب مستوى التحقق وعيّن مستوى التحقق لكل متطلب أولًا.
- لمستند التحكم في الواجهات، أدرج مصفوفة الواجهات بنطاق Asset النظام، فتظهر عناصره الفرعية وعناصر Conduit الخاصة بها على القطر وفي الخلايا.