סקירה כללית

ממשק שירותי XML (XSI) הוא פרוטוקול המאפשר תקשורת בין יישומים למערכת הטלפונים. באפשרותך להוסיף שירותי XSI משלך לטלפון באמצעות אובייקטי XML ומזהי URI נתמכים.

לאחר רישום הטלפון לשירותים, משתמשים יכולים לגשת לכל השירותים שתצורתם נקבעה בטלפון על-ידי ניווט אל הגדרות>רשת ושירות > Cisco XML שירותים . 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 כדי להגדיר תצורת פרמטר.

טבלה 1. פרמטרים עבור שירותי XML

פרמטר

ברירת מחדל ואפשרויות

תיאור

שם שירות יישום XML

ברירת מחדל: ריק

שם יישום XML. השם מוצג בטלפון כבחירת יישום אינטרנט.

ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:

<XML_Application_Service_Name ua="na">XML שם אפליקציה</XML_Application_Service_Name>

כתובת URL של השירות יישום XML

ברירת מחדל: ריק

כתובת ה-URL בה ממוקם יישום ה-XML.

ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:

<XML_Application_Service_URL ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

משתני מאקרו נתמכים בכתובות ה-URL של XML. לקבלת משתני המאקרו החוקיים, ראה משתני מאקרו הנתמכים בכתובות XML URL.

רק פרוטוקולי HTTP או HTTP נתמכים בכתובת ה-URL.

שם משתמש XML

ברירת מחדל: ריק

שם משתמש של שירות XML למטרות אימות.

ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:

<XML_User_Name ua="na">username</XML_User_Name>

סיסמת XML

ברירת מחדל: ריק

סיסמת שירות XML עבור שם משתמש XML שצוין.

הסיסמה שהזנת בשדה זה מוצגת בקובץ התצורה (cfg.xml) כסיסמה הבאה:

<!-- <XML_Password ua="na">*************</XML_Password> -->

הפעלת CISCO XML EXE

ברירת מחדל: לא

אפשרויות: 'כן', 'לא'

מציין באם נדרש אימות כדי לגשת לשרת יישומי XML.

ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:

<CISCO_XML_EXE_Enable ua="na">כן</CISCO_XML_EXE_Enable>

מצב אימות CISCO XML EXE

ברירת מחדל: אישור מקומי

אפשרויות: מהימן, אישור מקומי, אישור מרחוק

ציון מצב האימות עבור Cisco XML EXE.

  • מהימן - לא מתבצע אימות ללא קשר לאישור המקומי.

  • אישור מקומי – האימות מבוסס על אימות תקציר באמצעות שימוש באישור המקומי, אם הוגדר. אם האישור המקומי אינו מוגדר, לא מתבצע אימות.

  • אישור מרוחק – האימות מבוסס על אימות תקציר באמצעות שימוש באישור המרוחק כפי שהוגדר ביישום XML בדף האינטרנט (כדי לגשת לשרת יישומי XML).

ניתן גם להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על-ידי הזנת מחרוזת בתבנית זו:

<CISCO_XML_EXE_Auth_Mode ua="na">אישור מקומי</CISCO_XML_EXE_Auth_Mode>

הוספת יישום XML למקש מהיר

הוסף את היישומים הנמצאים בשימוש תכוף למקשים מהירים כדי שמשתמשים יוכלו לגשת לשירות בקלות.

לפני שאתה מתחיל

שירות היישומים XML הוגדר כראוי.

1

גישה אל דף האינטרנט של ניהול הטלפון.

2

בחר קול > טלפון.

3

בקטע מקשים מהירים ניתנים לתכנות , הגדר את הפעל מקש מהיר ניתן לתכנותלמצב כן.

ניתן בנוסף להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בתבנית הבאה:

<Programmable_Softkey_Enable ua="na">כן</Programmable_Softkey_Enable>
4

במקטע מקשים מהירים הניתנים לתכנות, ערוך את השדות הזמינים של PSK1 עד PSK16 בתבנית זו:

fnc=xml;url=<xml_app_path>; nme=<app_name>

כאשר כתובת האתר היא הקישור שבו מאוחסן יישום XML; NME הוא שם התצוגה של היישום במסך הטלפון.

דוגמה fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

ניתן בנוסף להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בתבנית הבאה:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<קוד תצורה></PSK_n>

כאשר 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>

כאשר כתובת האתר היא הקישור שבו מאוחסן יישום XML; NME הוא שם התצוגה של היישום במסך הטלפון.

דוגמה fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

ניתן בנוסף להגדיר פרמטר זה בקובץ התצורה (cfg.xml). הזן מחרוזת בתבנית הבאה:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<קוד תצורה></Extended_Function_n_>

כאשר nהוא מספר השלוחה.

6

לחץ על שמור את כל השינויים.

משתני מאקרו נתמכים בכתובות XML URL

ניתן להשתמש במשתני מאקרו בכתובות Url של XML. משתני המאקרו הבאים נתמכים:

  • מזהה משתמש-UID1, UID2 עד UIDn

  • שם תצוגה — DISPLAYNAME1, DISPLAYNAME2 עד DISPLAYNAMEn

  • מזהה אישור — AUTHID1, AUTHID2 עד AUTHIDn

  • פרוקסי — PROXY1, PROXY2 עד PROXYn

  • כתובת MAC באמצעות ספרות הקסדצימאליות קטנות — MA

  • שם מוצר - PN

  • מספר סדרת מוצרים — PSN

  • מספר סידורי-SERIAL_NUMBER

טבלה 2. פקודות מאקרו נתמכות
שם מאקרוהרחבת מאקרו
$הצורה $$ מתרחבת לתו $ יחיד.
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.
EXTIPIP חיצוני של הטלפון, כפי שנראה באינטרנט; לדוגמה, 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.