- Etusivu
- /
- Artikkeli
XML -sovellusten määritykset BroadWorks-puhelimille
Tämä ohjeartikkeli koskee Cisco BroadWorksiin rekisteröityjä Cisco Desk Phone 9800 -sarjoja ja Cisco Video Phone 8875 -puhelimia. Lue tämä artikkeli tuetuista XML-objekteista, URI:ista ja XSI-palvelujen määrittämisestä puhelimen Web-sivulla.
Yleiskatsaus
XML Services Interface (XSI) on protokolla, joka mahdollistaa sovellusten ja puhelinjärjestelmän välisen viestinnän. Voit lisätä puhelimeesi omia XSI-palveluita tuettujen XML objektien ja URI:en avulla.
Kun puhelin on tilattu palveluihin, käyttäjät voivat käyttää kaikkia puhelimen määritettyjä palveluita siirtymällä Asetuksiin
Cisco XML -palvelut ovat oletusnimi. Voit myös muuttaa nimeä. Voit helpottaa käyttäjien käyttöä lisäämällä XML sovellukset toimintonäppäimiin tai linja-avaimiin.Tuetut ominaisuudet ovat:
- Viestit (kuvat ja teksti)
- Sivutus
Tuetut XML objektit
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (paitsi 9841)
-
CiscoIPPhoneStatusFile (paitsi 9841)
-
CiscoIPPhoneExvaloute
Tuetut URI:t
-
Laite
-
Kellotaulu
-
Muokkaa -aihi
-
Init
-
Avain
-
Toista (vain soittoäänet)
-
Toimintonäppäin
Lisätietoja XSI-palvelun määrityksistä on kohdassa Cisco Unified IP Phone Palvelut-sovelluksen kehittämistä koskevat huomautukset.
Puhelimen määrittäminen muodostamaan yhteys XML-palveluun
XML-palvelujen parametrit
Seuraavassa taulukossa määritetään puhelimen Web-käyttöliittymän Voice>Phone -välilehden XML-palvelun XML sovellusparametrien
Se määrittää myös puhelimen määritystiedostoon (cfg.xml) lisätyn merkkijonon syntaksin, jossa on XML koodi parametrin määrittämiseksi.
Parametri |
Oletus ja asetukset |
Kuvaus |
---|---|---|
XML sovelluspalvelun nimi |
Oletus: tyhjä |
XML-sovelluksen nimi. Nimi näkyy puhelimessa Web-sovelluksen valintana. Voit määrittää tämän parametrin myös puhelimen XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
|
XML Sovelluspalvelun URL |
Oletus: tyhjä |
URL, jossa XML-sovellus sijaitsee. Voit määrittää tämän parametrin myös puhelimen XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
Makromuuttujat ovat tuettuja XML URL-osoitteissa. Kelvollisia makromuuttujia on kohdassa Makromuuttujat, joita tuetaan XML URL-osoitteissa. URL-osoite tukee vain HTTP- tai HTTP-protokollia. |
XML-käyttäjänimi |
Oletus: tyhjä |
XML palvelun käyttäjänimeä todennustarkoituksia varten. Voit määrittää tämän parametrin myös puhelimen XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
|
XML-salasana |
Oletus: tyhjä |
XML määritetylle XML käyttäjänimelle palvelun salasana. Tähän kenttään annettu salasana näkyy määritystiedostossa (cfg.xml) seuraavasti:
|
CISCO XML EXE käytössä |
Oletus: Ei Asetukset: Kyllä, Ei |
Määrittää, tarvitaanko XML-sovelluspalvelimen käyttäminen todennusta. Voit määrittää tämän parametrin myös puhelimen XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
|
CISCO XML EXE -todennustila |
Oletus: Paikallinen tunnistetieto Asetukset: Luotettu, Paikallinen tunnistetieto, Etätunnistetieto |
Määrittää Cisco XML EXE -ohjelman todennustilan.
Voit määrittää tämän parametrin myös puhelimen XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
|
XML-sovelluksen lisääminen toimintonäppäimeen
Lisää usein käytetyt sovellukset toimintonäppäimiin, jotta käyttäjät voivat käyttää palvelua helposti.
Ennen aloittamista
XML-sovelluspalvelu on määritetty oikein.
1 |
Siirry puhelimen hallintaverkkosivulle. |
2 |
Valitse . |
3 |
Määritä Ohjelmoitavat toimintonäppäimet -osassa Ohjelmoitava toimintonäppäin käyttöön - kyllä. Voit määrittää tämän parametrin myös määritystiedostossa (cfg.xml). Anna merkkijono tässä muodossa:
|
4 |
Muokkaa PSK1-PSK1-PSK16-kenttien ohjelmoitavissa olevia toimintonäppäimiä tässä muodossa: fnc=xml;url=<xml_app_path>; nme=<app_name>
missä
Esimerkki Voit määrittää tämän parametrin myös määritystiedostossa (cfg.xml). Anna merkkijono tässä muodossa:
jossa n on toimintonäppäinnumero. |
5 |
Valitse Tallenna kaikki muutokset. |
XML-sovelluksen lisääminen linjanäppäintä varten
Lisää usein käytetyt sovellukset linja-avaimiin, jotta käyttäjät voivat käyttää palveluita helposti.
Ennen aloittamista
XML-sovelluspalvelu on määritetty oikein.
1 |
Siirry puhelimen hallintaverkkosivulle. |
2 |
Valitse . |
3 |
Valitse linjanäppäin. |
4 |
Poista alanumero käytöstä määrittämällä alanumeron parametriksi Ei käytössä . Jos Direct PLK Configuration -toiminto on poistettu käytöstä, alanumero on poistettava käytöstä, jotta voit lisätä linjanäppäimeen laajennetun toiminnon. Jos ominaisuus on käytössä, voit ohittaa tämän vaiheen. Lisätietoja on kohdassa Direct PLK -määritysten käyttöönotto. |
5 |
Anna merkkijono laajennetun toiminnon parametrissa seuraavassa muodossa: fnc=xml;url=<xml_app_path>; nme=<app_name>
missä
Esimerkki Voit määrittää tämän parametrin myös määritystiedostossa (cfg.xml). Anna merkkijono tässä muodossa:
jossa n on alanumero. |
6 |
Valitse Tallenna kaikki muutokset. |
XML URL-osoitteissa tuetut makromuuttujat
Voit käyttää makromuuttujia XML URL-osoitteissa. Seuraavia makromuuttujia tuetaan:
-
Käyttäjätunnus – UID1, UID2 – UIDn
-
Näyttönimi – DISPLAYNAME1, DISPLAYNAME2 kohteeseen DISPLAYNAMEn
-
Tod.tunnus – AUTHID1, AUTHID2 kohteeseen AUTHIDn
-
Välityspalvelin – PROXY1, PROXY2 to PROXYn
-
MAC osoite käyttäen pieniä heksanumeroita – MA
-
Tuotteen nimi – luettelonumero
-
Tuotesarjan numero – PSN
-
Sarjanumero – SERIAL_NUMBER
Makron nimi | Makrolaajennus |
---|---|
$ | Lomake $$ kasvaa yhteen $ merkkiin. |
A–P | Korvattu yleisluont. parametreilla, jotka GPP_A GPP_P. |
SA–SD | Korvautuvat erikoisparametrien GPP_SA–GPP_SD sisällöillä. Nämä parametrit sisältävät valmistelussa käytetyt avaimet tai salasanat. $SA–$SD tunnistetaan valinnaisen uudelleensynkronoinnin URL-tarkenteen --key argumenteiksi. |
MA | MAC osoite käyttäen pieniä heksanumeroita (000e08aabbcc). |
MAU | MAC osoite käyttäen isoja heksanumeroita (000E08AABBCC). |
MAC | MAC osoite käyttäen pieniä heksanumeroita, joiden kaksoispiste erottaa heksanumeroparit (00:0e:08:aa:bb:cc). |
PN | Tuotteen nimi; Esimerkiksi videopuhelin 8875, pöytäpuhelin 9851. |
PSN | Tuotesarjan numero; Esimerkiksi 8875, 9841, 9861 |
SN | Sarjanumeromerkkijono; esimerkiksi 88012BA01234. |
CCERT | SSL asiakasvarmenteen tila, asennettu tai asentamatta. |
IP | Puhelimen IP osoite sen paikallisessa aliverkossa. Esimerkiksi 192.168.1.100. |
EXTIP | Puhelimen ulkoiset IP, kuten Internetissä näkyy; esimerkiksi 66.43.16.52. |
SWVER |
Ohjelmistoversio. Esimerkki: PHONEOS.3-2-1-0104-37 |
HWVER |
Laiteversio. Esimerkiksi 2.0.1 |
PRVST |
Valmistelutila (numero merkkijonona): -1 = erillinen uudelleensynkronointipyyntö 0 = uudelleensynkronointi päälle kytkettäessä 1 = säännöllinen uudelleensynkronointi 2 = uudelleensynkronointi epäonnistunut, uudelleenyritetään |
UPGST |
Päivitystila (numero merkkijonona): 1 = ensimmäinen päivitysyritys 2 = päivitys epäonnistui, uusi yritys |
UPGERR |
Edellisen päivitysyrityksen tulosviesti (ERR), esimerkiksi "http_get failed". |
PRVTMR |
Edellisestä uudelleensynkronointiyrityksestä kulunut aika sekunteina. |
UPGTMR |
Edellisestä päivitysyrityksestä kulunut aika sekunteina. |
REGTMR1 |
Linjan 1 SIP-palvelinrekisteröinnin menettämisestä kulunut aika sekunteina. |
REGTMR2 |
Linjan 2 SIP-palvelinrekisteröinnin menettämisestä kulunut aika sekunteina. |
UPGCOND |
Vanhan version mukainen makronimi. |
SCHEME |
Tiedostonsiirtoprotokolla. TFTP, HTTP tai HTTPS uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen mukaisesti. |
SERV |
Pyynnön kohdepalvelimen isäntänimi uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen mukaisesti. |
SERVIP |
Pyynnön kohdepalvelimen IP-osoite uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen tai mahdollisesti DNS-haun mukaisesti. |
PORT |
Pyynnön UDP-/TCP-kohdeportti uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen mukaisesti. |
PATH |
Pyynnön kohdetiedostopolku uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen mukaisesti. |
ERR |
Uudelleensynkronointi- tai päivitysyrityksen tulosviesti. Hyödyllinen vain syslog-tulosviestien muodostamisessa. Arvo säilytetään UPGERR-muuttujassa päivitysyrityksissä. |
UIDn |
Linjan n UserID-määrittelyparametrin sisältö. |
ISCUST |
Jos yksikkö on mukautettu, arvo=1, muussa tapauksessa 0. Mukautustila on katsottavissa Web-käyttöliittymän tiedot -sivulla. |
SAAPUVA NIMI | Nimi, joka liittyy ensimmäiseen yhdistettyyn, soivaan tai saapuvaan puheluun. |
REMOTENUMBER |
Ensimmäisen yhdistetyn, soivan tai saapuvan puhelun puhelinnumero. Jos puheluja on useita, ensimmäiseen löydettyyn puheluun liittyvät tiedot ilmoitetaan. |
DISPLAYNAMEn | Linjan N näyttönimen määritysparametrin sisältö. |
AUTHIDn | Linjan N todennustunnuksen määritysparametrin sisältö. |