إضافة إجراء إلى تاريخ عميل العقار

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

الشكل 14-7: تاريخ عميل العقار

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

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

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

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

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

• إدارة العقارات

• مكتبة 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": "UNIQUE_ID_TO_IDENTIFY_THIS_ACTION",
   
   "label": "Custom Action",
   
   "active": true,
   
   "context": {
   
   "type": "Url",
   
   "url": "https://test.url.com/trunk/${from}.html?component=${customerClass}&demo=${billingAccountId}",
   
   "windowName": "_blank",
   
   "params": [
   
   {
   
   "name": "from",
   
   "value": "jetCookbook"
   
   },
   
   {
   
   "name": "customerClass",
   
   },
   
   {
   
   "name": "billingAccountId"
   
   }
   
   ]
   
   }
   
   }
   
   ]

   تستخدم عينة التعليمات البرمجية هذه معلمتي customerClass وbillingAccountId في بيانات تعريف الإجراء، والتي يتم عرضها لاستخدامها في امتدادات Visual Builder. راجع متغير الصفحة UserActionParamsUiQuickActionBar للاطلاع على قائمة كاملة بالمعلمات التي نقوم بتصديرها، والتي تتضمن حاليًا:

   • customerClass

   • billingAccountId

   • setupDate

   • endDate

   • serviceTypes

   • mainCustomer

   • relatedParties

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

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

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

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

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

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

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

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

13. في حقل القيمة الافتراضية، أدخل المعرف الذي استخدمته في عينة التعليمات البرمجية أعلاه. على سبيل المثال، أدخل ["UNIQUE_ID_TO_IDENTIFY_THIS_ACTION"] في هذا الحقل. يجب أن تتطابق قيمة "id" مع معرف إجراء المستخدم الذي قمت بإنشائه.

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

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