في هذه المقالة
نظرة عامة
dropdown icon
خصائص المستوى الأعلى لتخطيط JSON
    عنوان التطبيق
    شعار
    رسم توضيحي لصفحة المهام
    إيقاف التنقل عند قبول المهمة
    تم تمكين السحب
    مؤقت الإخطار
    الحد الأقصى لعدد الإشعارات
    مؤقت إشعار المتصفح
    تم تكوينه باستخدام Wxm
    تطبيق دردشة سطح المكتب
    إجراءات الرأس
    منطقة
    عنوان متقدم
dropdown icon
الصفحة الرئيسية
    تكوين تخطيط الصفحة الرئيسية
dropdown icon
التنقل (صفحات مخصصة)
    سمات علامات التبويب الدائمة
تكوين عناصر واجهة المستخدم الثابتة
أدوات رأس الصفحة
لوحة المعلومات الإضافية
أدوات بدون رأس
مشاركة البيانات من سطح المكتب إلى الأدوات
دعوة حملة المعاينة
سكرين بوب
أمثلة حالة استخدام العينة
التعريب

إنشاء تخطيط سطح مكتب مخصص

list-menuفي هذه المقالة
list-menuهل لديك ملاحظات؟

تساعد هذه المقالة في إنشاء تخطيط مخصص عن طريق تحرير ملف JSON وتقدم نماذج لحالات الاستخدام لمساعدتك على البدء باستخدام الأدوات مثل أداة مقاييس إدارة تجربة العملاء وأداة رحلة تجربة العملاء. للعمل بفعالية مع تخطيطات سطح المكتب المخصصة، يجب أن يكون لديك فهم قوي لبنية HTML ونموذج شجرة المستندات في المستعرض وتنسيق JSON.

نظرة عامة

تتيح لك ميزة تخطيط سطح المكتب تكوين سطح مكتب Webex Contact Center وفقًا لمتطلبات عملك. يمكنك تخصيص عناصر مثل الشعار والعنوان والأدوات. يمكنك إنشاء تخطيط سطح مكتب وتعيينه لفريق. يعمل هذا التخطيط على إنشاء تجربة الوكيل على سطح المكتب لجميع الوكلاء الذين يسجلون الدخول كجزء من هذا الفريق.

هناك نوعان من التخطيطات:

  • التخطيط العام: هذا التخطيط هو تخطيط تم إنشاؤه بواسطة النظام ويتم تعيينه افتراضيًا عند إنشاء فريق. لمزيد من المعلومات، راجع إدارة الفرق. عند إنشاء فريق، يتم تعيين المخطط العام تلقائيًا كتخطيط سطح مكتب للفريق. لا يمكنك حذف هذا التخطيط.

  • تخطيط مخصص: تخطيط يوفر تجربة سطح مكتب مخصصة. يمكنك إنشاء تخطيط مخصص لفريق واحد أو أكثر.

إذا قمت بتعيين تخطيط سطح مكتب جديد عند تسجيل دخول الوكيل، يجب على الوكيل إعادة تحميل الصفحة لمشاهدة التخطيط الجديد.

يدعم سطح مكتب Webex Contact Center ثلاث شخصيات:

  • وكيل

  • المشرف

  • المشرف والوكيل

يحتوي ملف تخطيط JSON على أقسام منفصلة لكل شخصية. يجب على المسؤول تكوين الإعدادات لكل شخصية في القسم المقابل من ملف تخطيط JSON. لمزيد من المعلومات حول نموذج ملف تخطيط JSON، راجع خصائص المستوى الأعلى لتخطيط JSON.

عندما تضيف Cisco ميزة جديدة إلى تخطيط سطح المكتب، يتم تحديث التخطيط غير المعدل تلقائيًا بالميزات الجديدة. تخطيط سطح المكتب المحدث متاح تلقائيًا للفرق الحالية التي تستخدم تخطيط سطح المكتب غير المعدل. يتلقى مستخدمو سطح المكتب الذين يستخدمون تخطيط سطح المكتب غير المعدل الميزات الجديدة القائمة على التخطيط عند تسجيل الدخول أو إعادة تحميل المتصفح.

إذا كنت تستخدم ملف Default Desktop Layout.json دون أي تعديل، فسيتم اعتباره تخطيطًا غير معدل. ومع ذلك، إذا قمت بتنزيل ملف Default Desktop Layout.json وقمت بتحميله مرة أخرى، فسيتم اعتباره تخطيطًا معدلًا حتى إذا لم يتم تعديل محتوى الملف أو اسم الملف.

بالنسبة للفرق التي تستخدم تخطيطًا مخصصًا لسطح المكتب، يجب على المسؤولين تحديث تعريف التخطيط بشكل دوري لدمج الميزات الجديدة. عندما يقوم المسؤولون بعرض تخطيط غير معدل أو فريق يستخدم تخطيطًا غير معدل، يتم عرض رسالة تشير إلى تطبيق ميزات سطح المكتب الجديدة تلقائيًا.

في سطح المكتب، يوجد نوعان من الأدوات - القائمة على iframe والمستندة إلى مكونات الويب. يعد العنوان والتنقل (الصفحة المخصصة) والمنطقة الثابتة والمنطقة الخالية من الرأس ولوحة aux هي المنطقة القابلة للتخصيص في سطح المكتب. هذه ليست أدوات.

توضح القائمة التالية المسافات التي يمكنك تكوينها. توضح الصور تخطيط سطح المكتب:

  1. منطقة العنوان والشعار: تعرض هذه المساحة شعار Webex Contact Center واسمه (الافتراضي) في الزاوية العلوية اليسرى من الشاشة.

  2. منطقة رأس أفقية: تحتوي هذه المساحة على منطقة قابلة للتكوين مليئة بأدوات مخصصة. يمكن أن تعرض هذه الأدوات، على سبيل المثال، المعلومات المضمنة والقوائم المنسدلة. نظرًا لأن ارتفاع هذا العنوان هو 64 بكسل فقط، فلا يمكن أن يتجاوز ارتفاع عنصر واجهة المستخدم ارتفاع الرأس.

  3. مساحة العمل: تتغير هذه المساحة وفقًا للاختيار الموجود على شريط التنقل أو عندما يتفاعل الوكيل مع العملاء. عندما يكون الوكيل قيد المكالمة، تعرض هذه المنطقة التحكم في التفاعل ولوحة المعلومات الإضافية (التي تتضمن عناصر واجهة مستخدم مخصصة وعناصر واجهة مستخدم ثابتة). عندما يتفاعل أحد الوكلاء على البريد الإلكتروني أو الدردشة أو القنوات الاجتماعية، تعرض هذه المنطقة منطقة مساحة العمل ولوحة المعلومات الإضافية (التي تتضمن منطقة الأدوات الثابتة).

    يتم عرض صفحة مخصصة على واجهة سطح المكتب في لوحة مساحة العمل. يمكنك الوصول إلى الصفحة المخصصة من خلال الرموز الموجودة على شريط التنقل. يمكن أن تحتوي كل صفحة مخصصة على أداة مخصصة واحدة أو أكثر.

    Custom Widget هو تطبيق تابع لجهة خارجية تم تكوينه في تخطيط JSON. يمكنك وضع الأداة المخصصة على الصفحة المخصصة أو علامة التبويب المخصصة (لوحة المعلومات الإضافية) أو على الرأس الأفقي لسطح المكتب.

  4. منطقة شريط التنقل: استخدم هذه المساحة لإضافة عناصر التنقل للوصول إلى الصفحات المخصصة.

Sample Webex Contact Center Desktop user interface for voice, showing the areas that are customizable including page icons, page labels, page level widgets, tab icons, tab labels, table level widgets, logo, title, drag and drop/resize/maximize/minimize ability, header customization, and other header widgets.
نموذج لواجهة مستخدم سطح المكتب للصوت
Sample Webex Contact Center Desktop user interface for new digital channels, showing the areas that are customizable including page icons, page labels, page level widgets, tab icons, tab labels, table level widgets, logo, title, drag and drop/resize/maximize/minimize ability, header customization, and other header widgets.
نموذج لواجهة مستخدم سطح المكتب للقنوات الرقمية الجديدة

خصائص المستوى الأعلى لتخطيط JSON

الأدوار

يحتوي تخطيط JSON الافتراضي على الأدوار الثلاثة التالية.

  • الوكيل - لتعيين تخطيط سطح المكتب ليتم عرضه عندما يقوم الوكيل بتسجيل الدخول إلى سطح مكتب Webex Contact Center للتعامل مع أنشطة الوكيل.

  • المشرف - لتعيين تخطيط سطح المكتب ليتم عرضه عندما يقوم المشرف بتسجيل الدخول إلى Webex Contact Center Desktop للتعامل مع إمكانات المشرف فقط.

    عندما يقوم المشرف بتسجيل الدخول إلى سطح المكتب، يتم تطبيق تخطيط سطح المكتب المحدد للفريق الأساسي. إذا لم تقم بتوفير فريق أساسي، فسيتم تطبيق التخطيط العام. افتراضيًا، يتم تعطيل تقارير APS.

  • وكيل المشرف - لتعيين تخطيط سطح المكتب ليتم عرضه عندما يقوم المشرف بتسجيل الدخول إلى Webex Contact Center Desktop للتعامل مع كل من قدرات المشرف وأنشطة الوكيل.

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

فيما يلي خصائص المستوى الأعلى لتخطيط JSON استنادًا إلى الدور:

{
    "agent": {
        "version": "0.1.0",
        "appTitle": "Webex Contact Center",
        "logo": "",
        "taskPageIllustration": "https://www.abc.com/image/logo.jpg",
        "stopNavigateOnAcceptTask": false,
        "dragDropEnabled": false,
        "notificationTimer": 8,
        "maximumNotificationCount": 3,
        "browserNotificationTimer": 8,
        "wxmConfigured": false,
        "desktopChatApp": {
            "webexConfigured": false,
        }
        "headerActions": ["outdial", "notification"],
        "area": {
            "advancedHeader": {
                ...
            },
            "panel": {
                ...
            },
            "navigation": {
                ...
            },
            "persistent": {
                ...
            },
            "headless": {
                ...
            }
        },
    },
    "supervisor": {
        "version": "0.1.0",
        "appTitle": "Webex Contact Center",
        "logo": "",
        "taskPageIllustration": "https://www.abc.com/image/logo.jpg",
        "stopNavigateOnAcceptTask": false,
        "dragDropEnabled": false,
        "notificationTimer": 8,
        "maximumNotificationCount": 3,
        "browserNotificationTimer": 8,
        "wxmConfigured": false,
        "desktopChatApp": {
            "webexConfigured": false,
        }
        "headerActions": ["outdial", "notification"],
        "area": {
            "advancedHeader": {
                ...
            },
            "panel": {
                ...
            },
            "navigation": {
                ...
            },
            "persistent": {
                ...
            },
            "headless": {
                ...
            },
            "homePage": {
                ...
            }
        },
    }
    "supervisorAgent": {
        "version": "0.1.0",
        "appTitle": "Webex Contact Center",
        "logo": "",
        "taskPageIllustration": "https://www.abc.com/image/logo.jpg",
        "stopNavigateOnAcceptTask": false,
        "dragDropEnabled": false,
        "notificationTimer": 8,
        "maximumNotificationCount": 3,
        "browserNotificationTimer": 8,
        "wxmConfigured": false,
        "desktopChatApp": {
            "webexConfigured": false,
        }
        "headerActions": ["outdial", "notification"],
        "area": {
            "advancedHeader": {
                ...
            },
            "panel": {
                ...
            },
            "navigation": {
                ...
            },
            "persistent": {
                ...
            },
            "headless": {
                ...
            }
        },
    }
},
  • تسري التغييرات التي تم إجراؤها على خصائص تخطيط JSON عند تحديث متصفح سطح المكتب.
  • إذا كانت الميزة التي قمت بتمكينها على تخطيط JSON غير متوفرة على سطح المكتب، فاتصل بدعم Cisco لتمكين الميزة.
  • جميع الخصائص في تخطيط JSON حساسة لحالة الأحرف.

عنوان التطبيق

لتحديد عنوان على الرأس الأفقي لسطح المكتب. العنوان الافتراضي هو مركز اتصال Webex.

مثال:

"appTitle": "Webex Contact Center"

يتم تغيير عنوان التطبيق الافتراضي من سطح مكتب مركز الاتصال إلى مركز اتصال Webex. لا يوجد أي تأثير على التخطيطات المخصصة الحالية التي تستخدم AppTitle الافتراضي القديم (سطح مكتب مركز الاتصال). لاستخدام AppTitle الجديد، يجب تعديل التخطيط المخصص. ومع ذلك، يستخدم التخطيط العام الجديد AppTitle الافتراضي كمركز اتصال Webex.

يمكن أن يكون العنوان إما نصًا أو صورة أو سلسلة فارغة. يظهر نص العنوان في صفين. إذا كان النص يمتد إلى ما بعد الصف الثاني، يتم عرض رمز علامة الحذف، ويعرض تلميح الأدوات العنوان الكامل. لا يمكن تطبيق الأنماط على العنوان.

يمكنك إما استخدام عناوين URI للبيانات (معرف الموارد الموحد) أو استضافة صورة عنوان مخصصة على شبكة توصيل المحتوى (CDN) أو مجموعة خدمة التخزين البسيط (S3) من Amazon Web Services (AWS) أو خدمة استضافة مشابهة، ثم تحديد عنوان URL للصورة المستضافة. تنسيقات صور العنوان المدعومة هي PNG وJPG وJPEG وGIF وSVG وWebP. حجم صورة العنوان المدعومة هو 184 × 32 بكسل (العرض × الارتفاع).

شعار

لتحديد عنوان URL لشعار الشركة. إذا لم تقدم عنوان URL، فسيظهر شعار Webex Contact Center افتراضيًا.

مثال:

"logo": "https://my-cdn.com/logo.png"

يمكنك استضافة صورة شعار مخصصة على CDN أو مجموعة خدمات التخزين البسيطة (S3) من Amazon Web Services (AWS) أو خدمة استضافة مشابهة، ثم تحديد عنوان URL للصورة المستضافة. تنسيقات صور الشعار المدعومة هي PNG وJPG وJPEG وGIF وSVG وWebP. حجم صورة الشعار المدعوم هو 96 × 32 بكسل (العرض × الارتفاع).

الجدول 1. مصفوفة العرض لـ AppTitle والشعار بناءً على تكوين تخطيط سطح المكتب
الحالة مثال عنوان التطبيق شعار
إذا لم يتم تكوين AppTitle والشعار
"appTitle": "",
  "logo": "",
لا يوجد عنوان الشعار الافتراضي
إذا تم تكوين AppTitle والشعار
"appTitle": "ABC Company",
  "logo": "https://my-cdn.com/abclogo.png",
نص تم تكوينه الشعار المكوّن
إذا تم تكوين AppTitle ولم يتم تكوين الشعار
"appTitle": "ABC Company",
  "logo": "",
نص تم تكوينه الشعار الافتراضي

إذا لم يتم تكوين AppTitle وتم تكوين الشعار

"appTitle": "",
  "logo": "https://my-cdn.com/abclogo.png",
لا يوجد عنوان الشعار المكوّن
إذا تم تكوين AppTitle ولم يكن الشعار مفضلًا
"appTitle": "ABC Company",
  "logo": "no-logo",
نص تم تكوينه لا يوجد شعار

إذا لم يتم تكوين AppTitle ولم يكن الشعار مفضلًا

"appTitle": "",
  "logo": "no-logo",
لا يوجد عنوان لا يوجد شعار
إذا تمت إضافة AppTitle كصورة وتم تكوين الشعار
"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "https://my-cdn.com/abclogo.png",
صورة تم تكوينها الشعار المكوّن

إذا تمت إضافة AppTitle كصورة ولم يتم تكوين الشعار

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "",
صورة تم تكوينها الشعار الافتراضي

إذا تمت إضافة AppTitle كصورة ولا يفضل الشعار

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "no-logo",
صورة تم تكوينها لا يوجد شعار
  • يتم ضبط حجم الصورة المخصص بناءً على نسبة العرض إلى الارتفاع. قد يظهر الآن نص العنوان المخصص الذي تم تكوينه مسبقًا في صفين على سطح المكتب. ولتجنب ذلك، يمكنك تعديل نص العنوان المخصص.
  • إذا لم يتم تكوين العنوان والشعار في الرأس الأفقي لسطح المكتب، فسيتم استخدام هذه المساحة بواسطة أدوات العنوان. يجب تكوين أدوات العنوان بشكل صحيح لاستخدام مساحة العنوان والشعار.
  • لا يمكن أن يتجاوز العنوان والشعار معًا الحد الأقصى للعرض البالغ 304 بكسل (بما في ذلك الحشو). إذا كان عرض الشعار أقل من 96 بكسل، فيمكن استخدام العرض المتبقي للعنوان.
  • إذا كان حجم الصورة المخصص أكبر من الحجم المدعوم، يتم ضبط حجم الصورة استنادًا إلى نسبة العرض إلى الارتفاع في الرأس الأفقي. إذا كان حجم الصورة المخصص أقل من الحجم المدعوم، فسيتم الاحتفاظ بحجم الصورة الفعلي في الرأس الأفقي.

رسم توضيحي لصفحة المهام

لتحديد رسم توضيحي مخصص لصفحة المهام استنادًا إلى تفضيلات المؤسسة ومواءمة العلامة التجارية. عندما يقوم أحد الوكلاء بتسجيل الدخول، تعرض صفحة المهام الرسم التوضيحي الذي تم تكوينه كخلفية. افتراضيًا، تظهر صفحة المهام بدون توضيح.

مثال:

"taskPageIllustration": "https://www.abc.com/image/logo.jpg",

يمكنك إما استخدام عناوين URL للبيانات أو استضافة رسم توضيحي مخصص على شبكة توصيل المحتوى (CDN) أو مجموعة خدمة التخزين البسيط (S3) من Amazon Web Services (AWS) أو خدمة استضافة مشابهة، ثم تحديد عنوان URL للرسم التوضيحي المستضاف. يمكن تكوين الرسم التوضيحي على المستوى العالمي أو مستوى الفريق بناءً على تعريف التخطيط. تأكد من تكوين عنوان URL الصحيح لمنع عرض الصورة المكسورة على سطح المكتب.

تنسيقات الرسوم التوضيحية لصفحات المهام المدعومة هي PNG وJPG وJPEG وGIF وSVG وWebP. حجم الرسم التوضيحي الموصى به هو 400 × 400 بكسل (العرض × الارتفاع). إذا كان حجم التوضيح المخصص أكبر من الحجم الموصى به، يتم تعديل حجم الرسم التوضيحي استنادًا إلى نسبة العرض إلى الارتفاع في صفحة المهام. إذا كان حجم الرسم التوضيحي المخصص أصغر من الحجم الموصى به، فسيتم الاحتفاظ بحجم الرسم التوضيحي الفعلي في صفحة المهام.

Webex Contact Center interface example of a custom illustration retraining the actual size.
مثال على رسم توضيحي مخصص يحتفظ بالحجم الفعلي
Webex Contact Center interface example of a custom illustration adjusted based on the aspect ratio.
مثال نموذجي لتوضيح مخصص تم تعديله بناءً على نسبة العرض إلى الارتفاع

إيقاف التنقل عند قبول المهمة

لتحديد ما إذا كان سيتم تحويل التركيز إلى مهمة مقبولة حديثًا، عندما يقبل الوكيل المهمة الجديدة أثناء العمل على مهمة سابقة. القيمة الافتراضية هي false.

مثال:

"stopNavigateOnAcceptTask": false

إذا تم تعيين القيمة على أنها صحيحة، فعندما يقبل المستخدم مهمة جديدة على سطح المكتب، يتم الاحتفاظ بالتركيز على المهمة السابقة ولا ينتقل إلى المهمة المقبولة حديثًا. يمنع هذا الإعداد المستخدم من فقدان أي بيانات عند قبول طلب جديد.

على سبيل المثال، ضع في اعتبارك أن الوكيل 1 موجود في الدردشة مع العميل 1 وفي نفس الوقت يجري مكالمة صوتية مع العميل 2. أثناء المكالمة الصوتية، يقوم الوكيل 1 بتحديث تفاصيل العميل 2 في لوحة التحكم في التفاعل. يحتوي العامل 1 حاليًا على مهمتين نشطتين في لوحة قائمة المهام، ويتم التركيز على لوحة التحكم في التفاعل. عندما يقبل الوكيل 1 طلب دردشة جديد من العميل 3، يظل التركيز على جزء التحكم في التفاعل مع العميل 2 ولا ينتقل إلى طلب الدردشة المقبول حديثًا.

للاحتفاظ بالتركيز على المهمة السابقة وعدم الانتقال إلى المهمة المقبولة حديثًا، حدد التخطيط المخصص مع تعيين قيمة الخاصية stopNavigateOnAcceptTask على true.

إذا لم يتم إدخال قيمة الخاصية stopNavigateOnAcceptTask في تخطيط JSON، فإن سطح المكتب ينقل التركيز إلى المهمة المقبولة حديثًا. يكون السلوك مشابهًا عندما يتم تعيين قيمة الخاصية stopNavigateOnAcceptTask إلى false.

  • ينطبق الإعداد على جميع المهام (القنوات الصوتية والرقمية) التي يتم تنفيذها على سطح المكتب - مثل قبول مهمة أو مؤتمر أو استشارة أو تحويل، وللمكالمات الخارجية ومكالمات الحملات الصادرة والاختتام التلقائي وما إلى ذلك.
  • لا يتم تطبيق الإعداد إذا كان مستخدم سطح المكتب موجودًا في الصفحة الرئيسية، مع عدم وجود مهمة نشطة في لوحة قائمة المهام. في مثل هذه الحالة، عندما يتم قبول مهمة جديدة، يتم تحويل التركيز من الصفحة الرئيسية إلى المهمة المقبولة حديثًا.

تم تمكين السحب

لتمكين السحب والإسقاط وتغيير حجم الأدوات على الصفحات المخصصة، قم بتعيين القيمة إلى true. القيمة الافتراضية هي false.

مثال:

"dragDropEnabled": false

لمزيد من المعلومات حول تمكين ميزة السحب والإسقاط لعلامات التبويب في لوحة المعلومات الإضافية، راجع لوحة المعلومات الإضافية.

مؤقت الإخطار

لتعيين المدة (بالثواني) التي يتم بعدها رفض إشعارات سطح المكتب على سطح المكتب تلقائيًا. يظهر الإشعار في الزاوية العلوية اليمنى من سطح المكتب. قيمة المهلة الافتراضية هي 8 ثوانٍ. النطاق الصحيح لقيم المهلة هو 1-10 ثوانٍ. لكي تصبح تغييرات المهلة نافذة المفعول، يجب تحديث المتصفح بعد إجراء التغييرات.

مثال:

"notificationTimer": 8

الحد الأقصى لعدد الإشعارات

لتعيين عدد إشعارات سطح المكتب التي سيتم عرضها في المرة الواحدة على سطح المكتب. القيمة الافتراضية هي 3. نطاق إشعارات سطح المكتب هو 1-10. يتم تكديس إشعارات سطح المكتب. في حالة وجود العديد من الإشعارات، فإنها تظهر مع تأخير بسيط اعتمادًا على إعدادات NotificationTimer.

مثال:

"maximumNotificationCount": 3

مؤقت إشعار المتصفح

لتعيين المدة (بالثواني) التي يتم بعدها رفض إشعارات محمصة المتصفح على سطح المكتب تلقائيًا. Toaster هو إشعار متصفح أصلي يظهر فقط إذا لم يكن سطح المكتب هو نافذة المتصفح النشطة أو علامة التبويب. تكون نافذة أو علامة تبويب مستعرض سطح المكتب غير نشطة عندما

  • أنت تعمل على نوافذ أو علامات تبويب متصفح أخرى.

  • أنت تعمل على تطبيقات أخرى.

  • لقد قمت بتصغير نافذة متصفح سطح المكتب.

يظهر الإشعار في الزاوية العلوية اليمنى من سطح المكتب. قيمة المهلة الافتراضية هي 8 ثوانٍ. النطاق الموصى به لقيم المهلة هو 5-15 ثانية. لكي تصبح تغييرات المهلة نافذة المفعول، يجب تحديث المتصفح بعد إجراء التغييرات.

مثال:

"browserNotificationTimer": 8

تعتمد المهلة التي تم تكوينها لإشعارات المتصفح على نظام التشغيل وإعدادات المتصفح. يتم تكريم قيمة المهلة في متصفح Chrome عبر أنظمة التشغيل Windows و Chrome OS و macOS. ومع ذلك، فإن المتصفحات الأخرى المدعومة لا تحترم قيمة مهلة الإعلام التي تم تكوينها باستمرار.

تم تكوينه باستخدام Wxm

(اختياري) للتهيئةWebex Experience Management، قم بتعيين القيمة إلى true. القيمة الافتراضية هي false.

مثال:

"wxmConfigured": true

تطبيق الدردشة على سطح المكتب

لتكوين العديد من تطبيقات الدردشة التي تقدمها Cisco مثل Webex App.

تم تكوينه بواسطة WebEx

يمكن تكوين تطبيق Webex إلى جانب وظائف المراسلة والاجتماعات داخل سطح المكتب. يسمح هذا التكوين للوكلاء بالتعاون مع الوكلاء والمشرفين والخبراء المتخصصين الآخرين (SMEs) في مؤسستهم دون الانتقال بعيدًا عن سطح المكتب.

لتكوين تطبيق Webex داخل سطح المكتب:

  • في Cisco Webex Control Hub حالة إضافة خدمات لمستخدم، حدد خانة الاختيار «المراسلة المتقدمة» (المستخدمون > إدارة المستخدمين > الخدمات > المراسلة). لمزيد من المعلومات، راجع إدارة حسابات المستخدمين في إدارة Cisco Webex الموقع.

  • في تخطيط سطح المكتب المخصص، قم بتعيين قيمة الخاصية WebExConfigured إلى true.

    مثال:

    "desktopChatApp": {
        "webexConfigured": true
    },

    القيمة الافتراضية لخاصية WebExConfigured خاطئة.

    يتوفر تطبيق Webex لأدوار الوكيل والمشرف والمشرف فقط إذا قمت بتعيين قيمة خاصية WebEx Configured إلى true لكل من هذه الأدوار. لا يمكن للوكيل أو المشرف أو وكيل المشرف تسجيل الخروج من تطبيق Webex.

    لعرض أيقونة رمز ويبكس (Webex) على الرأس الأفقي لسطح المكتب، أدخل قيمة webex في خاصية HeaderActions. لمزيد من المعلومات، راجع HeaderActions.

    لتمكين تطبيق Webex لفريق معين، حدد التخطيط المخصص مع تعيين قيمة خاصية WebEx Configured على true. لمزيد من المعلومات، راجع إنشاء فريق.

يمكنك تكوين تطبيق Webex في جزء المعلومات الإضافية والصفحة المخصصة والأداة المخصصة أيضًا. لمزيد من المعلومات، راجع لوحة المعلومات الإضافية.

إشعار تطبيق Webex

القيم التي تم تحديدها باستخدام خصائص NotificationTimer و BrowserNotificationTimer لموقت الإخطار قابلة للتطبيق على تطبيق Webex. قيمة المهلة الافتراضية هي 8 ثوانٍ لهذه الخصائص. لمزيد من المعلومات، راجع NotificationTimer وNotificationTimer للمتصفح.

إجراءات الرأس

لتغيير ترتيب الرموز على الرأس الأفقي لسطح المكتب. الترتيب الافتراضي هو كما يلي:

  1. رمز ويبكس(ويبكس)

  2. استخدم الهاتف لمؤشر الصوت(مكالمة خارجية)

  3. أيقونة الإعلام.(مركز الإعلام)

قم بتعيين قيمة خاصية headerActions كما يلي:

اسم الأيقونة

قيمة خاصية HeaderActions

تطبيق ويبكس

ويبكس

مكالمة خارجية

ساعة خارجية

مركز الإشعارات

إعلام

مثال:

«HeadRections»: ["webex»، «الاتصال الخارجي»، «الإشعار"]،

قيمة الخاصية headerActions حساسة لحالة الأحرف.

لتغيير الترتيب الافتراضي للرموز، أدخل خاصية headerActions والقيم في التخطيط المخصص وفقًا لذلك.

مثال:

«HeadRections»: [«الإشعار»، «الاتصال الخارجي»، «webex"]،
  • إذا لم تقم بإدخال خاصية HeaderActions والقيم في التخطيط المخصص، يتم عرض الرموز بالترتيب الافتراضي.
  • لإزالة رموز العنوان والوظائف المرتبطة بها من سطح المكتب، قم بتعيين قيمة فارغة لخاصية headerActions («headerActions»: []). ومع ذلك، إذا قمت بإضافة تطبيق Webex إلى جزء المعلومات الإضافية أو صفحة مخصصة، أو كأداة مخصصة، فلا يزال بإمكان الوكيل الوصول إلى تطبيق Webex على الرغم من أن تطبيق Webex غير متاح في الرأس الأفقي لسطح المكتب.
  • إذا تم تعيين قيمة خاصية WebEx Configured على أنها false، فلن يتم عرض رمز تطبيق Webex على الرأس الأفقي لسطح المكتب، حتى إذا تمت إضافة قيمة webex في خاصية HeaderActions. لمزيد من المعلومات، راجع WebEx Configured.

منطقة

خاصية المنطقة هي القسم الأساسي من تخطيط سطح المكتب. يمكنك تحديد التخطيط حسب المنطقة.

"area": {
    "header": {
        ...
    },
    "advancedHeader: {
        {
          "comp": "widget-1",
          "attributes": { ... },
          "script": ....
        }
    },
    "panel": {
        ...
    },
    "navigation": {
        ...
    },
    "persistent": {
        ...
    },
    "headless": {
        ...
    }
},

يمكنك تكوين كائنات المنطقة التالية:

  • اللوحة: تمثل اللوحة الثانية أو اللوحة الموجودة في أقصى اليمين في لوحة المعلومات الإضافية.

  • التنقل: يمثل الصفحات المخصصة وعناصر التنقل الخاصة بها المرتبطة بالصفحات.

  • ثابت: يمثل عناصر واجهة المستخدم على مستوى الصفحة الثابتة والمعروضة على جميع صفحات سطح المكتب.

  • بدون رأس: يمثل الأدوات التي لا تحتوي على واجهة مرئية، ولكنها تنفذ المنطق في الخلفية.

في حالة تكوين خاصية AdvancedHeader، يجب إزالة خصائص العنوان وخصائص headerActions.

عنوان متقدم

لتخصيص الرؤية وتغيير ترتيب الرموز على الرأس الأفقي لسطح المكتب. الترتيب الافتراضي هو كما يلي:

  1. رمز ويبكس(ويبكس)

  2. استخدم الهاتف لمؤشر الصوت(مكالمة خارجية)

  3. أيقونة الإعلام.(مركز الإعلام)

  4. محدد حالة وكيل مركز اتصال Webex.(محدد حالة الوكيل)

قم بتعيين قيمة الخاصية AdvancedHeader كما يلي:

اسم الأيقونة

قيمة خاصية HeaderActions

تطبيق ويبكس

وكلاء - ويبكس

مكالمة خارجية

الوكيل - الاتصال الخارجي

مركز الإشعارات

إشعار الوكيل

محدد حالة الوكيل

محدد حالة الوكلاء

مثال:

"advancedHeader": [
        {
          "comp": "agentx-webex"
        },
        {
          "comp": "agentx-outdial"
        },
        {
          "comp": "agentx-notification"
        },
        {
          "comp": "agentx-state-selector"
        }
        {
          "comp": "widget-1",
          "attributes": { ... },
          "script": ....
        }
      ]

قيمة الخاصية AdvancedHeader حساسة لحالة الأحرف.

لتغيير الترتيب الافتراضي للرموز، أدخل خاصية AdvancedHeader والقيم في التخطيط المخصص وفقًا لذلك.

تتدفق الأدوات إلى القائمة المنسدلة من اليسار إلى اليمين.

  • إذا لم تقم بإدخال خاصية AdvancedHeader في التخطيط المخصص، فسيتم عرض العنوان الافتراضي.

  • عند تمكين العنوان المتقدم، يجب نقل الأدوات من العنوان الحالي إلى العنوان المتقدم وفقًا للمثال.

  • عند تمكين العنوان المتقدم، لن يتم عرض العنوان القديم.

  • تحتوي كل أيقونة عنصر واجهة مستخدم على حشوة افتراضية وهامش يتم تحديدهما من خلال CSS ولا يمكن تخصيصهما من خلال سطح المكتب.

  • تم إصلاح موقع الشعار والعنوان وأيقونات الملف الشخصي ولا يمكن تخصيصها.

  • لإزالة رموز العنوان والوظائف المرتبطة بها من سطح المكتب، قم بتعيين قيمة فارغة للمكون المرتبط في خاصية AdvancedHeader («AdvancedHeader»: []).

    إذا قمت بإضافة تطبيق Webex إلى جزء المعلومات الإضافية أو صفحة مخصصة، أو كأداة مخصصة، فلا يزال بإمكان الوكيل الوصول إلى تطبيق Webex على الرغم من أن تطبيق Webex غير متاح في الرأس الأفقي لسطح المكتب.

  • إذا قمت بإضافة عنصر واجهة مستخدم ذي تسمية طويلة، فسيتم عرض اسم تسمية مقطوع وفقًا للمساحة المتاحة.

    يمكنك استخدام السمة TextContent لإضافة تسمية إلى عنصر واجهة مستخدم.

    مثال:

    {
              "comp": "timer-widget",
              "attributes": { "duration": "08:00:00" },
              "textContent": "Count Down Timer for Current Shift",
              "script": "https://wxcc-demo.s3.amazonaws.com/widgets/timer-widget.js"
            }

    سيتم اقتطاع التسمية «العد التنازلي لـ Current Shift» وعرضها وفقًا للمساحة المتاحة.

    • تجنب إضافة عناصر واجهة مستخدم ذات تصنيف طويل.

    • عندما تتدفق أداة إلى القائمة المنسدلة، فإن رمز الأداة فقط هو الذي يمكن النقر عليه.

  • إذا تم تعيين قيمة خاصية WebEx Configured على أنها false، فلن يتم عرض رمز تطبيق Webex على الرأس الأفقي لسطح المكتب، حتى إذا تمت إضافة قيمة webex في خاصية AdvancedHeader. لمزيد من المعلومات، راجع WebEx Configured.

الصفحة الرئيسية

عندما تقوم بتسجيل الدخول إلى سطح المكتب، فإنك تصل إلى الصفحة الرئيسية.

تنطبق الصفحة الرئيسية فقط على المشرفين وشخصية المشرف والوكيل.

يمكنك عرض الأدوات التالية على الصفحة الرئيسية. يتم توفير أدوات Analyzer افتراضيًا، ولكن يمكن للمسؤول أيضًا تكوين عناصر واجهة المستخدم الدائمة والمخصصة. لمزيد من المعلومات، راجع خصائص المستوى الأعلى لتخطيط JSON.

أدوات المحلل

افتراضيًا، يتم عرض أداة Analyzer على الصفحة الرئيسية لسطح المكتب.

تكوين تخطيط الصفحة الرئيسية

يمكنك تكوين الصفحة الرئيسية لسطح المكتب لعرض التخطيط الذي يستند إلى تفضيلات المؤسسة ومواءمة العلامة التجارية. قم بتحرير حقل الصفحة الرئيسية لتكوين الصفحة الرئيسية. يمكنك تكوين المكونات التالية لعرضها في الصفحة الرئيسية عندما يقوم المستخدم بتسجيل الدخول إلى سطح المكتب:

  • رسالة ترحيب

  • رمز المهمة على شريط التنقل للانتقال إلى لوحة المهام. يتم عرض رمز المهمة لدور المشرف والمشرف والوكيل مع تمكين ميزة مراقبة المكالمات. تعرض لوحة المهام طلبات العملاء الواردة وتفاعلات العملاء النشطة والسابقة وطلبات المراقبة النشطة.

  • قم بتصفية الأقسام مثل اسم قائمة الانتظار ونوع القناة والفرق المُدارة.

يصف الجدول التالي خصائص الصفحة المطلوبة لتكوين الصفحة الرئيسية:

الجدول 2. تخطيط الصفحة الرئيسية الديناميكي - خصائص الصفحة

الملكية

الوصف والرمز

الصفحة > استخدم تخطيط Flex

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

يعتمد تخطيط JSON على الأبعاد (العرض × الارتفاع) والإحداثيات (X و Y و Z) للأدوات.

يدعم التخطيط المرن إمكانات مثل تغيير حجم الأداة الفردية وتعظيم الأدوات وما إلى ذلك.

يتم قياس ارتفاع الأدوات الفردية بالبكسل. 1 وحدة ارتفاع = 40 بكسل. يعتمد عرض الأداة على عدد الأعمدة في الحاوية وعدد الأعمدة التي تتغير بناءً على عرض الحاوية.

يتم عرض الأدوات من اليسار إلى اليمين. يستخدم محرك التخطيط المتقدم منطقًا مخصصًا لتطبيق ضبط المساحة الأفقية والعمودية للأدوات. في البداية، يتم تحميل التخطيط أفقيًا. بعد التحميل أفقيًا، يتم تحميل الأداة عموديًا وتضمن استخدام المساحة على النحو الأمثل.

قم بتكوين الأدوات بناءً على حجم الشاشة. يمكنك إما زيادة عرض الأدوات أو تقليله، استنادًا إلى حجم الشاشة. هذا يجعل الأدوات أكثر قابلية للقراءة والاستخدام.

يوفر التصميم المرن نقاط توقف قياسية مثل الكبيرة والمتوسطة والصغيرة والصغيرة جدًا.

  • تتميز الأدوات الكبيرة بدقة 1360 بكسل أو أكثر. بالنسبة للأدوات الكبيرة، حدد قيمة العمود على أنها 12.

  • تتميز الأدوات المتوسطة بدقة تتراوح من 1070 بكسل إلى 1360 بكسل. بالنسبة للأدوات المتوسطة، حدد قيمة العمود على أنها 10.

  • تتميز الأدوات الصغيرة بدقة تتراوح من 850 بكسل إلى 1070 بكسل. بالنسبة للأدوات الصغيرة، حدد قيمة العمود كـ 6.

  • تتميز الأدوات الصغيرة الإضافية بدقة 500 بكسل. بالنسبة للأدوات الصغيرة الإضافية، حدد قيمة العمود على أنها 4.

قد تختلف وحدات البكسل هذه بناءً على نظام التشغيل والمتصفح.

"page": {
          "id": "landing",
          "useFlexLayout": true,
          "widgets": {
            "comp1": {
              "comp": "div",
              "width": 4,
              "height": 4,
              "textContent": "Widget 1",
              "attributes": {
                "style": "width: max-content; margin: 80px 240px; color: white;"
              }
            },
            "comp2": {
              "comp": "div",
              "width": 4,
              "height": 4,
              "textContent": "Widget 2",
              "attributes": {
                "style": "width: max-content; margin: 80px 240px;color: white;"
              }
            }
          }

صفحة > شركة

تأكد من توفير مكون مخصص فريد.

"comp": "page-title",

يمثل مكون عنوان الصفحة عنوان المستوى 2 <h2>لعنصر HTML المخصص.

الصفحة > رأس الصفحة

تأكد من تحديد سلسلة عنوان يمكن أن تكون ثابتة أو ديناميكية أو كليهما.

يمثل مكون عنوان الصفحة عنوان المستوى 2 <h2>في عنصر HTML المخصص.

  • سلسلة ثابتة: على سبيل المثال، مرحبًا، مرحبًا!

    "comp": "page-title",
    "attributes": {
        "pageTitle": "Hey, Welcome!"
    }
  • سلسلة ديناميكية: لجلب القيمة من المتجر. على سبيل المثال، جين دو.

    "comp": "page-title",
    "attributes": {
        "pageTitle": "$STORE.agent.agentName"
    }

  • كلاهما: مزيج من السلاسل الثابتة والديناميكية. على سبيل المثال، يا جين دو، مرحبًا!

    "comp": "page-title",
    "attributes": {
        "pageTitle": "Hey {$STORE.agent.agentName}, Welcome!"
    }

    يجب إرفاق الجزء الديناميكي من السلسلة داخل الأقواس المتعرجة المغلقة {} والبادئة بالبنية $.

الصفحة > العنوان الفرعي للصفحة

تأكد من إضافة عنوان فرعي يتم عرضه على سطح المكتب. يمكن للمستخدم إضافة Go to Analyzer في العنوان الفرعي.

  • كتلة التعليمات البرمجية للرأس الفرعي

    "useFlexLayout": true,
              "pageSubHeader": {
                "comp": "div",
                "attributes": {
                  "style": "display: flex; float:right;margin:16px 0px 16px 16px"
                },
                "children": [
                  {
                    "comp": "div",
                    "children": [
                      {
                        "comp": "md-label",
                        "textContent": "$I18N.pageSubHeader.queueName",
                        "attributes": {
                          "style": "margin-bottom:8px;"
                        }
  • كتلة التعليمات البرمجية لـ Go to Analyzer في العنوان الفرعي

    {
                    "comp": "div",
                    "children": [
                      {
                        "comp": "agentx-more-actions-wrapper",
                        "properties": {
                          "actionList": [
                            {
                              "comp": "agentx-wc-goto-analyzer"
                            }
                          ]
                        }
                      }

التنقل (صفحات مخصصة)

في هذا القسم، يمكنك إضافة صفحات تظهر على شريط التنقل الأيمن. يمكنك تحديد رمز التنقل وعنوان URL الفريد للأداة لتظهر على شريط التنقل. نوصي باستخدام بادئة محددة لعنوان URL لتجنب التعارضات. لمزيد من التفاصيل، راجع قسم خصائص التنقل.

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

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

مثال:

{
    "nav": {
        "label": “Custom Page”,
        "icon": "stored-info",
        "iconType": "momentumDesign",
        "navigateTo": "dynamic-tabs",
        "align": "top",
        "isDefaultLandingPage": true
             },    
    "page": {
        "id": “my - custom - page“,
        "useFlexLayout": true,
        "widgets": {
            “
            comp1”: {
                "comp": "md-tabs",
                "children": [{
                        "comp": "md-tab",
                        "textContent": "Shift Timer",
                        "attributes": {
                            "slot": "tab"
                        }
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel"
                        },
                        "children": [{
                            "comp": “my - custom - timer”,
                            “source”: http: //my-cdn.com/my-custom-timer.js
                                "wrapper": {
                                    "title": "Shift Timer",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                        }]
                    },
                    {
                        "comp": "md-tab",
                        "textContent": "Stock Market",
                        "responsive": "false"
                        "attributes": {
                            "slot": "tab"
                        },
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel"
                        },
                        "children": [{
                            "comp": "agentx-wc-iframe",
                            "responsive": "false"
                            "attributes": {
                                "src": "https://widget-kad.s3.amazonaws.com/Trading.htm"
                            },
                            "wrapper": {
                                "title": "Stock Market",
                                "maximizeAreaName": "app-maximize-area"
                            }
                        }],
                    },
                    {
                        "comp": "md-tab",
                        "textContent": "Widget3",
                        "attributes": {
                            "slot": "tab"
                        }
                    },
                    {
                        "comp": "md-tab-panel",
                        "textContent": "Three Content",
                        "attributes": {
                            "slot": "panel"
                        }
                    }
                ]
            },
            “comp2”: {
                "comp": “my - google - maps - component“,
                “source”: "https://my-cdn.com/my-google.maps.js
                "wrapper": {
                    "title": "Google Map",
                    "maximizeAreaName": "app-maximize-area"
                }
            }
        },
        "layout": {
            "areas": [
                ["left", "right"]
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1]
            }
        }
    }
},

يصف الجدول التالي خصائص التنقل والصفحة بالإضافة إلى خصائصها الفرعية:

الجدول 3. تصفح تفاصيل العقار

الملكية

الوصف والرمز

التنقل > التسمية

تشير هذه الخاصية إلى معرف التنقل في الصفحة. يقرأ قارئ الشاشة هذه الخاصية وتظهر في تلميح الأدوات.

هذه المعلمات ضرورية لعرض صفحتك المخصصة على شريط التنقل.

type Navigation.Item = {
    label: string;
    iconType: "momentumDesign" | "other";
    icon: string;
    align: "top" | "bottom";
    navigateTo: string;
    iconSize ? : number;
    isResponsive ? : boolean;
};

خاصية التسمية هي عنوان الصفحة المخصصة.

التنقل > نوع الأيقونة

تمثل هذه الخاصية نوع الرمز الذي يظهر في شريط التنقل للصفحة المخصصة.

تتوفر الأنواع التالية من الرموز:

  • MomentumDesign: يمكنك اختيار أي رموز متوفرة في المجموعة: https://momentum-design.github.io/momentum-design/en/tokens/icons/. ميزة استخدام Momentum هي أنه يوفر بعض الرموز بإصدار «نشط».

    حالة استخدام الإصدار النشط:

    على سبيل المثال، إذا اخترت إعلانًا عن نوع رمز Momentum، يمكنك رؤية الرمز الافتراضي على شريط التنقل. عند الانتقال إلى الصفحة المخصصة (المرتبطة بالرمز)، يتغير الرمز إلى الإصدار النشط للإعلان تلقائيًا. تأكد من التحقق مما إذا كان يحتوي على إصدار نشط من نفس الرمز في مكتبة الرموز.

  • أخرى: يمكنك توفير عنوان URL مخصص للصورة (مستضاف على CDN) يظهر على شريط التنقل. إذا كنت تستخدم رمزًا مخصصًا باللون الأسود أو الأبيض، فلن يكون الرمز مرئيًا عند التبديل بين وضعي الإضاءة والظلام.

التنقل > أيقونة

تمثل هذه الخاصية اسم الرمز في مكتبة Momentum أو عنوان URL الخاص بـ CDN.

type Navigation.Item ={
   icon:“announcement”;
}; 
// OR //
type Navigation.Item ={
   icon:“https://my-cdn.com
   /my-navigation-icon.png”;
};

التنقل > المحاذاة

تساعدك هذه الخاصية على محاذاة الرمز إلى أعلى أو أسفل شريط التنقل.

حاليًا، تسمح الخاصية بالمحاذاة العلوية فقط.

nav > هي الصفحة المقصودة الافتراضية

تحدد هذه الخاصية الصفحة المقصودة الافتراضية للوكلاء فيAgent Desktop. قم بتعيين هذه الخاصية إلى true لجعل صفحة شريط التنقل هي الصفحة المقصودة الافتراضية التي تظهر للوكلاء بعد تسجيل الدخول إلىAgent Desktop. في حالة تعيين هذه الخاصية على «true» في أكثر من صفحة من صفحات شريط التنقل، يعتبر النظام أن صفحة شريط التنقل الأولى هي الصفحة المقصودة الافتراضية.

إذا لم يتم تعيين هذه الخاصية على «صحيح» في صفحة شريط التنقل، فستعمل الصفحة الرئيسية كصفحة مقصودة افتراضية.

لا يمكنك تعيين تقارير «إحصاءات أداء المحلل» و «الوكيل» كصفحة مقصودة افتراضية.

تصفح > انتقل إلى

تحدد هذه الخاصية اسم الصفحة المخصصة. يظهر هذا الاسم في شريط العناوين عندما يتنقل الوكيل.

يجب ألا يتضمن NavigateTo القيم التالية: الصور والخطوط وcss وbuild_info والتعليمات والتطبيق وi18n والرموز والصور mfe-wc والأصوات.

type Navigation.Item = {
    navigateTo: “my - custom - page”;
};
الجدول 4. صفحة تفاصيل الملكية

الملكية

الوصف والرمز

صفحة > معرف

في خاصية الصفحة، يمكنك تحديد كائن الصفحة المخصصة (عنصر واجهة المستخدم الديناميكي).

تمثل خاصية id معرف صفحة فريدًا. على سبيل المثال، صفحتي المخصصة 1. لا يمكن للوكيل رؤية هذا المعرف على سطح المكتب.

type DynamicWidgets.Page = {
    id: string;
    widgets: Record < string,
    DynamicWidget.Options > ;
    layout: Layout;
};

الصفحة > استخدم تخطيط Flex

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

يعتمد تخطيط JSON على الأبعاد (العرض × الارتفاع) والإحداثيات (X و Y و Z) للأدوات.

يدعم التخطيط المرن إمكانات مثل تغيير حجم الأداة الفردية وتعظيم الأدوات وما إلى ذلك.

يتم قياس ارتفاع الأدوات الفردية بالبكسل. 1 وحدة ارتفاع = 40 بكسل. يعتمد عرض الأداة على عدد الأعمدة في الحاوية وعدد الأعمدة التي تتغير بناءً على عرض الحاوية.

يتم عرض الأدوات من اليسار إلى اليمين. يستخدم محرك التخطيط المتقدم منطقًا مخصصًا لتطبيق ضبط المساحة الأفقية والعمودية للأدوات. في البداية، يتم تحميل التخطيط أفقيًا. بعد التحميل أفقيًا، يتم تحميل الأداة عموديًا وتضمن استخدام المساحة على النحو الأمثل.

قم بتكوين الأدوات بناءً على حجم الشاشة. يمكنك إما زيادة عرض الأدوات أو تقليله، استنادًا إلى حجم الشاشة. هذا يجعل الأدوات أكثر قابلية للقراءة والاستخدام.

يوفر التصميم المرن نقاط توقف قياسية مثل الكبيرة والمتوسطة والصغيرة والصغيرة جدًا.

  • تتميز الأدوات الكبيرة بدقة 1360 بكسل أو أكثر. بالنسبة للأدوات الكبيرة، حدد قيمة العمود على أنها 12.

  • تتميز الأدوات المتوسطة بدقة تتراوح من 1070 بكسل إلى 1360 بكسل. بالنسبة للأدوات المتوسطة، حدد قيمة العمود على أنها 10.

  • تتميز الأدوات الصغيرة بدقة تتراوح من 850 بكسل إلى 1070 بكسل. بالنسبة للأدوات الصغيرة، حدد قيمة العمود كـ 6.

  • تتميز الأدوات الصغيرة الإضافية بدقة 500 بكسل. بالنسبة للأدوات الصغيرة الإضافية، حدد قيمة العمود على أنها 4.

قد تختلف وحدات البكسل هذه بناءً على نظام التشغيل والمتصفح.

"page": {
          "id": "landing",
          "useFlexLayout": true,
          "widgets": {
            "comp1": {
              "comp": "div",
              "width": 4,
              "height": 4,
              "textContent": "Widget 1",
              "attributes": {
                "style": "width: max-content; margin: 80px 240px; color: white;"
              }
            },
            "comp2": {
              "comp": "div",
              "width": 4,
              "height": 4,
              "textContent": "Widget 2",
              "attributes": {
                "style": "width: max-content; margin: 80px 240px;color: white;"
              }
            }
          }

الصفحة > الأدوات

صفحة > شركة

يساعدك على تحديد أدواتك المخصصة. لوضع عناصر واجهة مستخدم متعددة، حدد خيارات عناصر واجهة المستخدم بالتسلسل. تأكد من إعطاء كل عنصر واجهة مستخدم اسم منطقة فريدًا. استخدمه في قسم التخطيط لاحقًا.

"widgets": {
    "comp1": {
        ...
    }
    "comp2": {
        ...
    }
}

تمثل هذه الخاصية اسم عنصر HTML المخصص (المعروف باسم مكون الويب أو أي عنصر آخر - إذا كنت تريد استخدامه كغلاف). لمزيد من المعلومات، راجع نماذج أمثلة حالات الاستخدام. أدخل اسم العنصر المخصص هنا بدون الأقواس الزاويّة («<» or «>»). على سبيل المثال، «العنصر المخصص الخاص بي».

يدعم كل إدخال ضمن قسم الأدوات التنسيق التالي:

type Options = {
    comp: string;
    script ? : string;
    properties ? : Record < string,
    any > ;
    attributes ? : Record < string,
    string > ;
    children ? : Options[];
    textContent ? : string;
    style ? : Partial < CSSStyleDeclaration > ;
    wrapper ? : {
        title: string;
        maximizeAreaName: string;
    };
};

صفحة > برنامج نصي

(اختياري) هذه الخاصية مطلوبة فقط عند تحميل الأداة أو المكون من موقع بعيد مثل CDN.

"comp1": {
    "comp": "widget-one",
    "script": "http:/my-cdn.com /
        dynamic - widgets / widget - one.js ",
}

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

  • قم بإخطار الوكيل لمسح ذاكرة التخزين المؤقت للمتصفح وإعادة تحميلAgent Desktop.

  • احتفظ بعنوان URL الحالي. قم باستيراد عنوان URL للحزمة الجديدة ديناميكيًا باستخدام جافا سكريبت المستضاف في عنوان URL الحالي.

    مثال:

    (function() {
              var script = document.createElement("script");
                  script.src = <Your JS Script URL>
                  script.type = "text/javascript";
                  script.async = true;
                  document.getElementsByTagName ("head").item(0).appendchild(script);
    
                } ) ()

صفحة > خصائص

يمكنك تحديد الخصائص التي يجب تمريرها لمكون الويب.

"properties": {
    "user": "admin",
},

صفحة > مستجيب

يحدد ما إذا كان مكون الويب أو عنصر واجهة المستخدم المستند إلى iFrame الذي تمت إضافته في التخطيط المخصص على مستوى الصفحة أو مستوى comp مستجيبًا. مكونات الويب سريعة الاستجابة تجعل صفحة الويب الخاصة بك جذابة بصريًا على جميع الأجهزة وسهلة الاستخدام. يجب عليك استخدام أدوات iFrame سريعة الاستجابة.

قم بتكوين هذه الخاصية بإحدى القيم التالية:

  • صحيح: يتيح استجابة الأداة. افتراضيًا، تستجيب جميع عناصر واجهة المستخدم استنادًا إلى أحجام الشاشة التدريجية والاتجاه ومناطق العرض الخاصة بالجهاز قيد الاستخدام.

  • خطأ: يعطل استجابة الأداة. إذا كانت الأدوات لا تدعم العرض على أجهزة مختلفة، فقم بتمييزها على أنها غير مستجيبة.

{
    "comp": "md-tab",
    "responsive": true,
    "attributes": {
        "slot": "tab",
        "class": "widget-pane-tab"
    },
    "children": [{
        "comp": "slot",
        "attributes": {
            "name": "SCREEN_POP_TAB"
        }
    }],
    "visibility": "SCREEN_POP"
}, {
    "comp": "md-tab-panel",
    "responsive": false,
    "attributes": {
        "slot": "panel",
        "class": "widget-pane"
    },
    "children": [{
        "comp": "slot",
        "attributes": {
            "name": "CALL_GUIDE"
        }
    }],
    "visibility": "CALL_GUIDE"
},

لا يمكن للأدوات غير المتجاوبة ضمان أفضل تجربة للمستخدم ولا يتم عرضها في العرض الأصغر. يجب على الوكيل زيادة حجم نافذة المتصفح لعرض أي عناصر واجهة مستخدم تم تكوينها على أنها غير مستجيبة.

الصفحة > السمات

يمكنك تحديد سمات مكون الويب في هذا القسم.

"attributes": {
         "disabled": "false",
},

الصفحة > الرؤية

يحدد ما إذا كانت عناصر واجهة المستخدم التي تقدمها Cisco والمضافة في التخطيط المخصص على مستوى الصفحة أو مستوى comp مرئية أم لا.

الأدوات التي تقدمها Cisco هي سجل جهات الاتصال ونسخة IVR ودليل مكالمات حملة المعاينة وScreen Pop. Cisco Webex Experience Management

  • يتم تضمين قيم خصائص الرؤية وتعريفها في ملف JSON الافتراضي لتخطيط سطح المكتب. لا يمكن للمسؤول تعديل قيم خصائص الرؤية للأدوات التي تقدمها Cisco.

  • تم إيقاف قيمة خاصية الرؤية NOT_RESPONSIVE. يمكنك الاستمرار في استخدامه فقط للتوافق مع الإصدارات السابقة. لا تتطلب أي قيمة تم تعيينها كـ NOT_RESPONSIVE سابقًا تعديلًا، حيث تظل الوظيفة كما هي.

    لتعيين عنصر واجهة مستخدم تم إنشاؤه حديثًا على أنه مستجيب أو غير مستجيب، يجب استخدام الخاصية المتجاوبة. لمزيد من المعلومات، راجع الخاصية المتجاوبة.

صفحة > أطفال

هذه الخاصية هي الجزء الأساسي من التخطيط. في قسم الأطفال، يمكنك دمج العديد من المستويات حسب الحاجة إذا كانت الأداة المستندة إلى مكونات الويب تسمح لك بتمرير الأطفال. لجعل ذلك ممكنًا، يجب على المطور معالجة المحتوى المشقوق برمجيًا. لمزيد من المعلومات، راجع دليل مطوري Cisco Webex Contact Center أجهزة الكمبيوتر المكتبية.

لمعرفة كيفية تمرير قيم STORE كخصائص، راجع مشاركة البيانات من سطح المكتب إلى الأدوات.

"children": [{
        "comp": "div",
        "textContent": "Test"
    },
    {
        "comp": "div",
        "textContent": “Test”
    },
    {
        "comp": "div",
        "textContent": "Test"
    },
    {
        "comp": "div",
        "textContent": "Test"
    },
    {
        "comp": "div",
        "children": [{
                "comp": "div",
                "textContent": “Test”
            },
            {
                "comp": "div",
                "textContent": "Test"
            },
            {
                "comp": "div",
                "textContent": "Test"
            }
        ]
    }
],

تتمثل ميزة قسم مصفوفة «الأطفال» في أنه يمكنك استخدام مكونات الويب الموجودة في مواصفات التخطيط الخاصة بك، والتي تعد بالفعل جزءًا من حزمة سطح المكتب. تتضمن بعض مكونات الويب الخاصة بحزمة سطح المكتب ما يلي:

  • agentx-wc-iframe: أداة تسمح لك بوضع أي صفحة ويب في iFrame كأداة.

  • المنطقة الديناميكية: مكون يسمح لك بتمكين ميزة السحب والإسقاط للوكلاء في مكان آخر غير الصفحات المخصصة. يمكن أن تتمتع الصفحات المخصصة أيضًا بهذه الإمكانية إذا قمت بتمكين السحب والإسقاط افتراضيًا.

  • أي مكون في مكتبة مكونات momentum-ui-web. لمزيد من المعلومات، راجع GitHub. على سبيل المثال:

    • md-tabs: غلاف حاوية علامات التبويب

    • md-tab: رأس علامة تبويب واحدة

    • لوحة md-tab: محتوى علامة تبويب واحدة

لمزيد من المعلومات حول سمات علامة التبويب الدائمة، راجع سمات علامات التبويب الدائمة.

الصفحة > محتوى النص

يساعدك على إضافة محتوى النص الخاص بك.

"textContent": "My Text Content",

الصفحة > النمط

يساعدك على تعيين نمط CSS معين للمكون الخاص بك.

"style": {
    "backgroundColor": "#CBD",
    "overflow": "scroll"
},

صفحة > غلاف

يسمح لك غلاف الأدوات بإضافة شريط أدوات أعلى عنصر واجهة المستخدم. يمكن أن يحتوي شريط الأدوات على عنوان وأيقونة رمز التكبير (Maximize) أعلى الأداة. عندما تشغل الأداة مساحة صغيرة على الصفحة، تسمح أيقونة التكبير للوكيل برؤية الأداة في مساحة العمل الكاملة.

تأكد من استخدام القيمة الافتراضية كـ «app-maximize-area». حاليًا، لا تتوفر سوى القيمة الافتراضية. إذا تم تكوين التخطيط باستخدام useFlexLayout، فيمكنك تمكين رمز التكبير/الاستعادة في رأس الأداة عن طريق إضافة سمة isMaximizable إلى تكوين الأداة وتعيين قيمتها إلى true.

"wrapper": {
    "title": My Widget Title ",
    "maximizeAreaName": "app-maximize-area" "isMaximizable":true 
}

صفحة > غلاف> معرف

(اختياري) يسمح لك غلاف أداة مكون الويب بتحديث عنوان عنصر واجهة المستخدم الديناميكي باستخدام معرف فريد. أدخل قيمة خاصية معرف غلاف الأداة كعنوان فريد للتحديث.

"wrapper": {
    "title": My Widget Title ",
    "id": "unique-id-to-update-title",
    "maximizeAreaName": "app-maximize-area"
}

تأكد من استخدام نفس المعرف الفريد لـ JavaScript CustomEvent. لمزيد من المعلومات، راجع قسم الأحداث غير المتزامنة في فصل وحدة اتصال الوكيل لمطور Cisco Webex Contact Center سطح المكتب.

لتحديث عنوان عنصر واجهة المستخدم المستند إلى iFrame، استخدم محتوى iFrame من نفس المجال. فيما يلي مثال نموذجي:

<
script type = "text/javascript" >
    var title = "";
window.addEventListener("update-title-event", function(e) {
    title = e.detail.title;
});
document.querySelector('#customEvent').onclick = function() {
    const e = new CustomEvent("update-title-event", {
        bubbles: true,
        detail: {
            title: "new title"
        }
    });
    window.parent.dispatchEvent(e);
}; <
/script> <
button id = "customEvent" > New Title < /button> <
    iframe src = "https://blog.logrocket.com/the-ultimate-guide-to-iframes/" > < /iframe>

الصفحة الرئيسية > الوكلاء - wc-iframe

يسمح لك بتضمين صفحة ويب في iFrame تظهر كعنصر واجهة مستخدم على سطح المكتب. يمكنك استخدام أداة iFrame المسماة «agentx-wc-iframe».

"comp1": {
    "comp": "agentx-wc-iframe",
    "attributes": {
        "src": "https://blog.logrocket.com /
            the - ultimate - guide - to - iframes / "
    },
    "wrapper": {
        "title": "AgentX iFrame",
        "maximizeAreaName": "app-maximize-area"
    }
},

صفحة > تخطيط

يسمح لك بترتيب الأدوات على الصفحة.

يمثل التنسيق التالي تخطيط الشبكة:

type Layout = {
    areas: string[][];
    size: {
        rows: number[];
        cols: number[];
    };
};

هنا يمكنك تحديد الشبكة بأسماء المناطق التي حددتها في قسم الأدوات.

يوضح المثال التالي كيفية تحديد تخطيط ثلاثة صفوف وثلاثة أعمدة:

"layout": {
    "areas": [
        [
            "comp1",
            "comp1",
            "comp3"
        ],
        [
            "comp2",
            "comp2",
            "comp3"
        ],
        [
            "comp4",
            "comp4",
            "comp4"
        ]
    ],
    "size": {
        "cols": [1, 1, 1],
        "rows": [1, 1, 1]
    }
}
التوزيع المتساوي لتخطيط 3x3
Equal distribution of a 3x3 layout for Webex contact Center Desktop layout configuration.

في قسم الحجم، تمثل الأرقام جزء المساحة التي يمكن أن تشغلها الأداة، بالنسبة إلى الأدوات الأخرى. تحتل جميع الأعمدة الثلاثة جزءًا واحدًا من المساحة. مع عرض متاح بنسبة 100٪، تحتل كل أداة 33.33٪ من المساحة الأفقية.

مع عرض عمود متساوي
Equal column width layout for Webex Contact Center Desktop layout configuration.

مثال آخر لحالة الاستخدام، إذا قمت بتعيين «cols»: [1، 2، 2]، فهذا يعني أن المساحة الإجمالية مقسمة على 5 (1+2+2) وأن الأداة الأولى تحتل 20٪ من المساحة الأفقية. تستحوذ الأدوات الثانية والثالثة على 40٪ لكل منهما. لمزيد من المعلومات، راجع المفاهيم الأساسية لتخطيط الشبكة.

Unequal column width layout for Webex Contact Center Desktop layout configuration.
بعد تغيير عرض العمود

الصفحة > الجذر

يُطلق على تداخل التخطيطات اسم التخطيط الفرعي. في حالة وجود تخطيطات متداخلة في تكوين التخطيط الخاص بك، يجب أن يكون لديك كائن «ROOT» واحد كأصل للتخطيطات الفرعية. بخلاف ذلك، يمكن أن يكون تكوين التخطيط الخاص بك مسطحًا إذا لم يكن هناك حاجة للتداخل.

يوفر هذا التخطيط الفرعي مزيدًا من التحكم في سلوك تغيير حجم التخطيط. يجب أن تكون خاصية تخطيط الصفحة من النوع Record<string, Layout>. تسمح لك خاصية التخطيط بترتيب الأدوات على الصفحة.

{
    "id": "some-id",
    "widgets": {
        "c1": {
            "comp": "div",
            "textContent": "c1"
        },
        "c2": {
            "comp": "div",
            "textContent": "c2"
        },
        "c3": {
            "comp": "div",
            "textContent": "c3"
        },
        "c4": {
            "comp": "div",
            "textContent": "c4"
        },
        "c5": {
            "comp": "div",
            "textContent": "c5"
        }
    },
    "layout": {
        "ROOT": {
            "areas": [
                ["c1", "sub1"],
                ["c2", "sub2"],
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1, 1]
            }
        },
        "sub1": {
            "areas": [
                ["c3", "c4"]
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1]
            }
        },
        "sub2": {
            "areas": [
                ["c1"],
                ["c5"]
            ],
            "size": {
                "cols": [1],
                "rows": [1, 1]
            }
        }
    }
}

يقوم هذا الإعداد بإنشاء شبكة في تخطيط ROOT بشبكتين فرعيتين يمكنك تغيير حجمهما بشكل مستقل.

Sub-layout appearance for Webex Contact Center Desktop layout configuration.
مظهر التخطيط الفرعي

يؤثر تغيير حجم المكون على المكونات داخل هذا التخطيط الفرعي.

Sub-layout appearance, after resizing both sub-layouts, for Webex Contact Center Desktop layout configuration.
بعد تغيير حجم كلا التخطيطين الفرعيين

كن على دراية بالحالات التالية:

حلقة لا نهائية: إذا قمت بتضمين تخطيط ROOT كتخطيط فرعي لـ ROOT، فسيؤدي ذلك إلى حدوث خطأ «تم تجاوز مكدس المكالمات» ويتم تشغيله في حلقة لا نهائية.

{
    "layout": {
        "ROOT": {
            "areas": [
                ["c1", "c2"],
                ["c3", "ROOT"],
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1, 1]
            }
        }
    }
Sub-layout appearance with infinite loop for Webex Contact Center Desktop layout configuration.
تخطيط فرعي مع حلقة لا نهائية

مرات التخطيط الفرعي نفسه (N): إذا قمت بتضمين التخطيط الفرعي في شبكتك أكثر من مرة بنفس الاسم، وإذا قمت بتغيير حجم أحدهما، فسيتم تغيير حجم جميع التخطيطات الفرعية تلقائيًا.

إذا لم يكن هذا هو السلوك المطلوب، فأعد تسمية كل من التخطيطات الفرعية باسم فريد.

{
    "layout": {
        "ROOT": {
            "areas": [
                ["c1", "sub1"],
                ["c2", "sub1"],
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1, 1]
            }
        },
        "sub1": {
            "areas": [
                ["c3", "c4"]
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1]
            }
        }
    }
}
Sub-layout appearance with N times for Webex Contact Center Desktop layout configuration.
تخطيط فرعي بـ N مرة

سمات علامات التبويب الدائمة

لتعيين علامات التبويب في الصفحات المخصصة والأدوات المخصصة على أنها ثابتة، أدخل سمات md-tabs في التخطيط المخصص.

مثال: تعيين علامات التبويب كعلامات ثابتة

{
    "comp": "md-tabs",
    "attributes": {
        "persist-selection": true,
        "tabs-id": "unique-id for all the tabs together in the container"
    },
}

الملكية

وصف

الاختيار المستمر

لتعيين md-tabs لتكون ثابتة. القيمة الافتراضية صحيحة.

معرف علامات التبويب

تعريف فريد لجميع علامات التبويب معًا في الحاوية.

عند تعيين md-tabs لتكون ثابتة (التحديد المستمر: صحيح)، Agent Desktop يحتفظ بتحديد علامة التبويب حتى إذا قام الوكيل بالتبديل بين الصفحات أو الأدوات في سطح المكتب.

  • لا تنطبق خاصية التحديد المستمر على علامات التبويب في لوحة المعلومات الإضافية وصفحة تقارير إحصائيات أداء العامل، لأن سلوك علامة التبويب الدائمة قد تم تعيينه بالفعل في سطح المكتب .
  • تتم إعادة تعيين اختيار علامة التبويب إلى علامة التبويب الافتراضية عند تسجيل الخروج من سطح المكتب أو إعادة تحميل/تحديث المتصفح أو مسح ذاكرة التخزين المؤقت للمتصفح.

تكوين عناصر واجهة المستخدم الثابتة

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

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

مثال:

"area": {
    "persistent": [{
            "comp": "md-tab",
            "attributes": {
                "slot": "tab"
            },
            "children": [{
                    "comp": "md-icon",
                    "attributes": {
                        "name": "emoticons_16"
                    }
                },
                {
                    "comp": "span",
                    "textContent": "Custom Page Widget"
                }
            ]
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel"
            },
            "children": [{
                "comp": "dynamic-area",
                "properties": {
                    "area": {
                        "id": "dw-panel-two",
                        "widgets": {
                            "comp1": {
                                "comp": "agentx-wc-iframe",
                                "attributes": {
                                    "src": "https://blog.logrocket.com/the-ultimate-guide-to-iframes/"
                                },
                                "wrapper": {
                                    "title": "AgentX iFrame",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                            },
                            "comp2": {
                                "comp": "uuip-widget-two",
                                "script": "./dynamic-widgets/widget-two.js",
                                "attributes": {
                                    "title": "WIDGET 2 content"
                                },
                                "wrapper": {
                                    "title": "Widget 2 title",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                            }
                        },
                        "layout": {
                            "areas": [
                                ["comp1", "comp2"]
                            ],
                            "size": {
                                "cols": [1, 1],
                                "rows": [1]
                            }
                        }
                    }
                }
            }]
        }
    ]
}

عندما تقوم بتخصيص عنصر واجهة مستخدم، يمكنك اختيار أي من الخيارات:

  • قم باستضافة تطبيق على صفحة ويب يمكن تضمينها داخل إطار iframe.

  • قم بإنشاء أداة مخصصة.

يتم وصف متطلبات الأداة الفنية في وثائق تطوير عناصر واجهة مستخدم سطح المكتب. كمحرر تخطيط، تأكد من أن لديك هذه التفاصيل:

  • ما اسم عنصر HTML المخصص (المعروف باسم مكون الويب)؟

  • ما عنوان URL لمصدر شبكة توصيل المحتوى (CDN) الذي يستضيف حزمة JavaScript؟

أدوات رأس الصفحة

يتم استخدام العنوان لعرض المعلومات المضمنة وإضافة القوائم المنسدلة وما إلى ذلك. نظرًا لأن مساحة حاوية الرأس محدودة، فإن الارتفاع الإجمالي للرأس يبلغ 64 بكسل فقط. لمزيد من المعلومات حول محاذاة التخطيط، راجع قسم خاصية التخطيط.

مثال:

"header":{
   "id":"header",
   "widgets":{
      "head1":{
         "comp":"header-widget-one",
         "script":"https://my-cdn.com/dynamic-widgets/header-widget-one.js",
      },
      "head2":{
         "comp":"header-widget-two",
         "script":"https://my-cdn.com/dynamic-widgets/header-widget-two.js",
      }
   },
   "layout":{
      "areas":[[ "head1", "head2" ]], 
      "size": { "cols": [1, 1], "rows": [1] } 
      } 
}

لإضافة تلميح أداة لأداة رأس الصفحة، قم بتغليف المكون بـ md-tooltip. أدخل معلومات تلميح الأدوات في خاصية الرسالة.

مثال:

"header": {
    "id": "dw-header",
    "widgets": {
        "head1": {
            "comp": "md-tooltip",
            "attributes": {
                "message": "Netlify"
            },
            "children": [{
                "comp": "agentx-wc-iframe",
                "attributes": {
                    "src": "https://keen-jackson-8d352f.netlify.app"
                }
            }]
        },

    },
}

يجب إضافة عرض سمات النمط والارتفاع لتكوين أي أدوات من خلال iFrame في منطقة الأدوات القابلة للتخصيص في العنوان. أفضل قيمة ملائمة لسمة الارتفاع هي 64 بكسل.

تأكد من إضافة سمات النمط إلى أدوات العنوان الحالية ليتم تحميلها كما هو متوقع داخل iFrame.

مثال:

"head1": {
    "comp": "agentx-wc-iframe",
    "attributes": {
        "src": "https://widget-kad.s3.amazonaws.com/Headers/Timer/Timer.htm",
        "style": "height:64px;display:flex;"
    }


},

نوصي باستخدام صف واحد فقط مع أعمدة متعددة للرأس لأن ارتفاع الرأس هو 64 بكسل فقط. لمزيد من المعلومات حول المحاذاة، راجع قسم خاصية التخطيط.

لوحة المعلومات الإضافية

تعرض لوحة المعلومات الإضافية على سطح المكتب علامات التبويب التي تتضمن عناصر واجهة المستخدم (الافتراضية) التي تقدمها Cisco وعناصر واجهة المستخدم المخصصة. تظهر الأدوات التالية التي تقدمها Cisco في علامات التبويب المحددة مسبقًا:

  • سجل جهات الاتصال

  • نسخة الرد الصوتي التفاعلي

  • رحلة تجربة العملاء

  • سكرين بوب

يمكنك استخدام لوحة المعلومات الإضافية من أجل:

  • إضافة علامات تبويب

  • قم بتغيير ترتيب علامات التبويب

  • إزالة علامات التبويب المحددة مسبقًا

  • ضع علامة على علامات التبويب المخصصة على أنها قابلة للسحب

  • إضافة تلميحات الأدوات إلى علامات التبويب المخصصة

  • أضف خيار إعادة تعيين ترتيب علامة التبويب

مثال:

"panel": {
    "comp": "md-tabs",
    "attributes": {
        "class": "widget-tabs"
    },
    "children": [{
            "comp": "md-tab",
            "attributes": {
                "slot": "tab",
                "class": "widget-pane-tab"
            },
            "children": [{
                "comp": "slot",
                "attributes": {
                    "name": "CONTACT_HISTORY_TAB"
                }
            }]
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel",
                "class": "widget-pane"
            },
            "children": [{
                "comp": "slot",
                "attributes": {
                    "name": "CONTACT_HISTORY"
                }
            }]
        },
        {
            "comp": "md-tab",
            "attributes": {
                "slot": "tab",
                "class": "widget-pane-tab"
            },
            "children": [{
                    "comp": "md-icon",
                    "attributes": {
                        "name": "pop-out_16"
                    }
                },
                {
                    "comp": "span",
                    "textContent": "Screen Pop"
                }
            ],
            "visibility": "SCREEN_POP"
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel",
                "class": "widget-pane"
            },
            "children": [{
                "comp": "#SCREEN_POP"
            }],
        },
        {
            "comp": "md-tab",
            "attributes": {
                "slot": "tab"
            },
            "children": [{
                    "comp": "md-icon",
                    "attributes": {
                        "name": "emoticons_16"
                    }
                },
                {
                    "comp": "span",
                    "textContent": "Custom Widget"
                }
            ]
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel"
            },
            "children": [{
                "comp": "dynamic-area",
                "properties": {
                    "area": {
                        "id": "dw-panel-two",
                        "widgets": {
                            "comp1": {
                                "comp": "agentx-wc-iframe",
                                "attributes": {
                                    "src": "https://blog.logrocket.com/the-ultimate-guide-to-iframes/"
                                },
                                "wrapper": {
                                    "title": "AgentX iFrame",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                            },
                            "comp2": {
                                "comp": "widget-one",
                                "script": "https://my-cdn.com/dynamic-widgets/widget-one.js",
                                "wrapper": {
                                    "title": "Widget title",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                            }
                        },
                        "layout": {
                            "areas": [
                                ["comp1"],
                                ["comp2"]
                            ],
                            "size": {
                                "cols": [1],
                                "rows": [1, 1]
                            }
                        }
                    }
                }
            }]
        }
    ]
},

يمكنك تكوين أداة رحلة تجربة العملاء بعد تمكين مقاييس إدارة تجربة العملاء علىManagement Portal.

في لوحة المعلومات الإضافية، أضف علامات تبويب جديدة لوضع أدواتك المخصصة. لا توجد قواعد خاصة تنطبق هنا ويكون تداخل المكونات كما هو متوقع وموصوف في قسم الأطفال. لمزيد من المعلومات، راجع خاصية الأطفال في الصفحة.

فيما يلي أمثلة محددة لتخصيص رؤوس علامات التبويب الخاصة بك:

مثال لوضع الرموز والتسميات في ملكية الأطفال

{
    "comp": "md-tab",
    "attributes": {
        "slot": "tab",
        "class": "widget-pane-tab"
    },
    "children": [{
            "comp": "md-icon",
            "attributes": {
                "name": "transcript_16"
            }
        },
        {
            "comp": "span",
            "textContent": “My Widget Tab”
        }
    ],
},

مثال لوضع الصورة (مع CSS) والتسميات في ملكية الأطفال

{
    "comp": "md-tab",
    "attributes": {
        "slot": "tab"
    },
    "children": [{
        "comp": "span",
        "attributes": {
            "style": "align-items: center; display: flex;"
        },
        "children": [{
                "comp": "img",
                "attributes": {
                    "src": “http: //my-cdn.com/icon.svg”,
                        "width": 16,
                    "height": 16,
                    "style": "margin-right: 0.5rem;"
                }
            },
            {
                "comp": "span",
                "textContent": “My Widget Tab”
            }
        ]
    }],
},

تظهر القائمة المنسدلة «المزيد من علامات التبويب» تلقائيًا عندما تحتوي لوحة المعلومات الإضافية على علامات تبويب متعددة.

يجب إضافة تلميح أداة علامة تبويب مخصص لسهولة القراءة وإمكانية الوصول. لإضافة تلميح أداة لعلامة تبويب مخصصة، قم بتغليف المكون بـ md-tooltip. أدخل معلومات تلميح الأدوات في خاصية الرسالة وقم بتطبيق قيم خصائص النمط كما هو موضح في المثال التالي.

"comp": "md-tooltip",
"attributes": {
    "class": "widget-tabs",
    "message": "Sample Tab 1",
    "style": "max-width: 252px; min-width: 110px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; display: inline-block; margin-bottom: -10px;"
},

بالنسبة إلى علامة تبويب مخصصة، نوصي بعرض 252 بكسل كحد أقصى وعرض 110 بكسل كحد أدنى.

لتمكين ميزة السحب والإسقاط ضمن علامة التبويب المخصصة، أضف الخاصية التالية ضمن السمات:

"comp": "md-tabs",
"attributes": {
    "class": "widget-tabs",
    "draggable": true,
    "comp-unique-id": "sample-dynamic-custom-tabs"
},
  • draggable: قم بتعيين قيمة الخاصية القابلة للسحب إلى true.

  • comp-unique-id: أدخل قيمة فريدة لتعريف المكون.

    مثال:

    "comp-unique-id": "sample-dynamic-custom-tabs"
    

إذا قمت بتمكين السحب والإسقاط لعلامة تبويب مخصصة، يمكن للوكيل سحب علامة التبويب وإسقاطها إلى الموضع المطلوب داخل لوحة المعلومات الإضافية. لإعادة تعيين علامات التبويب إلى ترتيب علامات التبويب الافتراضي، أضف الخاصية التالية:

"comp": "agentx-wc-more-actions-widget",
"attributes": {
    "slot": "settings",
    "class": "widget-pane",
    "tabs-unique-id": "sample-dynamic-custom-tabs"
},
  • agentx-wc-more-actions-widget: أدخل المكون الذي يتم عرضه كرمز المزيد من الإجراءات (رمز المزيد من الإجراءات) في لوحة المعلومات الإضافية.

  • slot="settings": Enter an attribute within the component that is displayed as the Reset Tab Order option in the More Actions drop-down list. يمكن للوكلاء إعادة تعيين علامات التبويب في لوحة المعلومات الإضافية إلى الترتيب الافتراضي بالنقر فوق رمز المزيد من الإجراءات > إعادة تعيين ترتيب علامات التبويب.

  • tabs-unique-id: أدخل نفس القيمة الفريدة المحددة لخاصية comp-unique-id لتعيين مكونات md-tabs وإعادة تعيينها.

يستخدم نموذج التعليمات البرمجية التالي وظائف المزيد من الإجراءات وإعادة تعيين ترتيب علامات التبويب.

"comp": "agentx-wc-more-actions-widget",
"attributes": {
    "slot": "settings",
    "class": "widget-pane",
    "tabs-unique-id": "sample-dynamic-custom-tabs"
},
"children": [{
    "comp": "div",
    "attributes": {
        "textContent": "custom action",
        "slot": "custom-action"
    },
    "children": [{
            "comp": "agentx-wc-notes-header-widget"
        },
        {
            "comp": "agentx-wc-menu-notification"
        }
    ]
}],

}
Webex Contact Center more actions menu example, showing the 'Reset Tab Order' option.

افتراضيًا، يتم تعريف تلميح الأدوات ورمز الحذف وإعادة تعيين ترتيب علامات التبويب لعلامات التبويب المحددة مسبقًا.

يمكن توسيع القائمة المنسدلة لمزيد من الإجراءات لإضافة مكونات أو أدوات مخصصة إضافية بعد خيار إعادة تعيين ترتيب علامة التبويب. فيما يلي مجموعة نموذجية من قيم خصائص النمط التي يمكن تطبيقها على المكونات الإضافية.

"comp": "md-tooltip",
"attributes": {
    "class": "widget-tabs",
    "message": "Sample Element",
    "style": "max-width: 252px; min-width: 110px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; display: inline-block; margin-bottom: -10px;"
},
Webex Contact Center more actions menu example, showing additional, custom options that can be added after the 'Reset Tab Order' option.

لا يتم دعم ميزة السحب والإسقاط للمكونات المخصصة الإضافية أو الأدوات التي تمت إضافتها إلى القائمة المنسدلة «المزيد من الإجراءات».

أدوات بدون رأس

في القسم بدون رأس، يمكنك إضافة عناصر واجهة مستخدم مخفية ولا تظهر علىAgent Desktop. يتم استخدام هذه الأدوات لتنفيذ المنطق في الخلفية. يُعد هذا القسم مفيدًا لتشغيل الأحداث التي تحدث على سطح المكتب وتنفيذ المنطق الخاص بالأداة. على سبيل المثال، فتح برنامج CRM Screen Pop مخصص لرسالة نصية قصيرة عند وصولها.

مثال:

"headless":{
   "id":"headless",
   "widgets":{
      "comp1":{
         "comp":"headless-widget-one",
         "script":"https://my-cdn.com/dynamic-widgets/headless-widget-one.js",
      },
      "comp2":{
         "comp":"headless-widget-two",
         "script":"https://my-cdn.com/dynamic-widgets/headless-widget-two.js",
      }
   },
   "layout":{
      "areas":[[ "comp1", comp2" ]], 
      "size": { "cols": [1, 1], "rows": [1] } 
      } 
}

مشاركة البيانات من سطح المكتب إلى الأدوات

لتلقي البيانات في الوقت الفعلي من خلال الخصائص أو السمات داخل عنصر واجهة مستخدم مخصص، قم بتعيين قيم STORE المناسبة في تكوين JSON للتخطيط.

بالإضافة إلى ذلك، للوصول إلى البيانات من خلال مشتركي JavaScript SDK، يمكنك أيضًا تمرير البيانات من خلال الخصائص أو السمات. إذا كان المكون الخاص بك مصممًا للتفاعل مع تغييرات الخصائص أو السمات، فستحصل على تحديثات البيانات في الوقت الفعلي منAgent Desktop، وهو ما يسمى بموفر البيانات.

حاليًا، لدينا مزود بيانات واحد ضمن متجر رئيسي. لمزيد من المعلومات، راجع موفر البيانات - قسم خصائص وسمات عنصر واجهة المستخدم في دليل مطور Cisco Webex Contact Centerسطح المكتب.

دعوة حملة المعاينة

يقوم المسؤول بإنشاء الحملات وتكوين وضع الاتصال (المعاينة) وتعيين الحملات للفرق. إذا كان الوكيل جزءًا من فريق تم تعيين الحملات له، فيمكن للوكيل إجراء مكالمة حملة معاينة خارجية. لمزيد من المعلومات، راجع تكوين أوضاع الحملة الصوتية الصادرة في مركز اتصال Webex.

يقوم المسؤول بتكوين ما يلي في التخطيط المخصص لتمكين جهة اتصال حملة المعاينة لوكيل.

جهة الاتصال بالحملة

يضيف المسؤول أداة الاتصال بالحملة في حاوية العنوان للتخطيط المخصص. تعرض جهة اتصال الحملة معلومات الاتصال الخاصة بالعميل استنادًا إلى الخصائص المحددة. لمزيد من المعلومات حول محاذاة التخطيط، راجع صف خصائص التخطيط في صفحة جدول تفاصيل الخصائص.

مثال:


"advancedHeader": [
  {
    "comp": "agentx-preview-campaign",
    "properties": {
      "isCampaignManagementEnabled": "$STORE.agent.isCampaignManagementEnabled",
      "agentDbId": "$STORE.agent.acqueonAgentId",
      "lcmUrl": "$STORE.agent.lcmUrl",
      "isCallInProgress": "$STORE.agentContact.isActiveCall",
      "outdialEntryPointId": "$STORE.agent.outDialEp",
      "teamId": "$STORE.agent.getAcqueonTeamId",
      "campaignManagerAdditionalInfo": "$STORE.agent.campaignManagerAdditionalInfo",
      "orgId": "$STORE.agent.orgId",
      "dialerProxyHost": "$STORE.envVaribles.serviceUrls.dialerProxyHost",
      "isProgressiveCampaignEnabled": "$STORE.app.featuresFlags.isProgressiveCampaignEnabled"    }
  },
  {
    "comp": "agentx-webex"
  },
  {
    "comp": "agentx-outdial"
  },
  {
    "comp": "agentx-notification"
  },
  {
    "comp": "agentx-state-selector"
  }
] 

دليل الاتصال

يتم عرض أداة Call Guide في لوحة المعلومات الإضافية على سطح المكتب. يعرض دليل المكالمات الأسئلة والأجوبة على مستوى الحملة. يُطلب من الوكيل قراءة مجموعة الأسئلة في دليل الاتصال وإرسال الردود.

مثال:

"panel":{
   "comp":"md-tabs",
   "attributes":{
      "class":"widget-tabs"
   },
   "children":[
      {
         "comp":"md-tab",
         "attributes":{
            "slot":"tab",
            "class":"widget-pane-tab"
         },
         "children":[
            {
               "comp":"md-icon",
               "attributes":{ "name":"icon-note_16"
               }
            },
            {
               "comp":"span", "textContent":"Call Guide"
            }
         ],
         "visibility":"CALL_GUIDE"
      },
      {
         "comp":"md-tab-panel",
         "attributes":{
            "slot":"panel", "class":"widget-pane"
         },
         "children":[
            {
               "comp": "acqueon-call-guide",
               "script": "http://localhost:5555//index.js", // include CDN link here
               "wrapper":{
                  "title":"Call Guide", "maximizeAreaName":"app-maximize-area"
               },
               "properties":{
                  "lcmKey":"$STORE.agentContact.getCallGuideProps.LCMKey",
                  "agentDbId":"$STORE.agent.acqueonAgentId",
                  "lcmUrl":"$STORE.agent.lcmUrl",
                  "campaignManagerAdditionalInfo":"$STORE.agent.campaignManagerAdditionalInfo"
                  "orgId": "$STORE.agent.orgId",
                  "dialerProxyHost": "$STORE.envVaribles.serviceUrls.dialerProxyHost",
                  "isProgressiveCampaignEnabled": "$STORE.app.featureFlags.isProgressiveCampaignEnabled"
               }
            }
         ],
         "visibility":"CALL_GUIDE"
      }
   ]
}
  • تم تغيير مراجع خصائص comp التالية. يتم استبدال الوكلاء في قيمة العقار بـ acqueon:
    • تمت إعادة تسمية حملة agentx-preview-campaign إلى حملة معاينة الوكيل
    • تمت إعادة تسمية agentx-call-guide إلى دليل acqueon-call-guide
  • يجب عليك استضافة القائمة ومدير الحملة (LCM) على CDN ثم تحديد عنوان URL في خاصية البرنامج النصي.

سكرين بوب

في تخطيط سطح المكتب، يمكنك تكوين Screen Pop بإحدى الطرق التالية:

  • كصفحة مخصصة

  • كواحدة من الأدوات في الصفحة المخصصة

  • كعلامة تبويب في لوحة المعلومات الإضافية

يتم عرض Screen Pop على سطح المكتب بناءً على العوامل التالية:

بالنسبة للقناة الصوتية:

  • التكوين المحدد في تخطيط سطح المكتب

  • نشاط Screen Pop المحدد في مصمم التدفق

بالنسبة للقنوات الرقمية الجديدة:

  • التكوين المحدد في تخطيط سطح المكتب

  • عقدة سكرين بوب المحددة في منشئ تدفق الاتصال

لمزيد من المعلومات حول تكوين Screen Pop، راجع Screen Pop.

تكوين Screen Pop في شريط التنقل

يمكنك تكوين Screen Pop كصفحة مخصصة، أو كواحدة من الأدوات في صفحة مخصصة. للوصول إلى صفحة Screen Pop المخصصة، انقر فوق رمز Screen Pop على شريط التنقل. للوصول إلى أداة Screen Pop في الصفحة المخصصة، انقر فوق الرمز المخصص على شريط التنقل. لمزيد من المعلومات حول خصائص التنقل، راجع التنقل (الصفحات المخصصة).

مثال: Screen Pop كصفحة مخصصة

{
    "nav": {
        "label": "Screen Pop",
        "icon": "pop-out",
        "iconType": "momentum",
        "navigateTo": "/screenpop",
        "align": "top"
    },
    "page": {
        "id": "agentx-wc-screen-pop",
        "widgets": {
            "comp1": {
                "comp": "agentx-wc-screen-pop",
                "properties": {
                    "screenPopUrl": "$STORE.session.screenpop.screenPopSelector"
                }
            }
        },
        "layout": {
            "areas": [
                ["comp1"]
            ],
            "size": {
                "cols": [1],
                "rows": [1]
            }
        }
    },
    "visibility": "SCREEN_POP"
}

مثال: Screen Pop كأداة في الصفحة المخصصة

"comp1": {
    "comp": "agentx-wc-screen-pop",
    "properties": {
        "screenPopUrl": "$STORE.session.screenpop.screenPopSelector"
    }

إذا لم يتم تكوين Screen Pop في Flow Designer، فستظهر الصفحة المخصصة فارغة. لمزيد من المعلومات حول تكوين Screen Pop في مصمم التدفق، راجع Screen Pop.

تكوين Screen Pop في لوحة المعلومات الإضافية

يمكنك تكوين Screen Pop لتظهر كعلامة تبويب في لوحة المعلومات الإضافية.

افتراضيًا، يظهر Screen Pop كعلامة تبويب فرعية جديدة في علامة تبويب Screen Pop في لوحة المعلومات الإضافية إذا تم تكوين Screen Pop ليتم عرضه كسطح مكتب داخلي في Flow Designer.

أضف السمة التالية في قسم اللوحة لتضمين Screen Pop كعلامة تبويب في لوحة المعلومات الإضافية. لمزيد من المعلومات حول تفاصيل اللوحة، راجع لوحة المعلومات الإضافية.

مثال: Screen Pop كعلامة تبويب في لوحة المعلومات الإضافية

 {
         "comp":"md-tab",
         "attributes":{
            "slot":"tab",
            "class":"widget-pane-tab"
         },
         "children":[
            { "comp": "md-icon", "attributes": { "name": "pop-out_16" }},
            { "comp": "span", "textContent": "Screen Pop" }], 
          "visibility": "SCREEN_POP" 
        }, 
        { 
          "comp": "md-tab-panel", 
          "attributes": { "slot": "panel", "class": "widget-pane" }, 
          "children": [{ "comp": "#SCREEN_POP"
            }
         ],
      }

يحظى خيار عرض Screen Pop المحدد في Flow Designer بالأسبقية على التكوين المحدد في تخطيط سطح المكتب.

على سبيل المثال، ضع في اعتبارك أنك قمت بتكوين إعدادات Screen Pop التالية:

  • Flow Designer - عرض الإعدادات كما في علامة تبويب المتصفح الجديد
  • تخطيط سطح المكتب - كعلامة تبويب في لوحة المعلومات الإضافية

عند حدوث الحدث الذي تم تكوين Screen pop له، يتم عرض Screen Pop خارج سطح المكتب - أي في علامة تبويب متصفح جديدة.

أمثلة حالة استخدام العينة

تقدم الأقسام التالية بعض الأمثلة للرجوع إليها:

تكوين أداة مقاييس إدارة تجربة العملاء والوصول إليها من شريط التنقل

مثال:

{
    "nav": {
        "label": "Customer Experience Management Metrics",
        "icon": "/app/images/wxm.bcd45cc3.svg",
        "iconType": "other",
        "navigateTo": "wxm-metrics",
        "align": "top"
    },
    "page": {
        "id": "wxm-metrics",
        "widgets": {
            "comp1": {
                "comp": "agentx-wc-cloudcherry-widget",
                "attributes": {
                    "metrics": true
                },
                "properties": {
                    "userModel": "$STORE.app.userModel",
                    "spaceId": "",
                    "metricsId": "",
                    "teamId": "$STORE.agent.teamName",
                    "ani": "$STORE.agentContact.taskSelected.ani",
                    "isDarkMode": "$STORE.app.darkMode"
                },
                "wrapper": {
                    "title": "Customer Experience Journey",
                    "maximizeAreaName": "app-maximize-area"
                }
            }
        },
        "layout": {
            "areas": [
                ["comp1"]
            ],
            "size": {
                "cols": [1],
                "rows": [1]
            }
        }
    }
},

للحصول على معرف الفضاء ومعرف المقاييس، راجع الوثائق. Webex Experience Management

استخدام علامات التبويب على الصفحة المخصصة

مثال:

{
    "nav": {
        "label": "Dynamic Tabs",
        "icon": "stored-info",
        "iconType": "momentum",
        "navigateTo": "dynamic-tabs",
        "align": "top"
    },
    "page": {
        "id": "page-id-tabs",
        "widgets": {
            "comp1": {
                "comp": "md-tabs",
                "children": [{
                        "comp": "md-tab",
                        "textContent": "One",
                        "attributes": {
                            "slot": "tab"
                        }
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel"
                        },
                        "children": [{
                            "comp": "widget-two",
                            "script": "http:/my-cdn.com/dynamic-widgets/widget-two.js"
                        }]
                    },
                    {
                        "comp": "md-tab",
                        "textContent": "Two",
                        "attributes": {
                            "slot": "tab"
                        }
                    },
                    {
                        "comp": "md-tab-panel",
                        "textContent": "Two Content",
                        "attributes": {
                            "slot": "panel"
                        }
                    }
                ]
            },
            "comp2": {
                "comp": "widget-two",
                "script": " http:/my-cdn.com/dynamic-widgets/widget-two.js"
            }
        },
        "layout": {
            "areas": [
                ["comp1", "comp2"]
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1]
            }
        }
    }
}

لوحة المعلومات الإضافية الافتراضية مع سجل جهات الاتصال وScreen Pop

مثال:

"panel": {
    "comp": "md-tabs",
    "attributes": {
        "class": "widget-tabs"
    },
    "children": [{
            "comp": "md-tab",
            "attributes": {
                "slot": "tab",
                "class": "widget-pane-tab"
            },
            "children": [{
                "comp": "slot",
                "attributes": {
                    "name": "CONTACT_HISTORY_TAB"
                }
            }]
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel",
                "class": "widget-pane"
            },
            "children": [{
                "comp": "slot",
                "attributes": {
                    "name": "CONTACT_HISTORY"
                }
            }]
        },
    ]
}, {
    "comp": "md-tab",
    "attributes": {
        "slot": "tab",
        "class": "widget-pane-tab"
    },
    {
        "comp": "md-tab",
        "attributes": {
            "slot": "tab",
            "class": "widget-pane-tab"
        },
        "children": [{
            "comp": "slot",
            "attributes": {
                "name": "SCREEN_POP_TAB"
            }
        }],
        "visibility": "SCREEN_POP"
    },
    {
        "comp": "md-tab-panel",
        "attributes": {
            "slot": "panel",
            "class": "widget-pane"
        },
        "children": [{
            "comp": "slot",
            "attributes": {
                "name": "SCREEN_POP"
            }
        }],
        "visibility": "SCREEN_POP"
    }
},

لوحة المعلومات الإضافية مع أداة رحلة تجربة العملاء

مثال:

"panel": {
    "comp": "md-tabs",
    "attributes": {
        "class": "widget-tabs"
    },
    "children": [{
                "comp": "md-tab",
                "attributes": {
                    "slot": "tab"
                },
                "children": [{
                    "comp": "slot",
                    "attributes": {
                        "name": "WXM_JOURNEY_TAB"
                    }
                }],
                "visibility": "WXM_JOURNEY"
            },
            {
                "comp": "md-tab-panel",
                "attributes": {
                    "slot": "panel",
                    "class": "widget-pane"
                },
                "children": [{
                    "comp": "agentx-wc-cloudcherry-widget",
                    "properties": {
                        "userModel": "$STORE.app.userModel",
                        "spaceId": "",
                        "metricsId": "",
                        "teamId": "$STORE.agent.teamName",
                        "ani": "$STORE.agentContact.taskSelected.ani",
                        "isDarkMode": "$STORE.app.darkMode"
                    },
                    "wrapper": {
                        "title": "Customer Experience Journey",
                        "maximizeAreaName": "app-maximize-area"
                    }
                }],
                {
                    "comp": "md-tab",
                    "attributes": {
                        "slot": "tab",
                        "class": "widget-pane-tab"
                    },
                    "children": {
                        "comp": "md-tab",
                        "attributes": {
                            "slot": "tab",
                            "class": "widget-pane-tab"
                        },
                        "children": [{
                            "comp": "slot",
                            "attributes": {
                                "name": "CONTACT_HISTORY_TAB"
                            }
                        }]
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel",
                            "class": "widget-pane"
                        },
                        "children": [{
                            "comp": "slot",
                            "attributes": {
                                "name": "CONTACT_HISTORY"
                            }
                        }]
                    },
                    {
                        "comp": "md-tab",
                        "attributes": {
                            "slot": "tab",
                            "class": "widget-pane-tab"
                        },
                        "children": [{
                            "comp": "slot",
                            "attributes": {
                                "name": "SCREEN_POP_TAB"
                            }
                        }],
                        "visibility": "SCREEN_POP"
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel",
                            "class": "widget-pane"
                        },
                        "children": [{
                            "comp": "slot",
                            "attributes": {
                                "name": "SCREEN_POP"
                            }
                        }],
                        "visibility": "SCREEN_POP"
                    }
                    "visibility": "SCREEN_POP"
                },
            },

التعريب

تدعم واجهة مستخدم سطح المكتب الترجمة بـ 29 لغة.

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

البلغارية، الكاتالونية، الصينية (الصين)، الصينية (تايوان)، الكرواتية، التشيكية، الدنماركية، الهولندية، الإنجليزية (المملكة المتحدة)، الإنجليزية (الولايات المتحدة)، الفنلندية، الفرنسية، الألمانية، المجرية، الإيطالية، اليابانية، الكورية، النرويجية، البولندية، البرتغالية (البرازيل)، البرتغالية (البرتغال)، الرومانية، الروسية، الصربية، السلوفاكية، السلوفينية، الإسبانية، السويدية، والتركية.

تعتمد لغة Desktop UI على إعدادات تفضيلات اللغة في متصفحك. على سبيل المثال، دعنا نعتبر أنك قد اخترت اللغة المفضلة كالفرنسية على متصفح Firefox. عند تشغيل سطح المكتب في متصفح Firefox، تظهر واجهة مستخدم سطح المكتب باللغة الفرنسية (الفرنسية). ومع ذلك، لا يتم ترجمة الرأس الأفقي وشريط التنقل والمكونات الأخرى المضافة في تخطيط سطح المكتب بناءً على إعدادات تفضيلات اللغة في متصفحك.

تعريب مكونات سطح المكتب

لترجمة مكونات سطح المكتب،

  • استخدم مفاتيح الترجمة الموجودة التي تم تعيينها في ملف app.json. إذا لم يتم تعيين مفاتيح الترجمة، يتم استخدام اللغة الافتراضية الإنجليزية (الولايات المتحدة). يمكنك إرسال طلب خدمة إلى دعم Cisco لإضافة مفتاح الترجمة إلى ملف app.json.

    مثال: مفتاح التعريب

    {
        "common": {
            "buttonTitle": "Stop Timer"
        }
    }
  • أدخل الخاصية التالية الحساسة لحالة الأحرف في ملف Desktop Layout JSON لترجمة أحد المكونات:

    "textContent": "$I18N.<key>",
    

    حيث <key>يشير إلى مفتاح الترجمة المقابل في ملف app.json.

مثال: ترجمة مكون رأس الصفحة

"header": {
    "id": "header",
    "widgets": {
        "head1": {
            "comp": "md-button",
            "attributes": {
                "slot": "menu-trigger",
                "style": "height: 64px"
            },
            "children": [{
                    "comp": "span",
                    "textContent": "$I18N.common.buttonTitle",
                }
            },

        },
    }

مثال: ترجمة مكون علامة التبويب في لوحة المعلومات الإضافية

"panel": {
    "comp": "md-tab",
    "attributes": {
        "slot": "tab"
    },
    "children": [{
        "comp": "span",
        "textContent": "$I18N.panelTwo.screenPopTitle"
    }]
}
هل كان هذا المقال مفيدًا؟
هل كان هذا المقال مفيدًا؟