- בית
- /
- מאמר
תודה על המשוב.
תצורת יישומי XML לטלפונים 9800 ו- 8875 (ברודוורקס)
במאמר זה
משוב?מאמר עזרה זה חל על טלפון שולחן עבודה של סיסקו סדרת 9800 וטלפון וידאו 8875 של סיסקו הרשומים בסיסקו ברודוורקס. קרא מאמר זה לקבלת אובייקטים XML נתמכים, URIs והשלבים להגדרת התצורה של שירותי XSI בדף האינטרנט של הטלפון.
סקירה כללית
ממשק שירותי XML (XSI) הוא פרוטוקול המאפשר תקשורת בין יישומים למערכת הטלפון. באפשרותך להוסיף שירותי XSI משלך לטלפון שלך באמצעות אובייקטים XML נתמכים ו- URI.
לאחר הרשמה לטלפון לשירותים, משתמשים יכולים לגשת לכל השירותים המוגדרים בטלפון על ידי ניווט אל הגדרות . שירותי XML של סיסקו הם שם ברירת המחדל. אתה יכול גם לשנות את השם. כדי לספק גישה נוחה למשתמשים, באפשרותך להוסיף את יישומי XML למקשים רכים או למקשי קו.
התכונות הנתמכות הן:
- הודעות (תמונות וטקסט)
- עדכון
אובייקטים XML נתמכים
-
סיסקואיפפונמנו
-
סיסקואיפונטקסט
-
קלט ציסקואיפפון
-
ספריית הטלפון של CiscoIp
-
תמונה של סיסקואיפפון
-
קיסקואיפפוןקובץ תמונה
-
תפריט אייקון ציסקואיפונייםתפריט
-
סיסקואיפפונאיםתפריט קובץ
-
סיסקואיפונסטטוס (למעט 9811 ו- 9841)
-
קובץ סטטוס של ציסקואיפפון (למעט 9811 ו- 9841)
-
CiscoiPphoneExecute
URIs נתמכים
-
מכשיר
-
חייג
-
עריכת דייל
-
איניט
-
מפתח
-
השמעה (רינגטונים בלבד)
-
מקש רך
לקבלת פרטים נוספים אודות תצורת שירות XSI, ראה הערות לפיתוח יישומים של שירותי טלפון IP מאוחדים של Cisco.
קביעת תצורה של טלפון כדי להתחבר לשירות XML
| 1 |
גש לדף האינטרנט של ניהול הטלפון. |
| 2 |
בחר . |
| 3 |
במקטע שירות XML, קבע את התצורה של פר מטרי שם שירות יישומ י XML ו- URL של שירות יי שומי XML כהגדר תם בפרמטרים עבור שירותי XML. |
| 4 |
(אופציונלי) כדי להוסיף אימות לגישה לשירות היישומים, הגדר את התצורה של שדות אלה: שם משתמש XML, סיסמת XML, הפעלת C ISCO XML EXE ומצב אימות CISCO XML EXE. |
| 5 |
לחץ על שמור את כל השינויים. |
פרמטרים עבור שירותי XML
הטבלה הבאה מגדירה את הפונקציה והשימוש בפרמטרים של יישום XML במקטע שירות XML תחת הכרטיסייה בממשק האינטרנט של הטלפון. זה גם מגדיר את התחביר של המחרוזת שנוספה בקובץ תצורת הטלפון (cfg.xml) עם קוד XML כדי להגדיר פרמטר.
|
פרמטר |
ברירת מחדל ואפשרויות |
תיאור |
|---|---|---|
|
שם שירות יישום XML |
ברירת מחדל: ריק |
שם יישום ה- XML. השם מוצג בטלפון כבחירת יישום אינטרנט. ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על ידי הזנת מחרוזת בפורמט זה: |
|
כתובת אתר של שירות יישומי XML |
ברירת מחדל: ריק |
כתובת האתר שבה נמצא יישום ה- XML. ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על ידי הזנת מחרוזת בפורמט זה: משתני מאקרו נתמכים בכתובות URL של XML. למשתני המאקרו החוקיים, ראה משתני מאקרו הנתמכים בכתובות URL של XML. רק פרוטוקולי HTTP או HTTPS נתמכים בכתובת האתר. |
|
שם משתמש XML |
ברירת מחדל: ריק |
שם משתמש של שירות XML למטרות אימות. ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על ידי הזנת מחרוזת בפורמט זה: |
|
סיסמא XML |
ברירת מחדל: ריק |
סיסמת שירות XML עבור שם המשתמש XML שצוין. הסיסמה שהזנת בשדה זה מוצגת בקובץ התצורה (cfg.xml) כדלקמן: |
|
הפעלת סיסקו XML EXE |
ברירת מחדל: לא אפשרויות: כן, לא |
מציין אם נדרש אימות כדי לגשת לשרת היישומים של XML. ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על ידי הזנת מחרוזת בפורמט זה: |
|
מצב אימות XML EXE של סיסקו |
ברירת מחדל: אישורים מקומיים אפשרויות: מהימן, אישורים מקומיים, אישורים מרחוק |
מציין את מצב האימות עבור XML EXE של סיסקו.
ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על ידי הזנת מחרוזת בפורמט זה: |
הוספת יישום XML למקש רך
הוסף את היישומים המשמשים לעתים קרובות למפתחות הרכים כדי שמשתמשים יוכלו לגשת לשירות בקלות.
לפני שתתחיל
שירות יישומי XML הוגדר כהלכה.
| 1 |
גש לדף האינטרנט של ניהול הטלפון. |
| 2 |
בחר . |
| 3 |
במקטע מקשי ה רכה הניתנים לתכנות, הגדר את הפעלת מקש ה רכה הניתנים לתכנות כ- Y es. ניתן גם להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בפורמט זה: |
| 4 |
בקטע מקשי תוכנה הני תנים לתכנות, ערוך את השדות הזמינים של PSK1 ל- PSK 16 בפור מט זה: fnc=xml;url=<xml_app_path>;nme=<app_name>
כאשר
דוגמה
ניתן גם להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בפורמט זה:
כאשר n הוא מספר המקשים הרכים. |
| 5 |
לחץ על שמור את כל השינויים. |
הוספת יישום XML למפתח שורה
הוסף את היישומים המשמשים לעתים קרובות למפתחות קו כדי שמשתמשים יוכלו לגשת לשירותים בקלות.
לפני שתתחיל
שירות יישומי XML הוגדר כהלכה.
| 1 |
גש לדף האינטרנט של ניהול הטלפון. |
| 2 |
בחר . |
| 3 |
בחר מקש שורה. |
| 4 |
הגדר את הפרמטר הרח בה כ מושבת כדי להשבית את התוסף. אם התכונה Direct PLK Configuration מושבתת, עליך להשבית את התוסף כדי להוסיף פונקציה מורחבת למפתח השורה. אם התכונה מופעלת, תוכל לדלג על שלב זה. לקבלת פרטים, ראה הפעלת תצורת PLK ישירה. |
| 5 |
בפרמטר פונקציה מורח בת, הזן מחרוזת בתבנית זו: fnc=xml;url=<xml_app_path>;nme=<app_name>
כאשר
דוגמה
ניתן גם להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בפורמט זה:
כאשר n הוא מספר ההרחבה. |
| 6 |
לחץ על שמור את כל השינויים. |
משתני מאקרו נתמכים בכתובות URL של XML
ניתן להשתמש במשתני מאקרו בכתובות URL של XML. משתני המאקרו הבאים נתמכים:
-
מזהה משתמש—UID1, UID2 ל- UIDn
-
שם תצוגה—שם תצוגה1, שם תצוגה2 ל- שם תצוגן
-
מזהה אישור—AUTHID1, AUTHID2 ל-AuthIDN
-
פרוקסי—פרוקסי1, פרוקסי2 ל- ProxyN
-
כתובת MAC באמצעות ספרות hex באותיות קטנות — MA
-
שם המוצר — PN
-
מספר סדרת מוצרים — PSN
-
מספר סידורי - מספר סידורי
| שם מאקרו | הרחבת מאקרו |
|---|---|
| $ | הטופס $$ מתרחב לתו $ יחיד. |
| A עד P | הוחלף על ידי פרמטרים למטרות כלליות GPP_A דרך GPP_P. |
| SA דרך SD | הוחלף על ידי פרמטרים ייעודיים GPP_SA דרך GPP_SD. פרמטרים אלה מכילים
מפתחות או סיסמאות המשמשות להקצאה. $SA עד $SD מזוהים כארגומנטים למימוש כתובת האתר האופציונלי לסנכרון מחדש, --key. |
| MA | כתובת MAC באמצעות ספרות משושה באותיות קטנות (000e08aabbcc). |
| MAU | כתובת MAC באמצעות ספרות משושה באותיות גדולות (000E08AABBCC). |
| MAC | כתובת MAC המשתמשת בספרות משושה באותיות קטנות עם מעי גס להפרדת זוגות ספרות משושה (00:0 e:08:aa:bb: cc). |
| PN | שם המוצר; לדוגמה, טלפון וידאו 8875, טלפון שולחן 9851. |
| PSN | מספר סדרת מוצר; לדוגמה, 8875, 9841, 9861 |
| SN | מחרוזת מספר סידורי; לדוגמה, 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, כפי שהתקבלה לאחר ניתוח סינכרון מחדש או שדרוג כתובת אתר. |
|
SERV |
בקש שם מארח שרת יעד, כפי שהושג לאחר ניתוח סינכרון מחדש או שדרוג כתובת אתר. |
|
SERVIP |
בקש כתובת IP של שרת היעד, כפי שהתקבלה לאחר ניתוח סנכרון מחדש או שדרוג כתובת URL, אולי לאחר בדיקת DNS. |
|
PORT |
בקש יציאת UDP/TCP יעד, כפי שהושג לאחר ניתוח סינכרון מחדש או שדרוג כתובת אתר. |
|
PATH |
בקש נתיב קובץ יעד, כפי שהושג לאחר ניתוח סינכרון מחדש או שדרוג כתובת אתר. |
|
ERR |
הודעת תוצאה של סנכרון מחדש או ניסיון שדרוג. שימושי רק בהפקת הודעות syslog לתוצאות. הערך נשמר במשתנה UPGERR במקרה של ניסיונות שדרוג. |
|
UIDn |
התוכן של פרמטר התצורה של Line n UserId. |
| ISCUST |
אם היחידה מותאמת אישית, ערך = 1, אחרת 0. ניתן לראות את מצב ההתאמה האישית בדף פרטי ממשק המשתמש של האינטרנט. |
| INCOMINGNAME | שם המשויך לשיחה מחוברת ראשונה, לצלצל או לשיחה נכנסת. |
| REMOTENUMBER |
מספר הטלפון של שיחה מחוברת ראשונה, מצלצלת או נכנסת. אם יש שיחות מרובות, הנתונים המשויכים לשיחה הראשונה שנמצאה מסופקים. |
| שמות תצוגם | התוכן של פרמטר תצורת שם התצוגה של קו N. |
| אישורIDN | התוכן של פרמטר תצורת מזהה אישור קו N. |
