Attribute Linker

ما هي الأداة ولماذا وُجدت

عندما تأتي المتطلبات من Excel أو ReqIF أو DOORS 9، نادراً ما يصل التتبع على شكل روابط. يصل على شكل نص: عمود مثل "Parent ID" أو "Satisfies" أو "Derived from" يحتوي على معرّف واحد أو أكثر أو مفاتيح قديمة. في الواجهة القياسية يجب تحويل كل مرجع من هذه المراجع إلى رابط يدوياً، عنصراً بعد عنصر.

يقرأ Attribute Linker تلك السمة، ويعثر على العنصر الذي يشير إليه كل مرجع، وينشئ الروابط في تشغيل واحد. يُبحث عن الأهداف بمعرّف DOORS Next في المشروع كله، أو بقيمة سمة (مثل "Legacy ID") في وحدة هدف.

المشكلات التي تحلّها

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

الفوائد

• لا يضيع أي مرجع: بعد التشغيل يُدرج كل مرجع بإحدى الحالات Linked أو Already linked أو Not found أو Ambiguous أو Self reference.
• لا تخمين أبداً: المرجع الذي يطابق عدة عناصر يُستبعد ويُدرج مع المرشحين.
• مطابقة مرنة: بمعرّف DOORS Next، أو بمفتاح قديم محفوظ في سمة لوحدة هدف؛ مع قوائم مفصولة بفواصل أو فواصل منقوطة أو مسافات أو أسطر جديدة.
• إعدادات افتراضية آمنة: تُنشأ الروابط في سياق الوحدة، كما يفعل DOORS Next داخل الوحدة؛ وعلى العناصر الأساسية فقط عندما تختار ذلك.
• تشغيل يتعافى من التوقف: تخطي الروابط الموجودة، والتقدم وStop، والمتابعة بعد التوقف في الوحدات الكبيرة جداً، وإعادة المحاولة عبر Retry للإخفاقات، وقائمة Excel بالمراجع غير المحلولة، وتقرير تغييرات بصيغة Excel.

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

1. أضف الأداة إلى ELM Mini Dashboard بجانب الوحدة.
2. في Settings انقر Change وحدّد Reference attributes التي تحتوي على المراجع، والفواصل، وطريقة العثور على الأهداف (Artifact ID أو Attribute in a module في وحدة هدف)، وLink type، وDirection، ثم انقر Done.
3. في Links، اختر Whole module، أو حدّد عناصر واختر Selection.
4. انقر Create links، واقرأ رسالة التأكيد ثم أكّد. يعثر الـ widget على المراجع وينشئ الروابط الناقصة في تشغيل واحد.
5. راجع كتلة النتيجة وقائمة References: يعرض المرشّح Not resolved كل مرجع تعذّر ربطه مع السبب. صدّرها إلى Excel عند الحاجة، ونزّل تقرير التغييرات عبر Log.

معلومات مفيدة

• لا تُربط المراجع الملتبسة ولا المراجع التي تشير إلى العنصر نفسه أبداً؛ تُدرج في القائمة ويمكن تصديرها إلى Excel.
• إذا تغيّرت قيمة سمة أثناء التشغيل، فلا يُمسّ ذلك العنصر ويُدرج في القائمة: شغّل Create links مرة أخرى.
• يوجد إعداد اختياري يفرّغ السمة عندما تُربط كل مراجعها؛ وهو معطّل افتراضياً.
• عندما تعمل ضمن تكوين عام (global configuration)، يمكن أن تكون الوحدة الهدف والعناصر التي يُعثر عليها بالمعرّف في مكوّن آخر من التكوين العام نفسه؛ وعندها تربط الروابط بين المكوّنات. أما في stream أو baseline واحد فلا يُستخدم إلا المكوّن المفتوح.
• اعمل دائماً داخل change set: التخلي عنه هو الطريقة الوحيدة لإلغاء الروابط التي أُنشئت.