- בית
- /
- מאמר
XML עבור טלפונים ב-BroadWorks
מאמר עזרה זה חל על Cisco Desk Phone 9800 Series ו-Cisco Video Phone 8875 הרשומים ב-Cisco BroadWorks. קרא מאמר זה לקבלת אובייקטי XML נתמכים, מזהי URI והשלבים לקביעת התצורה של שירותי XSI בדף האינטרנט של הטלפון.
סקירה כללית
ממשק שירותי XML (XSI) הוא פרוטוקול המאפשר תקשורת בין יישומים למערכת הטלפונים. באפשרותך להוסיף שירותי XSI משלך לטלפון באמצעות אובייקטי XML ומזהי URI נתמכים.
לאחר רישום הטלפון לשירותים, משתמשים יכולים לגשת לכל השירותים שתצורתם נקבעה בטלפון על-ידי ניווט אל הגדרות>רשת ושירות
Cisco XML services הוא שם ברירת המחדל. באפשרותך גם לשנות את השם. כדי לספק גישה נוחה למשתמשים, באפשרותך להוסיף את היישומים XML למקשים מהירים או למקשי קו.התכונות הנתמכות הן:
- הודעות (תמונות וטקסט)
- ההחלפה
אובייקטי XML נתמכים
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (למעט 9841)
-
CiscoIPPhoneStatusFile (למעט 9841)
-
CiscoIPPhoneExecute
מזהי URI נתמכים
-
התקן
-
חיוג
-
EditDail
-
אתחול
-
מפתח
-
הפעל (צלצולים בלבד)
-
מקש מהיר
לקבלת פרטים נוספים אודות תצורת שירות XSI, ראה Cisco Unified IP Phone הערות פיתוח יישומי שירותים.
קביעת תצורה של טלפון להתחברות לשירות XML
1 |
גישה אל דף האינטרנט של ניהול הטלפון. |
2 |
בחר . |
3 |
במקטע שירות XML, הגדר את הפרמטרים XML שם שירות היישום ו - XML כתובת URL של שירות יישומים כפי שהוגדרו בפרמטרים עבור שירותי XML. |
4 |
(אופציונלי) כדי להוסיף אימות לצורך גישה לשירות היישומים, הגדר שדות תזות:XML שם משתמש,XML סיסמה,CISCO XML EXE Enable ומצב אימות CISCO XML EXE. |
5 |
לחץ על שמור את כל השינויים. |
פרמטרים עבור שירותי XML
הטבלה הבאה מגדירה את הפונקציה והשימוש של פרמטרי יישום XML במקטע שירות XML תחת בממשק האינטרנט של הטלפון. הוא בנוסף מגדיר את תחביר המחרוזת אשר מתווסף אל קובץ התצורה של הטלפון (cfg.xml) עם קוד XML כדי להגדיר תצורת פרמטר.
פרמטר |
ברירת מחדל ואפשרויות |
תיאור |
---|---|---|
שם שירות יישום XML |
ברירת מחדל: ריק |
שם יישום XML. השם מוצג בטלפון כבחירת יישום אינטרנט. ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:
|
כתובת URL של השירות יישום XML |
ברירת מחדל: ריק |
כתובת ה-URL בה ממוקם יישום ה-XML. ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:
משתני מאקרו נתמכים בכתובות ה-URL של XML. לקבלת משתני המאקרו החוקיים, ראה משתני מאקרו הנתמכים בכתובות XML URL. רק פרוטוקולי HTTP או HTTP נתמכים בכתובת ה-URL. |
שם משתמש XML |
ברירת מחדל: ריק |
שם משתמש של שירות XML למטרות אימות. ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:
|
סיסמת XML |
ברירת מחדל: ריק |
סיסמת שירות XML עבור שם משתמש XML שצוין. הסיסמה שהזנת בשדה זה מוצגת בקובץ התצורה (cfg.xml) כסיסמה הבאה:
|
הפעלת CISCO XML EXE |
ברירת מחדל: לא אפשרויות: 'כן', 'לא' |
מציין באם נדרש אימות כדי לגשת לשרת יישומי XML. ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:
|
מצב אימות CISCO XML EXE |
ברירת מחדל: אישור מקומי אפשרויות: מהימן, אישור מקומי, אישור מרחוק |
ציון מצב האימות עבור Cisco XML EXE.
ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:
|
הוספת יישום XML למקש מהיר
הוסף את היישומים הנמצאים בשימוש תכוף למקשים מהירים כדי שמשתמשים יוכלו לגשת לשירות בקלות.
לפני שאתה מתחיל
שירות היישומים XML הוגדר כראוי.
1 |
גישה אל דף האינטרנט של ניהול הטלפון. |
2 |
בחר . |
3 |
בקטע מקשים מהירים ניתנים לתכנות , הגדר את הפעל מקש מהיר ניתן לתכנותלמצב כן. ניתן בנוסף להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בתבנית הבאה:
|
4 |
במקטע מקשים מהירים הניתנים לתכנות, ערוך את השדות הזמינים של PSK1 עד PSK16 בתבנית זו: fnc=xml;url=<xml_app_path>; nme=<app_name>
כאשר
ניתן בנוסף להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בתבנית הבאה:
כאשר n הוא מספר המקש הרך. |
5 |
לחץ על שמור את כל השינויים. |
הוספת יישום XML למקש קו
הוסף את היישומים הנמצאים בשימוש תכוף למקשי קו כדי שמשתמשים יוכלו לגשת לשירותים בקלות.
לפני שאתה מתחיל
שירות היישומים XML הוגדר כראוי.
1 |
גישה אל דף האינטרנט של ניהול הטלפון. |
2 |
בחר . |
3 |
בחר מקש קו. |
4 |
הגדר את הפרמטר Extension ל- Disabled כדי להשבית את השלוחה. אם התכונה Direct PLK Configuration מושבתת, עליך להשבית את התוסף כדי להוסיף פונקציה מורחבת למקש הקו. אם התכונה מופעלת, תוכל לדלג על שלב זה. לקבלת פרטים, ראה הפעלת תצורת Direct PLK. |
5 |
בפרמטר Extended Function, הזן מחרוזת בפורמט זה: fnc=xml;url=<xml_app_path>; nme=<app_name>
כאשר
ניתן בנוסף להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בתבנית הבאה:
כאשר nהוא מספר השלוחה. |
6 |
לחץ על שמור את כל השינויים. |
משתני מאקרו נתמכים בכתובות XML URL
ניתן להשתמש במשתני מאקרו בכתובות Url של XML. משתני המאקרו הבאים נתמכים:
-
מזהה משתמש-UID1, UID2 עד UIDn
-
שם תצוגה — DISPLAYNAME1, DISPLAYNAME2 עד DISPLAYNAMEn
-
מזהה אישור — AUTHID1, AUTHID2 עד AUTHIDn
-
פרוקסי — PROXY1, PROXY2 עד PROXYn
-
כתובת MAC באמצעות ספרות הקסדצימאליות קטנות — MA
-
שם מוצר - PN
-
מספר סדרת מוצרים — PSN
-
מספר סידורי-SERIAL_NUMBER
שם מאקרו | הרחבת מאקרו |
---|---|
$ | הצורה $$ מתרחבת לתו $ יחיד. |
A עד P | מוחלף על-ידי פרמטרים רב תכליתיים GPP_A עד GPP_P. |
SA עד SD | מוחלף על-ידי פרמטרי למטרות מיוותים GPP_SA עד GPP_SD. פרמטרים אלה מחזיקים במקשים או בסיסמאות המשמשים להקצאת משאבים. $SA עד $SD מזוהים כארגומנטים למזהה כתובת ה-URL האופציונלי לסנכרון מחדש--מקש. |
MA | כתובת MAC באמצעות ספרות הקסדצימאליות קטנות (000e08aabbcc). |
MAU | כתובת MAC באמצעות ספרות הקסדצימאליות רישיות (000E08AABBCC). |
MAC | כתובת MAC באמצעות ספרות הקסדצימאליות קטנות עם נקודתיים כדי להפריד בין זוגות ספרות הקסדצימאליות (00:0e:08:aa:bb:cc). |
PN | שם מוצר; לדוגמה, טלפון וידאו 8875, טלפון שולחני 9851. |
PSN | מספר סדרת מוצרים; לדוגמה, 8875, 9841, 9861 |
מספר סידורי | מחרוזת מספר סידורי; לדוגמה, 88012BA01234. |
CCERT | מצב אישור לקוח SSL, מותקן או לא מותקן. |
כתובת IP | כתובת IP של הטלפון בתוך רשת המשנה המקומית; לדוגמה, 192.168.1.100. |
EXTIP | IP חיצוני של הטלפון, כפי שנראה באינטרנט; לדוגמה, 66.43.16.52. |
SWVER |
מחרוזת גירסת תוכנה. לדוגמה, PHONEOS.3-2-1-0104-37 |
HWVER |
מחרוזת גירסת חומרה. לדוגמה, 2.0.1 |
PRVST |
מצב הקצאת משאבים (מחרוזת מספרית): -1 = בקשה מפורשת לסנכרון מחדש 0 = סנכרון מחדש בהפעלה 1 = סנכרון מחדש תקופתי 2 = סנכרון מחדש נכשל, ניסיון נוסף |
UPGST |
מצב שדרוג (מחרוזת מספרית): 1 = ניסיון השדרוג הראשון 2 = שדרוג נכשל, ניסיון חוזר |
UPGERR |
הודעת התוצאה (ERR) של ניסיון שדרוג קודם; לדוגמה http_get נכשל. |
PRVTMR |
שניות מאז ניסיון הסנכרון מחדש האחרון. |
UPGTMR |
שניות מאז ניסיון השדרוג האחרון. |
REGTMR1 |
שניות מאז קו 1 איבד רישום עם שרת SIP. |
REGTMR2 |
שניות מאז קו 2 איבד רישום עם שרת SIP. |
UPGCOND |
שם מאקרו מדור קודם. |
SCHEME |
סכימת גישה לקבצים, אחת מ-TFTP, HTTP או HTTPS, כפי שהושג לאחר ניתוח של סנכרון מחדש או שדרוג של כתובת URL. |
SERV |
בקש את שם מארח שרת היעד, כפי שהושג לאחר ניתוח של סנכרון מחדש או שדרוג של כתובת URL. |
SERVIP |
בקש את כתובת ה-IP של שרת היעד, כפי שהושג לאחר ניתוח של סנכרון מחדש או שדרוג של כתובת URL, ייתכן שלאחר חיפוש ב-DNS. |
יציאה |
בקש יציאת UDP/TCP ייעודית, כפי שהושג לאחר ניתוח סנכרון מחדש או שדרוג של כתובת URL. |
PATH |
יש לבקש נתיב קובץ יעד, כפי שהושג לאחר ניתוח סנכרון מחדש או שדרוג של כתובת URL. |
ERR |
הודעת התוצאה של סנכרון מחדש או ניסיון לשדרג. מועיל רק ליצירת הודעות syslog. הערך נשמר במשתנה UPGERR למקרה של נסיונות לשדרוג. |
UIDn |
התוכן של פרמטר תצורת מזהה משתמש קו n. |
ISCUST |
אם היחידה מותאמת אישית, ערך = 1, אחרת 0. ניתן להציג את מצב ההתאמה האישית בדף מידע בממשק המשתמש באינטרנט. |
INCOMINGNAME | שם המשויך לשיחה הראשונה המחוברת, מצלצלת או נכנסת. |
REMOTENUMBER |
מספר טלפון של השיחה הראשונה המחוברת, מצלצלת או נכנסת. אם ישנן שיחות מרובות, הנתונים המשויכים לשיחה הראשונה שאותרה מסופקים. |
DISPLAYNAMEn | התוכן של פרמטר התצורה של שם התצוגה של הקו N. |
AUTHIDn | התוכן של פרמטר התצורה של מזהה האימות של קו N. |