إضافة إجراء إلى البحث عن الشخص والعقار

يمكنك استخدام VB Studio لإضافة إجراءات مخصصة إلى الزر "إجراء" في شاشة "البحث عن الشخص والعقار"، المتاحة في خدمة وكيل تجارب العملاء للخدمات والمرافق.

الشكل 14-1: البحث عن الشخص والعقار

يمكنك إضافة أنواع الإجراءات هذه:

• إجراء "فتح عنوان URL"

• إجراء "التنقل إلى الصفحة"

يوضح هذا المثال كيفية إضافة إجراء "فتح عنوان URL" أو إجراء "التنقل إلى الصفحة" إلى الزر.

يفترض هذا المثال أن القارئ يفهم كيفية استخدام VB Studio. لمزيد من المعلومات، راجع:

• استخدام البحث عن الشخص والعقار في دليل استخدام خدمة وكيل تجارب العملاء للخدمات والمرافق (Using CX for Utilities Agent Service Guide)

• مكتبة Visual Builder Studio في مركز تعليمات أوراكل

• تخصيص المتغيرات والثوابت في دليل توسيع تطبيقات الخدمة السحابية لأوراكل باستخدام Visual Builder Studio (Extending Oracle Cloud Applications with Visual Builder Studio Guide)

مثال: إضافة عنصر قائمة الإجراءات إلى البحث عن الشخص والعقار

1. قم بتسجيل الدخول إلى خدمة وكيل تجارب العملاء للخدمات والمرافق كمسؤول، وحدد علامة تبويب صفحة البحث عن الشخص والعقار.

2. انقر فوق القائمة الموجودة أعلى يمين الصفحة وحدد تحرير الصفحة في Visual Builder Studio.

3. حدد مساحة العمل وانقر تحديد. لاحظ أنه يمكنك أيضًا إنشاء مساحة عمل جديدة إذا لزم الأمر.

4. في لوحة واجهات مستخدم التطبيقات، قم بتوسيع تجارب العملاء (CX)، ثم قم بتوسيع تجارب العملاء للخدمات والمرافق، ثم قم بتوسيع المقاطع.

5. حدد المقطع نموذج-إجراء-المستخدم-e11y.

6. حدد علامة التبويب الفرعية المتغيرات لعرض الثوابت والمتغيرات.

7. انقر فوق الثابت USER_ACTION_CONTEXT_LIST.

8. على الجانب الأيمن من الشاشة، أدخل عينة التعليمات البرمجية التالية في حقل القيمة الافتراضية، والتي ستضيف إجراء "فتح عنوان URL":

   [
   
   {
   
   "id": "CUSTOM_ACTION_NAME",
   
   "label": "Custom Menu Label",
   
   "active": true,
   
   "context": {
   
   "type": "Url",
   
   "url": "https://custommenuname.html?component=${component}&demo=${demo}&testId=${testId}",
   
   "params": [
   
   {
   
   "name": "component",
   
   "value": "menu"
   
   },
   
   {
   
   "name": "demo",
   
   "value": "overview"
   
   },
   
   {
   
   "name": "testId",
   
   "scope": "ui"
   
   }
   
   ]
   
   }
   
   }
   
   ]

   يمكنك أيضًا إضافة إجراء "التنقل إلى الصفحة" عن طريق استبدال عينة التعليمات البرمجية أعلاه بعينة التعليمات البرمجية هذه:

   [
   
   {
   
   "id": "CUSTOM_ACTION_NAME",
   
   ...
   
   },
   
   {
   
   "id": "NAVIGATE_ACTION_NAME",
   
   "label": "Navigate to digital-sales page",
   
   "active": true,
   
   "context": {
   
   "type": "InAppNavigation",
   
   "appName":  "digital-sales",
   
   "appPage": "es/p/mycustomers/contacts",
   
   "windowName": "_blank",
   
   "params": [
   
   {
   
   "name": "puid",
   
   "alias": "partyNumber"
   
   }
   
   }
   
   }
   
   ]

9. في حالة وجود معلمات امتدادات تريد استخدامها في معلمات سياق بيانات تعريف الإجراء، قم بإكمال الخطوات التالية:

   1. ارجع إلى علامة تبويب "رئيسي-جهات الاتصال-بدء" وحدد علامة التبويب الفرعية المتغيرات.

   2. انقر فوق الثابت USER_ACTION_PARAMS_HEADER_ACTIONS.

   3. في حقل القيمة الافتراضية، أدخل تعيين القيمة لمعلمات الامتداد:

      [[
      
      [
      
      {
      
      "name": "testId",
      
      "value": $page.variables.testId
      
      }
      
      ]
      
      ]]

10. انقر فوق علامة التبويب الفرعية JSON لعرض طريقة عرض يمكنك من خلالها تحرير عينة التعليمات البرمجية هذه بسهولة وتحديث عينة التعليمات البرمجية بحيث تعكس القيم المخصصة.

11. ارجع إلى علامة تبويب رئيسي-جهات الاتصال-بدء وحدد علامة التبويب الفرعية المتغيرات.

12. انقر فوق الثابت USER_ACTION_UI_HEADER_ACTIONS.

13. في حقل القيمة الافتراضية، أدخل المعرف الذي استخدمته في عينة التعليمات البرمجية أعلاه. على سبيل المثال، أدخل ["CUSTOM_ACTION_NAME"] في هذا الحقل.

14. قم بمعاينة التغييرات للتأكد من أنها تبدو كما توقعت. سيؤدي ذلك إلى فتح علامة تبويب جديدة تحتوي على البحث عن الشخص والعقار. تحقق من أن الخيار الجديد متاح، وأنه ينتقل إلى عنوان URL المناسب.

15. عندما تكون تغييراتك جاهزة للاستخدام، أكمل الخطوات لنشر التغييرات إلى بيئة الإنتاج الخاصة بك.