Data Model URIs

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

يمكن أن يحمل كل نوع عنصر وسمة ونوع بيانات وقيمة تعداد في مشروع DOORS Next معرّف URI. وعلى هذه المعرّفات تعتمد التقارير وقوالب النشر وتكاملات OSLC والإعدادات العامة للتعرّف على السمة أو النوع "نفسه" في مشاريع وتدفقات مختلفة. ومن دونها يكون لكل مشروع معرّفاته الداخلية الخاصة، فيتعثّر العمل بين المشاريع.

يعني تعيين معرّفات URI يدويًا في خصائص المشروع فتح كل تعريف على حدة، وكتابة المعرّف، والحفاظ على اتّساق التسمية. وفي نموذج بيانات حقيقي، يعني ذلك مئات الإدخالات وساعات من العمل تتسلّل إليه أخطاء الكتابة. وتنجز Data Model URIs ذلك في خطوة واحدة، بمخطط تسمية واحد للنموذج كله.

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

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

الفوائد

• نمط واحد للنموذج كله: نطاقك أو خادمك، وبادئة لكل مجموعة، وتنسيق للأسماء (camelCase أو PascalCase أو snake_case أو kebab-case).
• انظر قبل أن تغيّر: أمثلة مباشرة أثناء ضبط النمط، ومعاينة لكل معرّف URI مع حالته.
• آمنة بطبيعة تصميمها: تُحفظ معرّفات URI الموجودة ما لم تختر استبدالها، ولا تُكتب المعرّفات المتعارضة أبدًا.
• تشمل قيم التعدادات وأنواع الروابط، وكل قيمة تعداد تحت معرّف URI لنوع بياناتها.
• تصدير إلى Excel للمعاينة ولما غيّرته كل عملية تشغيل، للمراجعة والتدقيق.

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

1. افتح المشروع في مجموعة تغييرات (موصى به) أو في تدفق. تقرأ الأداة نموذج بياناته.
2. انقر Change عند URI pattern وأدخل نطاقك أو خادمك، مثل https://example.com/ns، ثم اختر بادئة وتنسيقًا للأسماء لكل مجموعة. تتغيّر الأمثلة وفق اختياراتك.
3. راجع المعاينة: معرّفات URI الجديدة، والمعرّفات المعيّنة مسبقًا، والمعرّفات المحتفظ بها، وأي تعارضات. فعّل Replace URIs that are already set إذا كان يجب تغيير المعرّفات الموجودة. صدّر المعاينة إلى Excel إذا كان على آخرين التحقق منها.
4. انقر Set URIs وأكّد. يظهر التقدّم ويمكنك الإيقاف في أي وقت.
5. نزّل تقرير التغييرات بـ Log في كتلة النتيجة، وسلّم مجموعة التغييرات حين تكون راضيًا عن النتيجة.

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

• نوصي بالعمل داخل مجموعة تغييرات، لتتمكّن من مراجعة معرّفات URI الجديدة أو التخلّص منها قبل التسليم. لا يمكن تغيير الخط الأساسي.
• تُحوَّل الأسماء إلى كلمات URI نظيفة: تُزال علامات التشكيل والنبر، وتفصل المسافات والشرطات والأحرف الكبيرة بين الكلمات.
• استخدامات نموذجية: إعداد قالب مشروع، وتوحيد المشاريع قبل إعداد عام (Global Configuration)، وتمكين التقارير وتكاملات OSLC.
• التعريفات التي يملكها DOORS Next نفسه، مثل سمات النظام، تظهر للقراءة فقط ولا تتغيّر أبدًا. ولا تُدرج حالات سير العمل، لأن DOORS Next لا يسمح بحفظ معرّفاتها بهذه الطريقة.