סקירה

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

לאחר רישום הטלפון לשירותים, המשתמשים יכולים לגשת לכל השירותים המוגדרים בטלפון על-ידי ניווט אל הגדרות > רשת ושירות > שירותי XML של Cisco. שירותי XML של Cisco הוא שם ברירת המחדל. ניתן גם לשנות את השם. כדי לספק גישה קלה למשתמשים, באפשרותך להוסיף את יישומי ה-XML למקשים מהירים או למקשי קו.

התכונות הנתמכות הן:

  • הודעות (תמונות וטקסט)
  • זימון

אובייקטי XML נתמכים

  • תפריט CiscoIPhone

  • טקסט CiscoIPhoneText

  • קלט של CiscoIP

  • ספריית CiscoIPPhoneDirectory

  • תמונה של CiscoIPhoneImage

  • קובץ תמונה של Cisco

  • תפריט CiscoIPPhoneIcon

  • תפריט CiscoIPhoneIconFileMenu

  • מצב CiscoIPhoneStatus (למעט 9841)

  • קובץ CiscoIPPhoneStatusFile (למעט 9841)

  • CiscoIPPhoneביצוע

מזהי URI נתמכים

  • מכשיר

  • חייג

  • ערוךDail

  • איתחול

  • מפתח

  • הפעל (צלצולים בלבד)

  • מקש מהיר

לפרטים נוספים על תצורת שירות XSI, ראה הערות פיתוח יישום שירותי טלפון Cisco Unified IP.

הגדרת תצורת טלפון להתחברות לשירות XML

1

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

2

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

3

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

4

(אופציונלי) כדי להוסיף אימות לגישה לשירות היישום, קבע תצורה של שדות תזה: שם משתמש XML, סיסמת XML, הפעלת CISCO XML EXE ומצב אימות 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. עבור משתני המאקרו החוקיים, ראה משתני מאקרו הנתמכים בכתובות URL של XML.

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

שם משתמש XML

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

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

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

<XML_User_Name ua="na">שם משתמש</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>

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

דוגמה fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=תפריט

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

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

כאשר n הוא מספר המקש המהיר.

5

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

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

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

לפני שתתחיל

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

1

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

2

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

3

בחר מקש קו.

4

הגדר את הפרמטר שלוחה למצב מושבת כדי להשבית את השלוחה.

אם תכונת תצורת PLK ישירה מושבתת, עליך להשבית את השלוחה כדי להוסיף פונקציה מורחבת למקש הקו. אם התכונה מופעלת, תוכל לדלג על שלב זה. לפרטים, ראה הפעלת תצורת PLK ישירה.
5

בפרמטר פונקציה מורחבת, הזן מחרוזת בתבנית הבאה:

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

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

דוגמה fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=תפריט

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

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=תפריט<configuration code></Extended_Function_n_>

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

6

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

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

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

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

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

  • מזהה אימות - AUTHID1, AUTHID2 עד AUTHIDn

  • Proxy - 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 האופציונלי לסנכרון מחדש, --key.
ג'וןכתובת MAC באמצעות ספרות הקסדצימאליות קטנות (000e08aabbcc).
MAUכתובת MAC המשתמשת בספרות הקסדצימאליות רישיות (000E08AABBCC).
מק'כתובת MAC המשתמשת בספרות הקסדצימאליות קטנות עם נקודתיים כדי להפריד בין זוגות ספרות הקסדצימאליות (00:0e:08:aa:bb:cc).
עמ' נ'שם המוצר; לדוגמה, טלפון וידאו 8875, טלפון שולחני 9851.
PSN רשמיתמספר סדרת מוצרים; לדוגמה, 8875, 9841, 9861
סנ'מחרוזת מספר סידורי; לדוגמה, 88012BA01234.
סיקרטמצב אישור לקוח SSL, מותקן או לא מותקן.
IPכתובת IP של הטלפון בתוך רשת המשנה המקומית שלו; לדוגמה, 192.168.1.100.
שלוחהIP חיצוני של הטלפון, כפי שניתן לראות באינטרנט; לדוגמה, 66.43.16.52.

swver

מחרוזת גרסת תוכנה. לדוגמה,

phoneos.3-2-1-0104-37

hwver

מחרוזת גירסת חומרה. לדוגמה, 2.0.1

פרבסט

מצב הקצאה (מחרוזת מספרית):

-1 = בקשה מפורשת לסנכרון מחדש

0 = סנכרון מחדש של הפעלה

1 = סנכרון מחדש תקופתי

2 = סנכרון מחדש נכשל, ניסיון חוזר

למעלה

מצב שדרוג (מחרוזת מספרית):

1 = ניסיון שדרוג ראשון

2 = שדרוג נכשל, ניסיון חוזר

אפגר

הודעת תוצאה (ERR) של ניסיון שדרוג קודם; לדוגמה http_get נכשל.

פרבטמר

שניות מאז ניסיון הסנכרון האחרון.

מנהל התעודות

שניות מאז ניסיון השדרוג האחרון.

רג'טמר1

שניות מאז קו 1 איבד רישום עם שרת SIP.

רטרוmr2

שניות מאז קו 2 איבד רישום עם שרת SIP.

אפגcond

שם מאקרו מדור קודם.

סכימה

סכימת גישה לקובץ, אחת מ-TFTP, HTTP או HTTPS, כפי שהושג לאחר ניתוח של סנכרון מחדש או שדרוג של כתובת URL.

סרב

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

שירות

בקש כתובת IP של שרת היעד, כפי שהושג לאחר ניתוח סנכרון מחדש או שדרוג של כתובת URL, ייתכן שלאחר בדיקת מידע של DNS.

יציאה

בקש יציאת UDP/TCP המהווה יעד, כפי שהושג לאחר ניתוח סנכרון מחדש או שדרוג של כתובת URL.

נתיב

בקש נתיב קובץ יעד, כפי שהושג לאחר ניתוח סנכרון מחדש או שדרוג של כתובת URL.

שגיאה

תוצג הודעה של ניסיון סנכרון מחדש או שדרוג. שימושי רק ביצירת הודעות syslog של תוצאה. הערך נשמר במשתנה UPGERR במקרה של ניסיונות שדרוג.

זיהוי משתמש

התוכן של פרמטר התצורה של מזהה משתמש קו n.

איסקוסט

אם היחידה מותאמת אישית, ערך = 1, אחרת 0.

מצב ההתאמה האישית ניתן להציג בדף פרטי ממשק המשתמש של האינטרנט.

כניסהnameשם המשויך לשיחה הראשונה שחוברה, מצלצלת או נכנסת.
מספר מרוחק

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

שם תצוגההתוכן של פרמטר התצורה של שם התצוגה של קו N.
זהותהתוכן של פרמטר תצורת מזהה האימות של קו N.