المتطلبات
الروابط إلى مشاريع أخرى
تتبّع عنصرًا إلى متطلب أو وظيفة أو اختبار في مشروع آخر؛ لا يرى كل شخص العنصر المرتبط إلا إذا كان بإمكانه فتح مشروعه.
في هذه الصفحة
نظرة عامة
الرابط إلى مشروع آخر علاقة تتبع من عنصر في هذا المشروع إلى عنصر في مشروع مختلف، مثل متطلب نظام فرعي traced from متطلب في مواصفة النظام، أو إجراء اختبار verifies متطلبًا يحتفظ به فريق آخر.
الرابط جزء من هذا المشروع. ولا يخزّن إلا معرّفي العنصرين والعلاقة. ويُقرأ رقم العنصر المرتبط واسمه وفئته وحالته من مشروعه في كل مرة تنظر فيها، بصلاحيات وصولك:
- عندما يمكنك فتح المشروع الآخر، ترى العنصر ويمكنك النقر للانتقال إليه.
- عندما لا يمكنك، ترى عنصر في مشروع لا يمكنك فتحه. ولا يصلك الاسم أبدًا، لا في التطبيق ولا في الصادرات ولا عبر API ولا عبر أدوات الذكاء الاصطناعي.
الروابط إلى مشاريع أخرى جزء من خطة Team. وخطة مالك المشروع هي التي تقرر. وفي الخطط الأخرى تبقى الروابط الموجودة ظاهرة ويمكن إزالتها، لكن لا يمكن إضافة روابط جديدة. وتعمل الروابط بين المشروعين التجريبيين Hybrid Car وHybrid Car Battery Pack في كل خطة.
المفاهيم
ما يحتويه الرابط
| الجزء | المعنى |
|---|---|
| المصدر | عنصر من هذا المشروع |
| العلاقة | علاقة من المخطط الهيكلي لهذا المشروع، مثل traced from أو satisfies أو verified by |
| الهدف | معرّف مشروع ومعرّف عنصر فيه |
تُفحص العلاقة مقابل فئة المصدر. ولا تُفحص فئة الهدف عند إنشاء الرابط، لأن الرابط لا يقرأ أبدًا محتوى المشروع الآخر. وعندما لا تلائم فئة الهدف العلاقة، يعرض قسم التتبع ⚠ مع “لا تشير هذه العلاقة عادةً إلى …”.
من يرى ماذا
يرى كل شخص كل عنصر مرتبط بالدور الذي له في مشروعه:
| وصولك إلى المشروع الآخر | ما تراه |
|---|---|
| أي دور (Owner، Editor، Reviewer، Viewer) | الرقم والاسم والمشروع، ورابط يفتح العنصر |
| لا شيء، أو لم يعد المشروع موجودًا | عنصر في مشروع لا يمكنك فتحه |
يبدو المشروع غير الموجود والمشروع الذي لا يمكنك فتحه متماثلين، فلا يخبرك الرابط أبدًا بأن مشروعًا ما موجود.
حالات الرابط
| المعروض | المعنى | ما العمل |
|---|---|---|
| الرقم والاسم | العنصر موجود ويمكنك فتح مشروعه | لا شيء |
| محذوف في <project> | العنصر في سلة المحذوفات لمشروعه | اطلب من شخص يمكنه تحرير ذلك المشروع استعادته، أو أزل الرابط |
| محذوف | لم يعد العنصر موجودًا | أزل الرابط (إزالة الروابط المعطلة) |
| عنصر في مشروع لا يمكنك فتحه | لا وصول لك إلى المشروع، أو لم يعد موجودًا | اطلب الوصول من مالك المشروع إن احتجت إليه |
| جارٍ التحميل… | يجري قراءة العنصر | انتظر لحظة |
تُقرأ الأسماء عندما تعرض صفحة الرابط، ومرة أخرى عندما تعود إلى علامة التبويب بعد دقيقة، وكل خمس دقائق. ويعرض العنصر المعاد تسميته اسمه الجديد دون أي تغيير في هذا المشروع.
الأهداف المتغيرة
يعرض الصف متغير عندما يُحرَّر العنصر المرتبط في مشروعه بعد إنشاء الرابط أو آخر مراجعة له. أشر إليه لمعرفة التاريخ. تحقق من أن الرابط لا يزال صحيحًا، ثم:
- انقر ✓ على الصف لتعليم ذلك الرابط كمُراجَع.
- انقر ⋯ بجوار مشاريع أخرى، ثم تعليم الكل كمُراجَع (n)، لكل رابط معلَّم للعنصر.
- أو افتح الاحتياجات والمتطلبات ← روابط للمراجعة: تسرد البطاقة تغيّر في مشاريع أخرى كل رابط معلَّم في المشروع، مع ✓ لكل صف وتعليم الكل كمُراجَع.
يظهر التعليم كمُراجَع في سجل العنصر وفي النشاط، ويُلغيه تراجع واحد. ويرى المراجعون والمشاهدون العلامات لكن لا يمكنهم مسحها. ولا تُعلَّم الروابط إلى إصدارات المكتبات (فالإصدار لا يتغير).
طريقة استخدامها
متى ولماذا
استخدم الروابط إلى مشاريع أخرى عندما يكون النموذج الواحد كبيرًا جدًا أو تملكه فرق مختلفة: مواصفة نظام ومواصفات أنظمتها الفرعية، أو المتطلبات المشتركة لخط منتجات وكل منتج، أو متطلبات عميل وتصميمك. واحتفظ بالروابط في المشروع ذي المستوى الأدنى، مشيرة إلى الأعلى: يتتبع كل نظام فرعي متطلباته من متطلبات النظام.
استخدم العلاقات العادية داخل مشروع واحد. فـ ربط عنصر موجود… في قسم التتبع يربط عناصر المشروع نفسه؛ والرابط إلى مشروع آخر مخصص للعناصر الموجودة في مكان آخر.
إضافة رابط
- حدّد العنصر، مثل متطلب نظام فرعي.
- في لوحة الخصائص، افتح قسم التتبع. وتحت مشاريع أخرى، انقر + (إضافة رابط إلى مشروع آخر…).
- اختر العلاقة، مثل traced from.
- اختر المشروع. وتُسرد عناصره حسب الرقم.
- لمكتبة، اختر الإصدار: الحالي (نسخة العمل) أو إصدارًا مثل Release 1.1. ويعرض الرابط إلى إصدار تسميته بدلًا من الحالي، ولا يفتح اسمه صفحة.
- اكتب في بحث للعثور على عنصر بالرقم أو الاسم. واختر الفئة لسرد تلك الفئة فقط.
- انقر العنصر، ثم انقر إضافة رابط. ويقول الإشعار “أُضيف الرابط.” ويظهر العنصر تحت مشاريع أخرى.
يُزيل تراجع واحد الرابط. وإضافة الرابط نفسه مرة أخرى تُبقي الرابط الموجود.
فتح العنصر المرتبط
انقر اسم العنصر المرتبط. فيُفتح مشروعه عند ذلك العنصر.
إزالة الروابط
- انقر × على صف الرابط لإزالة رابط واحد.
- عندما تشير الروابط إلى عناصر محذوفة، انقر ⋯ بجوار مشاريع أخرى، ثم إزالة الروابط المعطلة (n).
لا تغيّر إزالة الرابط إلا هذا المشروع. ولا يتغير المشروع الآخر أبدًا بسبب رابط.
مثال عملي: نظام فرعي للحمولة والمشروع التجريبي CubeSat EO-1
- أنشئ مشروعًا باسم EO-1 Payload فيه متطلب PL.1 Detector pixel pitch shall be at most 5.5 µm.
- حدّد PL.1، وافتح التتبع ← مشاريع أخرى ← +.
- اختر traced from، والمشروع CubeSat EO-1، وابحث عن ground sample، وانقر 1.2 Ground Sample Distance. ثم انقر إضافة رابط.
- يقرأ الصف traced from 1.2 Ground Sample Distance CubeSat EO-1 · الحالي. ويرى زميل لا يمكنه فتح سوى EO-1 Payload العبارة عنصر في مشروع لا يمكنك فتحه في الصف نفسه.
نصائح وممارسات جيدة
- اربط من المستوى الأدنى إلى المستوى الأعلى، فلا يضطر مشروع النظام إلى التغيير عند إضافة نظام فرعي.
- شارك المشروع ذا المستوى الأعلى بدور Viewer مع من يعملون على المشروع ذي المستوى الأدنى، ليروا الأسماء.
- شغّل إزالة الروابط المعطلة بعد إعادة تنظيم مشروع ذي مستوى أعلى.
أخطاء شائعة
| المشكلة | السبب | الإصلاح |
|---|---|---|
| “هذا العنصر في هذا المشروع. استخدم ربط عنصر موجود… بدلًا من ذلك.” | الهدف في المشروع نفسه | استخدم ربط عنصر موجود… في مجموعة العلاقة |
| لا يوجد + تحت مشاريع أخرى | لا يمكنك سوى عرض المشروع، أو العنصر مقفل | اطلب دور Editor، أو ألغِ قفل العنصر |
| “الروابط إلى عناصر في مشاريع أخرى جزء من خطة Team.” | مالك المشروع ليس على خطة Team | رقِّ الخطة في إعدادات الحساب ← الخطة والفوترة |
| يقول المنتقي “لا يمكن قراءة هذا المشروع. اختر مشروعًا آخر.” | فقدت الوصول إلى ذلك المشروع | اطلب الوصول من مالكه |
كيف يرتبط بالميزات الأخرى
- مصفوفة التتبع: تُسرد الروابط من الصفوف عبر العلاقات المختارة تحت الشبكة ضمن مشاريع أخرى؛ ويضيفها تصدير… (انظر التتبع).
- مخطط Spider: تظهر العناصر المرتبطة مربعات متقطعة حول عنصرها؛ أوقفها بـ الخيارات ← مشاريع أخرى.
- خريطة البرنامج: يعرض إدارة المشاريع ← خريطة البرنامج كيف ترتبط كل مشاريعك، ويتتبع مشاريع أخرى ⋯ ← عرض في Program Map هذا العنصر عبر المشاريع الأخرى (انظر خريطة البرنامج).
- تغطية البرنامج: يسرد المشروع الذي تربط به هذه الروابط في التحقق ← تغطية البرنامج، حسب العنصر والمشروع (انظر تغطية البرنامج).
- السجل والنشاط: تُسجَّل إضافة الرابط وإزالته على العنصر.
- سلة المحذوفات: ينقل حذف عنصر روابطه معه إلى سلة المحذوفات؛ واستعادة العنصر تستعيدها.
- طلبات التغيير: يجهّز إضافة تغيير ▾ ← إضافة رابط إلى مشروع آخر… وإزالة رابط إلى مشروع آخر… الروابط؛ وتُضاف أو تُزال عند تطبيق الطلب.
- المكتبات: اربط بعنصر من إصدار مكتبة باختيار الإصدار (انظر المكتبات).
الصادرات والتقارير
تسمّي الصادرات العناصر المرتبطة بصلاحيات وصول الشخص الذي يصدّر. وكل ما لا يستطيع ذلك الشخص قراءته يُكتب “عنصر في مشروع آخر”.
| تصدير | ما يحدث للروابط إلى مشاريع أخرى |
|---|---|
| JSON المشروع (تصدير قاعدة البيانات) | تُحفظ كما خُزّنت: المعرّفات فقط. ويحتفظ استيراد الملف بها |
| ReqIF (قاعدة البيانات والمستندات) | سمة External links على كل عنصر مرتبط: العلاقة ومعرّف المشروع ومعرّف العنصر، إضافة إلى الرقم والاسم عندما يمكنك قراءتهما |
| XMI | تُستبعد؛ ويعدّها تقرير التصدير بوصفها “رابط إلى مشروع آخر” |
| مصفوفة التتبع (Excel) | ورقة مشاريع أخرى منفصلة |
| مصفوفة التتبع (CSV) | عمود مشاريع أخرى |
| تقرير مصفوفة تتبع المتطلبات (RTM) | عمود Other Projects |
API وMCP
يُرجع API وMCP الروابط معرّفات. ولقراءة الأسماء، استدعِ عملية resolve؛ فهي تستخدم صلاحيات وصول الرمز المميز نفسه وقائمة مشاريعه. وتتوفر خريطة البرنامج وتتبع العنصر عبر GET /api/v1/program-map وGET /api/v1/projects/<project>/items/<item>/trace وأداتي MCP program_map وtrace_chain. انظر API وMCP.
لا تتلقى ميزات الذكاء الاصطناعي في التطبيق الروابط إلا معرّفات.
الرسائل
| الرسالة | المعنى |
|---|---|
| أُضيف الرابط. | حُفظ الرابط |
| هذا العنصر في هذا المشروع. استخدم ربط عنصر موجود… بدلًا من ذلك. | العنصر المختار في المشروع نفسه |
| اختر عنصرًا، ثم أضف الرابط. | نُقر إضافة رابط دون اختيار عنصر |
| لا مشاريع أخرى للربط بها. أنشئ مشروعًا آخر أو افتحه أولًا. | ليس لديك إلا هذا المشروع |
| الروابط إلى عناصر في مشاريع أخرى جزء من خطة Team. | مالك المشروع ليس على خطة Team |
| يحتوي المشروع على 20,000 رابط إلى مشاريع أخرى على الأكثر. أزل بعضها أولًا. | بلغ المشروع الحد |
الحدود
| الحد | القيمة |
|---|---|
| الروابط لكل مشروع | 20,000 |
| العناصر المقروءة لكل طلب | 500 |
| العناصر المسرودة في المنتقي | 100 لكل بحث (ضيّق البحث لرؤية غيرها) |
يشير الرابط إلى الإصدار الحالي من المشروع الآخر، أو إلى نسخة عنصر في إصدار مكتبة (انظر المكتبات).