הגדר את לחצן הפעולה עבור 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 יכבה. כל שאר הפונקציות אינן נגישות. הטלפון משחזר פעולה רגילה לאחר שהנמען מסי ים את השיחה. אפשר אחזור שיחות חירום שקט (אופציונלי): הפעל תכונה זו אם אתה מאפשר ל משתמשים ללחוץ על מקש כלשהו כדי לשחזר את פעולת הטלפון הרגילה תוך שמירה על שיחת החי רום. שמע השיחה נשאר שקט אלא אם המשתמש מגדיל את עוצמת הקול באמצעות מקש עוצמת הקול. שירותים מותאמים אישית הגדר את הפרמטרים הבאים: פונקציית לחצן פעולה: בחר מותאם אישית. י@@ עד שירות לחצן פעולה: הזן את כתובת האתר של השירות המותאם אישית. כתובת האתר חייבת להתחיל ב `http://`- או `https://`, לדוגמה, `https://10.11.20.159/path/service.xml`. שם שירות לחצן פעולה (אופציונלי): ציין שם לשירות המשויך להפעלה. שם זה יוצג בהודעה שעל המסך כאשר המשתמש לוחץ על הכפתור, המציין איזה שירות יופעל. כאשר לא צוין שם, שירות מותאם אישית ישמש כשם התצוגה. שדה תוכן מותאם אישית (אופציונלי): אם ברצ ונך לאפשר לטלפון לשלוח בקשת פוסט HTTP בעת לחיצה על לחצן הפעולה, הזן את נתוני HTTP כגון שיטה, כותרת ותוכן פוסט, באורך מרבי של 1024 תווים. לקבלת דוגמאות לסקריפט POST והתחביר, ראה בקשת HTTP Post עבור לחצן הפעולה. עיכוב חיוג: הגדר את פרק הזמן הקצוב, בשניות, כדי שהטלפון יתחיל אירוע לאחר גילוי ההדק. ערך ברירת המחד ל הוא 5 שניות. כאשר מוגדר ל- 0, האירוע מתחיל מיד עם זיהוי ההדק. טריגר שירות בחר טרי גר מהרשימה: לחיצה אחת, לחיצה ארוכה או לחץ 3 פעמים. סוד שירות (אופציונלי): הז ן את סוד האימות, האסימון או הסיסמה אם השירות המותאם אישית שלך דורש אימות כדי לגשת אליו. הסוד שהוזן מוצג כמחרוזת מוסווה וניתן להפנות אותו באמצעות המאקרו `$SS`בש דה תוכן מותאם אישית ובי עד שירות לחצן פעולה. טריגרים מרובים הגדר את הפרמטרים בכל קבוצה בהתאמה. עיין בס עיפים שיחות חירום ושירותים מותאמים אישית לעיל. טריגר יחיד לאירועים מרובים הגדר את הפרמטרים הבאים להקצאת אירועים מרובים לטריגר: פונקציית לחצן פעולה: בחר מותאם אישית. י@@ עד שירות לחצן פעולה: הזן את מספר הטלפון להתקשר ואת כתובת האתר של שירות XML בפורמט זה: `tel:<phonenumber or SIP URI> + <serviceURL>` כתובת האתר חייבת להתחיל ב- `http://`או `https://`. דוגמה: `tel:1234 + https://10.11.20.159/path/service.xml` שם שירות לחצן פעולה (אופציונלי): ציין שם לשירות המשויך להפעלה. שם זה יוצג בהודעה שעל המסך כאשר המשתמש לוחץ על הכפתור, המציין איזה שירות יופעל. כאשר לא צוין שם, שירות מותאם אישית ישמש כשם התצוגה. שדה תוכן מותאם אישית (אופציונלי): אם ברצ ונך לאפשר לטלפון לשלוח בקשת פוסט HTTP בעת לחיצה על לחצן הפעולה, הזן את נתוני 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 של שירות החירום. בעת הגדרת הלחצן עבור שירות מותאם אישית, הזן את כתובת האתר של השירות. כתובת האתר חייבת להתחיל ב- `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`. התקשרות ל- 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 כאשר לוחצים על הפעולה. אם השירות דורש אימות כדי לגשת, הקפד להכניס את סוד האימות בשדה סוד השירות. בנתוני HTTP, השתמש במאקרו `$SS`כהפניה לסוד השירות. לקבלת דוגמאות ותחביר, ראה בק שת HTTP Post עבור לחצן הפעולה.
סוד שירות 1 ~ 3	ברירת מחדל: ריק	סוד שירות יכול להיות סוד אימות, אסימון או סיסמה. הסוד שהוזן מוצג כמחרוזת מוסווה וניתן להפנות אותו באמצעות המאקרו `$SS`בש דה תוכן מותאם אישית ובי עד שירות לחצן פעולה.
טריגר שירות 1 ~ 3	ברירת מחדל: לחיצה אחת אפשרויות: לחיצה אחת, לחיצה ארוכה, לחץ 3 פעמים	בחר כיצד משתמשים יכולים לבצע שיחת חירום או ליזום שירות מותאם אישית באמצעות לחצן הפעולה של הטלפון. לחיצה יחידה: לחץ על לחצן הפעולה כדי להפעיל את השיחה או השירות המשויכים. לחיצה ארוכה: לחץ על לחצן הפעולה כלפי מטה למשך 2 שניות לפחות כדי להפעיל את השיחה או השירות המשויכים. לחץ 3 פעמים: לחץ על כפתור הפעולה שלוש פעמים במ רווחים של פחות משתי שניות בין כל לחיצה כדי להפעיל את השי חה או השירות המשויכים. אל תחזור על טריגר במספר שירותים, מכיוון שהפרמטרים בעלי עדי פות נמוכה יותר לא יפעלו. סדר העדיפות, מהגבוה לנמוך ביותר, הוא כדלקמן: קבוצה 1, קבוצה 2, קבוצה 3.
עיכוב חיוג החוצה 1 ~ 3	ברירת מחדל: 5 אפשרויות: 0 - 30	הגדר את פרק הזמן הקצוב, בשניות, כדי שהטלפון יפעיל שיחת חירום או פעולה מותאמת אישית לאחר לחיצה על לחצן הפעולה. הגדר אותו ל- 0 אם אתה מעדיף שהטלפון יבצע את השיחה או יפעיל אירוע מיד עם גילוי ההדק, כפי שצוין בלחיצה אחת, לחיצה ארוכה או לחיצה משולשת על הכפתור.
שיחת חירום שקטה 1 ~ 3	ברירת מחדל: מושבת אפשרויות: מופעל, מושבת	שיחת חירום שקטה מיועדת לסיוע דיסקרטי במצבים מסוכנים. זה מאפשר למשתמשים לבקש עזרה מבלי להשמיע רעש. כאשר מופעל, משתמשים יכולים לבצע שיחות חד כיווניות באמצעות לחצן הפעולה. לאחר ביצוע שיחת החירום השקטה, רק הצד השני יכול לסיים את השי חה. כדי להימנע משיכת תשומת לב במהלך השיחה המתמשכת, המסך בט לפון 9811 ו- 9841 יקפא, בעוד המסך בטלפון 9851, 9861 ו- 9871 יכבה. הטלפון נועל את כל הפונקציות במהלך שיחת חירום שקטה, כברירת מחדל. כדי לאפשר למשתמשים לש חזר את פעולת הטלפון הרגילה תוך שמירה על שיחת החירום השקטה, הפעל את התכונה אפשר אח זור שיחות חירום שק טה. כאשר היא מושבתת, שיחת החירום מתפקדת כשיחה דו כיוונית, בדומה לשי חות יוצאות אחרות.
אפשר אח זור שיחת חירום שקטה	ברירת מחדל: לא אפשרויות: כן, לא	קובע אם משתמשים יכולים לאחזר את הפונקציונליות של הטלפון במהלך שיחת חירום שקטה. כברירת מחדל, לאחר הפעלת שיחת חירום שקטה, הטלפון נועל את כל הפונקציות עד שמקבל השיחה מסיים את השיחה. כאשר פרמטר זה מוגדר כ Yes, משתמשים יכולים ללחוץ על כל מקש כדי לשחזר את פעולת הטלפון הרגילה תוך שמירה על שיחת החירום. שמע השי חה נשאר שקט אלא אם המשתמש מגדיל את עוצמת הקול באמצעות מקש עוצמת הקול.

בקשת פוסט HTTP עבור כפתור הפעולה

ניתן להגדיר את לחצן הפעולה בסדרת Cisco Desk Phone 9800 להפעלת יישומי XML באמצעות בקשות HTTP Post.

בש דה תוכן מותאם אישית, הז ן את סקריפט הבקשה המותאם אישית שלך. ניתן לציין סוג תוכן XML או JSON ולכלול פקודות מאקרו לבקשה. לדוגמה, $SSניתן להוסיף לסקריפט כדי לאחזר את סוד האימות, האסי מון או הסיסמה המסופקים בשדה סוד השירות.

הדוגמאות הבאות הן ב- 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#	שם ההתקן המוצג במערכת השיחה. לדוגמה, ספ845A3EC 21288
$SS	סוד שירות המציג מחרוזת מוסווה בדף תצורת הטלפון, כגון סוד אימות, אסימון או סיסמה.

Cisco AI Assistant

תודה על המשוב.

התאם אישית את לחצן הפעולה

הפניות

פרמטרים עבור לחצן הפעולה

בקשת פוסט HTTP עבור כפתור הפעולה

עסק קטן

ארגון

מכשירים

פתרונות עבור

משאבים

חברה