مثال: استرجاع العناصر من التطبيقات التي تدعم RESTful API

يقوم هذا المثال بتوضيح كيفية استرجاع عناصر من تطبيق ادارة المتطلبات الى Rational solution for Collaborative Lifecycle Management وتكوين عناصر في IBM® Rational Focal Point.

الغرض

اذا كان لديك متطلبات في تطبيق ادارة المتطلبات وتريد تحديد الأولويات الخاصة بهم في Rational Focal Point، يمكنك استخدام أمر مشاهدة الوحدة التابعة REST لاسترجاع المتطلبات.
المتطلبات الرئيسية:
  • حدد عنوان IP واسم النظام الرئيسي لوحدة خدمة Rational solution for CLM في ملف النظام الرئيسي بالحاسب من حيث تقوم بتوصيف التكامل. بالنسبة لنظام Windows، يوجد ملف النظام الرئيسي في C:\Windows\System32\drivers\etc وبالنسبة لنظام Linux يوجد ملف النظام الرئيسي في /etc/hosts.
  • اضافة تطبيق ادارة المتطلبات على أنه الأصدقاء (صادر) في Rational Focal Point. للحصول على المزيد من المعلومات، أنظر التوصل الى وحدة خدمة تطبيق Rational solution for Collaborative Lifecycle Management..
  • يجب أن تكون على دراية بهيكل XML لعناصر تطبيق ادارة المتطلبات وأن يتوافر لديك امكانية التوصل اليهم.

مثال

يقوم هذا المثال بافتراض أن Rational Focal Point لديه مساحة عمل FP-RRC ومشاهدة مشاهدة متطلبات RRC. يعرض الجدول بعض الخصائص المميزة المتاحة في Rational Focal Point وتطبيق ادارة المتطلبات.
جدول 1. الخصائص المميزة الى Rational Focal Point وتطبيق ادارة المتطلبات
خصائص Rational Focal Point المميزة الخصائص المميزة لتطبيق ادارة المتطلبات
اختيار الوقود rrm:description
استهلاك الوقود rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
وصلة التكامل rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
العنوان ds:location/ds:project/rrm:title
  1. في Rational Focal Point، قم بفتح مساحة العمل FP-RRC حيث تريد استرجاع العناصر.
  2. اضغط توصيف > أمر مشاهدة الوحدة التابعة REST ثم اضغط اضافة أمر مشاهدة.
  3. في اسم موصل الوحدة التابعة REST، أدخل موصل RRC لتعريف الوصلة.
  4. في الطريقة REST Request Method، حدد الطريقة GET.
  5. في كشف الأصدقاء، حدد RRC.
  6. في عنوان URL لطلب تطبيق REST، أدخل عنوان URL للتطبيق الذي يحتوي على العناصر التي تريد استرجاعها. على سبيل المثال, للحصول على العناصر من تطبيق ادارة المتطلبات, أدخل https://<hostName>:<portNumber>/rm/<projectName>/<collectionName>
    تلميح: قم بفتح برنامج استعراض الانترنت ثم أدخل عنوان URL الذي قمت باستخدامه عند اضافة تطبيق ادارة المتطلبات كصديق. سيتم عرض كشف بالعناصر ذات أعلى مستوى. قم بايجاد العناصر التي تريد استرجاعها وقم بنسخ عنوان URL الخاص بها في عنوان URL لطلب تطبيق REST.
  7. اضغط اتصال.
  8. اضغط تحديد XPath للدليل الرئيسي لقصر البحث الخاص بك على عناصر مجموعة. حدد /ds:dataSource/ds:artifact. يتم استخدام XPath لتقليل نطاق البحث بالنسبة للعناصر. يعد XPaths هيكل XML متدرج لتطبيق.
  9. للتأكد من أن العناصر غير مكررة، في قسم مناظرة الكود، اضغط اضافة ثم قم بمناظرة Fuel choice الى Rational Focal Point و rrm:description بتطبيق ادارة المتطلبات. يمكنك مناظرة خاصية مميزة واحدة.
  10. في قسم مناظرة الخصائص المميزة، اضغط اضافة لمناظرة الخصائص المميزة التالية بين تطبيق ادارة المتطلبات وRational Focal Point. يتم عرض الخصائص المميزة التي تم مناظرتها بالنسبة الى العناصر التي تم استرجاعها من التطبيق. تأكد من أن الخصائص المميزة يمكن تحريرها.
    ملاحظة: الخاصية المميزة التي قمت بتحديدها في قسم مناظرة أكواد التعريف لا يتم عرضها في قسم مناظرة الخصائص المميزة لأن هذه الخاصية المميزة يتم مناظرتها داخليا وتكون متاحة بالنسبة للعناصر التي تم احضارها.
    جدول 2. مناظرة الخصائص المميزة بين Rational Focal Point وتطبيق ادارة المتطلبات
    خصائص Rational Focal Point المميزة الخصائص المميزة لتطبيق ادارة المتطلبات
    استهلاك الوقود rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
    وصلة التكامل rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
    العنوان ds:location/ds:project/rrm:title
  11. في مجال نسق التاريخ الذي يتم دعمه لتطبيق REST، أدخل 2012-08-18.
  12. في مجال فاصل Focal Point، قم بالاحتفاظ بالعلامة , كما هي.
  13. اضغط حفظ .
  14. قم بفتح مشاهدة مشاهدة متطلبات RRC ثم حدد موصل RRC من الكشف المسقط. سيتم استرجاع كشف بالمتطلبات والخصائص المميزة وسيتم تكوينها كعناصر في المشاهدة.

تعليق تقييمي