تكوين زر الإجراء لـ 9800 (Unified CM)

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

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

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

1	قم بتسجيل الدخول إلىCisco Unified Communications Manager Administration.
2	قم بتنفيذ أحد الإجراءات التالية حسب الحاجة: لتكوين جميع الهواتف التي تم نشرها، انتقل إلى النظام > تكوين هاتف المؤسسة. لتكوين الهواتف التي تشارك نفس ملف تعريف الهاتف، انتقل إلى الجهاز > إعدادات الجهاز > ملف تعريف الهاتف العام. لتكوين هاتف فردي، انتقل إلى الجهاز > الهاتف. ثم ابحث عن هاتفك وافتح صفحة تكوين الهاتف. يتبع التكوين بنية هرمية: تحظى إعدادات الأجهزة الفردية بالأسبقية على الإعدادات في ملف تعريف الهاتف العام ومستوى المؤسسة. تتجاوز إعدادات ملف تعريف الهاتف الشائعة الإعدادات على مستوى المؤسسة
3	قم بتخصيص إعدادات زر الإجراء باستخدام المعلمات التالية بناءً على حالات الاستخدام الخاصة بك. هناك ثلاث مجموعات من المعلمات لزر الإجراء، كل منها يتوافق مع خدمة ذات مشغل فريد. إذا تم تحديد مشغل خدمة في مجموعات متعددة، فإن الإعدادات في المجموعة 1 لها الأولوية على تلك الموجودة في المجموعة 2 و3، بينما تأخذ المجموعة 2 الأولوية على المجموعة 3. مكالمات الطوارئ قم بتكوين المعلمات التالية: وظيفة زر الإجراء: حدد مكالمة الطوارئ. وجهة خدمة زر الإجراء: أدخل رقم الهاتف أو URI لخدمة الطوارئ. اسم خدمة زر الإجراء (اختياري): حدد اسمًا للخدمة المرتبطة بمشغل الإجراء. سيتم عرض هذا الاسم في الرسالة التي تظهر على الشاشة عندما يضغط المستخدم على الزر، مع الإشارة إلى الحدث الذي سيتم تشغيله. إذا لم يتم تحديد أي اسم، فسيتم استخدام مكالمة الطوارئ كاسم العرض. تأخير الطلب: قم بتعيين فترة المهلة (بالثواني) للهاتف لبدء مكالمة طوارئ بعد اكتشاف المشغل. القيمة الافتراضية هي 5 ثوانٍ. في حالة الضبط على 0، يتم إجراء المكالمة فور اكتشاف المشغل. مشغل الخدمة حدد مشغلًا من القائمة: ضغطة واحدة أو ضغطة طويلة أو اضغط 3 مرات. مكالمة طوارئ صامتة (اختيارية): افتراضيًا، تعمل مكالمة الطوارئ كمكالمة ثنائية الاتجاه، على غرار المكالمات الصادرة الأخرى. عند تمكين مكالمة الطوارئ الصامتة، يكون الصوت صامتًا على جانب المتصل لتجنب جذب الانتباه أثناء المكالمة الجارية. يمكن لمستلم المكالمة فقط إنهاء مكالمة الطوارئ الصامتة. أثناء مكالمة طوارئ صامتة، سيتم تجميد الشاشة على الهاتف 9811 و 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 بهذا التنسيق: `tel:<phonenumber or SIP URI> + <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 للاتصال في وجهة الخدمة، فإن تمكين هذه الميزة سيؤدي إلى كتم مكالمات الطوارئ. افتراضيًا، تعمل مكالمة الطوارئ كمكالمة ثنائية الاتجاه، على غرار المكالمات الصادرة الأخرى. عند الضبط على التمكين، يكون الصوت صامتًا على جانب المتصل لتجنب جذب الانتباه أثناء المكالمة الجارية. يمكن لمستلم المكالمة فقط إنهاء المكالمة. أثناء مكالمة طوارئ صامتة، سيتم تجميد الشاشة على الهاتف 9811 و 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 or SIP URL> + <Service RUL>`. مثال: `tel:1234 + https://10.11.20.159/path/service.xml`. يتم أيضًا دعم استدعاء عناوين URL الخاصة بـ 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	الإعداد الافتراضي: معطل الخيارات: ممكّنة، معطلة	تم تصميم مكالمة الطوارئ الصامتة للمساعدة السرية في المواقف الخطرة. إنه يمكّن المستخدمين من طلب المساعدة دون إحداث أي ضوضاء. عند التمكين، يمكن للمستخدمين إجراء مكالمات أحادية الاتجاه باستخدام زر الإجراء. بعد إجراء مكالمة الطوارئ الصامتة، يمكن للطرف الآخر فقط إنهاء المكالمة. لتجنب لفت الانتباه أثناء المكالمة الجارية، سيتم تجميد الشاشة على الهاتف 9811 و 9841، بينما سيتم إيقاف تشغيل الشاشة على الهاتف 9851 و 9861 و 9871. يقفل الهاتف جميع الوظائف أثناء مكالمة طوارئ صامتة، افتراضيًا. للسماح للمستخدمين باستعادة التشغيل العادي للهاتف مع الحفاظ على مكالمة الطوارئ الصامتة، قم بتمكين ميزة السماح باسترداد مكالمات الطوارئ الصامتة. عند التعطيل، تعمل مكالمة الطوارئ كمكالمة ثنائية الاتجاه، على غرار المكالمات الصادرة الأخرى.
السماح باسترداد مكالمات الطوارئ الصامتة	الإعداد الافتراضي: لا الخيارات: نعم، لا	يتحكم فيما إذا كان بإمكان المستخدمين استرداد وظائف الهاتف أثناء مكالمة طوارئ صامتة. افتراضيًا، بمجرد بدء مكالمة طوارئ صامتة، يقفل الهاتف جميع الوظائف حتى ينهي مستلم المكالمة المكالمة. عند تعيين هذه المعلمة إلى نعم، يمكن للمستخدمين الضغط على أي مفتاح لاستعادة تشغيل الهاتف العادي مع الحفاظ على مكالمة الطوارئ. يظل صوت المكالمة صامتًا ما لم يقم المستخدم بزيادة مستوى الصوت باستخدام مفتاح مستوى الصوت.

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

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

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

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

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--header 'Authorization: $SS'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}'

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

الجدول 2. ترميز النسبة المئوية للأحرف المحجوزة
شخصية	ترميز النسبة المئوية
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

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

--method POST
--header %27Content-Type: application/xml%27
--body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis is for HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27

الجدول 3. وحدات الماكرو المدعومة
اسم الماكرو	التوسع الكلي
#DEVICENAME#	اسم الجهاز المعروض في نظام الاتصال. على سبيل المثال، SEP845A3EC21288
$SS	سر الخدمة الذي يعرض سلسلة مقنعة في صفحة تكوين الهاتف، مثل سر المصادقة أو الرمز المميز أو كلمة المرور.

Cisco AI Assistant

شكرًا على ملاحظاتك.

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

المراجع

المعلمات الخاصة بزر الإجراء

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

الشركات صغيرة الحجم

المؤسسة

الأجهزة

حلول لـ

الموارد

الشركة