تخصيص زر الإجراء

تتطلب الخيارات المخصصة لزر الإجراء في سلسلة هواتف Cisco Desk Phone 9800 دعما محددا للبرامج الثابتة ل PhoneOS. راجع الجدول التالي للحصول على التفاصيل:

الميزةإصدار البرنامج الثابت المطلوب
مكالمة طوارئPhoneOS 3.0.1 والإصدارات الأحدث
خدمة مخصصةPhoneOS 3.2.1 والإصدارات الأحدث
مشغلات متعددةPhoneOS 3.3.1 والإصدارات الأحدث
منشور HTTPPhoneOS 3.3.1 والإصدارات الأحدث
أحداث متعددة على مشغل واحدPhoneOS 3.4.1 والإصدارات الأحدث
1

قم بتسجيل الدخول إلى Cisco Unified Communications Manager Administration.

2

قم بأحد الإجراءات التالية حسب الحاجة:

  • لتكوين جميع الهواتف المنشورة، انتقل إلى تكوين النظام > المؤسسة.
  • لتكوين الهواتف التي تشترك في ملف تعريف الهاتف نفسه، انتقل إلى إعدادات الجهاز > الجهاز> ملف تعريف الهاتف العام.
  • لتكوين هاتف فردي، انتقل إلى الجهاز > الهاتف. ثم ابحث عن هاتفك وافتح صفحة تكوين الهاتف.

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

  • إعدادات الجهاز الفردية لها الأسبقية على الإعدادات في ملف تعريف الهاتف العام ومستوى المؤسسة
  • تتجاوز إعدادات ملف تعريف الهاتف العامة الإعدادات على مستوى المؤسسة

3

قم بتخصيص إعدادات زر الإجراء باستخدام المعلمات التالية بناء على حالات الاستخدام الخاصة بك.

هناك ثلاث مجموعات من المعلمات لزر الإجراء ، كل منها يتوافق مع خدمة ذات مشغل فريد. إذا تم تحديد مشغل خدمة في مجموعات متعددة، فإن الإعدادات في المجموعة 1 لها الأولوية على تلك الموجودة في المجموعة 2 و3، بينما تأخذ المجموعة 2 الأولوية على المجموعة 3.

  • مكالمات الطوارئ

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

    • وظيفة زر الإجراء: حدد مكالمة طوارئ.

    • زر الإجراء وجهة الخدمة: أدخل رقم الهاتف أو URI خدمة الطوارئ.

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

    • تأخير الطلب: قم بتعيين فترة المهلة (بالثواني) للهاتف لبدء مكالمة طوارئ بعد اكتشاف المشغل. القيمة الافتراضية هي 5 ثانية. إذا تم ضبطها على 0 ، يتم إجراء المكالمة فور اكتشاف المشغل.

    • مشغل الخدمة حدد مشغل من القائمة: ضغطة واحدة أو ضغطة طويلة أو اضغط 3 مرات.

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

      أثناء مكالمة الطوارئ الصامتة، ستتجمد الشاشة الموجودة على الهاتف 9841، بينما سيتم إيقاف تشغيل شاشة الهاتف 9851 و9861 و9871. لا يمكن الوصول إلى جميع الوظائف الأخرى. يستعيد الهاتف التشغيل العادي بعد أن ينهي المستلم المكالمة.

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

  • الخدمات المخصصة

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

    • وظيفة زر الإجراء: حدد مخصص.

    • وجهة خدمة زر الإجراء: أدخل عنوان URL للخدمة المخصصة. يجب أن يبدأ عنوان URL ب http:// أو https://، على سبيل المثال، https://10.11.20.159/path/service.xml .

    • زر الإجراء اسم الخدمة(اختياري): حدد اسما للخدمة المرتبطة بالمشغل. سيتم عرض هذا الاسم في الرسالة التي تظهر على الشاشة عندما يضغط المستخدم على الزر ، مما يشير إلى الخدمة التي سيتم تشغيلها. في حالة عدم تحديد اسم، سيتم استخدام الخدمة المخصصة كاسم العرض.

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

      للحصول على أمثلة للبرنامج النصي POST وبناء الجملة، راجع طلب HTTP Post لزر الإجراء.

    • تأخير الطلب: قم بتعيين فترة المهلة، بالثواني، للهاتف لبدء حدث ما بعد اكتشاف المشغل. القيمة الافتراضية هي 5 ثانية. عند التعيين إلى 0 ، يبدأ الحدث فور اكتشاف المشغل.

    • مشغل الخدمة حدد مشغل من القائمة: ضغطة واحدة أو ضغطة طويلة أو اضغط 3 مرات.

    • سر الخدمة (اختياري): أدخل سر المصادقة أو الرمز المميز أو كلمة المرور إذا كانت الخدمة المخصصة تتطلب المصادقة للوصول إليها. يتم عرض السر الذي تم إدخاله كسلسلة مقنعة ويمكن الرجوع إليه باستخدام الماكرو $SS في حقل المحتوى المخصص ووجهة خدمة زر الإجراء.

  • مشغلات متعددة

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

  • مشغل واحد لأحداث متعددة

    قم بتكوين المعلمات التالية لتعيين أحداث متعددة لمشغل:

    • وظيفة زر الإجراء: حدد مخصص.

    • زر الإجراء وجهة الخدمة: أدخل رقم الهاتف المراد الاتصال به وعنوان URL لخدمة XML بهذا التنسيق:

      الهاتف:<رقم الهاتف أو URI> SIP + <serviceURL>

      يجب أن يبدأ عنوان URL ب http:// أو https://.

      مثال: tel:1234 + https://10.11.20.159/path/service.xml

    • زر الإجراء اسم الخدمة(اختياري): حدد اسما للخدمة المرتبطة بالمشغل. سيتم عرض هذا الاسم في الرسالة التي تظهر على الشاشة عندما يضغط المستخدم على الزر ، مما يشير إلى الخدمة التي سيتم تشغيلها. في حالة عدم تحديد اسم، سيتم استخدام الخدمة المخصصة كاسم العرض.

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

      للحصول على أمثلة للبرنامج النصي POST وبناء الجملة، راجع طلب HTTP Post لزر الإجراء.

    • تأخير الطلب: قم بتعيين فترة المهلة، بالثواني، للهاتف لبدء حدث ما بعد اكتشاف المشغل. القيمة الافتراضية هي 5 ثانية. عند التعيين إلى 0 ، يبدأ الحدث فور اكتشاف المشغل.

    • مشغل الخدمة حدد مشغل من القائمة: ضغطة واحدة أو ضغطة طويلة أو اضغط 3 مرات.

    • سر الخدمة (اختياري): أدخل سر المصادقة أو الرمز المميز أو كلمة المرور إذا كانت الخدمة المخصصة تتطلب المصادقة للوصول إليها. يتم عرض السر الذي تم إدخاله كسلسلة مقنعة ويمكن الرجوع إليه باستخدام الماكرو $SS في حقل المحتوى المخصص ووجهة خدمة زر الإجراء.

    • مكالمة طوارئ صامتة (اختيارية): إذا قمت بتضمين رقم هاتف أو URI طلب في وجهة الخدمة، فإن تمكين هذه الميزة سيؤدي إلى كتم صوت مكالمات الطوارئ.

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

      أثناء مكالمة الطوارئ الصامتة، ستتجمد الشاشة الموجودة على الهاتف 9841، بينما سيتم إيقاف تشغيل شاشة الهاتف 9851 و9861 و9871. لا يمكن الوصول إلى جميع الوظائف الأخرى. يستعيد الهاتف التشغيل العادي بعد أن ينهي المستلم المكالمة.

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

لمزيد من المعلومات حول هذه المعلمات، راجع معلمات زر الإجراء.

4

حدد حفظ.

5

حدد تطبيق التكوين.

مراجع

معلمات زر الإجراء

تتوفر المعلمات في تكوين هاتف المؤسسة وملف تعريف الهاتف العام وتكوين الهاتف الفردي.

الجدول 1. معلمات زر الإجراء
المعلمةالافتراضي والخياراتالوصف
وظيفة زر العمل 1 ~ 3

الافتراضي: إيقاف

الخيارات: إيقاف، مكالمة طوارئ، مخصص

يمكنك تكوين الزر بخدمة معينة.

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

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

اسم خدمة زر الإجراء 1 ~ 3

القيمة الافتراضية: فارغ

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

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

وجهة خدمة زر الإجراء 1 ~ 3

القيمة الافتراضية: فارغ

قم بتوفير وجهة الخدمة بأحد التنسيقات التالية استنادا إلى الخدمة المعينة لزر الإجراء:

  • بالنسبة لخدمات مكالمات الطوارئ، أدخل رقم هاتف أو URI خدمة الطوارئ.

  • عند تهيئة الزر لخدمة مخصصة، أدخل عنوان URL للخدمة. يجب أن يبدأ عنوان URL ب http:// أو https://. على سبيل المثال ، https://10.11.20.159/path/service.xml.

  • لتهيئة الزر لبدء أحداث متعددة بمشغل واحد، أدخل tel:<phonenumber أو عنوان URL ل SIP> + <Service RUL>. مثال: tel:1234 + https://10.11.20.159/path/service.xml.

    الاتصال بعناوين URI ل SIP مدعوم أيضا. أدخل URI بتنسيق tel: sip 4567@co.webex.com

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

لا يمكن استخدام أرقام الهواتف كوجهات للخدمات المخصصة. إذا قمت بتكوين زر الإجراء كزر مخصص وأدخلت رقم هاتف كوجهة الخدمة، عرض رسالة تنبيه على الهاتف تشير إلى أنه لم يتم تكوين الزر. بدلا من ذلك، يمكنك إضافة رقم هاتف بهذا التنسيق tel:<phone number>، على سبيل المثال، tel:1234.

إذا لم يكن مسموحا لك بإدخال عنوان URL بما في ذلك علامة العطف (&)، فاستخدم ٪26 كبديل. على سبيل المثال، أدخل http://1.2.3.4/phone?a=1%26b=2%26c=3 بدلا من http://1.2.3.4/phone?a=1&b=2&c=3.

حقل المحتوى المخصص 1 ~ 3

القيمة الافتراضية: فارغ

يعمل هذا الإعداد فقط عند تعيين وظيفة زر الإجراء على مخصص.

أدخل بيانات HTTP مثل الأسلوب والرأس ومحتوى النشرة، بحد أقصى للطول 1024 حرفا. عند التهيئة، يرسل الهاتف طلب HTTP Post عند الضغط على الإجراء.

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

للحصول على أمثلة وبناء الجملة، راجع طلب نشر HTTP لزر الإجراء.

سر الخدمة 1 ~ 3

القيمة الافتراضية: فارغ

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

مشغل الخدمة 1 ~ 3

الإعداد الافتراضي: ضغطة واحدة

الخيارات: ضغطة واحدة ، ضغطة طويلة ، اضغط 3 مرات

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

ضغطة واحدة: اضغط على زر الإجراء لتشغيل المكالمة أو الخدمة المرتبطة.

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

اضغط 3 مرات: اضغط على زر الإجراء ثلاث مرات بفواصل زمنية تقل عن ثانيتين بين كل ضغطة لتشغيل المكالمة أو الخدمة المرتبطة.

لا تكرر المشغل عبر خدمات متعددة، لأن المعلمات ذات الأولوية المنخفضة لن تعمل. ترتيب الأولوية ، من الأعلى إلى الأدنى ، هو كما يلي: المجموعة 1 ، المجموعة 2 ، المجموعة 3.

تأخير الاتصال 1 ~ 3

القيمة الافتراضية: 5

خيارات: 0 - 30

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

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

مكالمة طوارئ صامتة 1 ~ 3

الإعداد الافتراضي: معطل

الخيارات: ممكن، معطل

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

  • عند التمكين ، يمكن للمستخدمين إجراء مكالمات أحادية الاتجاه باستخدام زر الإجراء.

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

  • عند تعطيلها، تعمل مكالمة الطوارئ كمكالمة ثنائية الاتجاه، على غرار المكالمات الصادرة الأخرى.

السماح باسترداد مكالمات الطوارئ بصمت

القيمة الافتراضية: لا

الخيارات: نعم، لا

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

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

طلب نشر HTTP لزر الإجراء

يمكن تكوين زر الإجراء في Cisco Desk Phone 9800 Series لتشغيل تطبيقات XML من خلال طلبات HTTP Post.

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

الأمثلة التالية موجودة في XML وJSON:

نموذج #1: XML - طريقة POST - رأس "نوع المحتوى: تطبيق / xml" - رأس "تفويض: اسم مستخدم الحامل: $SS" - النص الأساسي "<البيانات الوصفية><الزناد>True< / Trigger><Description>هذا مخصص ل HTTP POST XML</Description></MetaData>' نموذج #2: JSON - طريقة POST - رأس "نوع المحتوى: تطبيق / json" - رأس "التفويض: $SS" - الجسم '{"الأحداث":[{"evtid":"12345",  "المعلمات": {"الزناد": صحيح} ، "الوصف": "هذا ل HTTP POST JSON"}]}'

يتطلب Cisco Unified Communications Manager (UCM) ترميز النسبة المئوية للأحرف المحجوزة وفقا ل RFC 3986.

الجدول 2. النسبة المئوية للترميز للأحرف المحجوزة
حرفترميز النسبة المئوية
amp&%26
'%27
&quot%22
&lt ٪3c
&gt ٪3e

البرنامج النصي التالي هو مثال على استخدام سلاسل مشفرة بالنسبة المئوية.

--طريقة POST --header٪27نوع المحتوى: تطبيق/xml٪27 --body ٪27٪3cMetaData٪3e٪3cTrigger٪3eTrue٪3c/Trigger٪3e٪3cDescription٪3eهذا ل HTTP POST XML٪3c/الوصف٪3e٪3c/البيانات الوصفية٪3e٪27
الجدول 3. وحدات الماكرو المدعومة
اسم الماكروتوسيع الماكرو
#DEVICENAME#اسم الجهاز المعروض في نظام الاتصال. على سبيل المثال، SEP845A3EC21288
$SSسر الخدمة الذي يعرض سلسلة مقنعة في صفحة تكوين الهاتف، مثل سر المصادقة أو الرمز المميز أو كلمة المرور.