- Etusivu
- /
- Artikkeli
XML -sovellusten määritykset 9800- ja 8875-puhelimille (BroadWorks)
Tämä ohjeartikkeli koskee Cisco Desk Phone 9800 -sarjoja ja Cisco Videopuhelin 8875 -puhelimia, jotka on rekisteröity Cisco BroadWorksiin. 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 käyttämällä tuettuja XML-objekteja ja URI-kohteita.
Kun puhelin on tilattu palveluihin, käyttäjät voivat käyttää kaikkia puhelimen määritettyjä palveluita siirtymällä Asetuksiin Cisco XML-palvelut on 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)
- Henkilöhaku
Tuetut XML-objektit
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (paitsi 9811 ja 9841)
-
CiscoIPPhoneStatusFile (paitsi 9811 ja 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 Services Application Development Notes.
Määritä puhelin muodostamaan yhteys XML-palveluun
| 1 |
Siirry puhelimen hallintaverkkosivulle. |
| 2 |
Valitse . |
| 3 |
Määritä XML-palvelu -osassa XML-sovelluspalvelun nimi ja XML Sovelluspalvelun URL-parametrit sellaisiksi, jotka on määritetty XML-palvelujen parametreissa. |
| 4 |
(Valinnainen) Voit lisätä sovelluspalvelun todennuksen määrittämällä kentät: XML Käyttäjänimi, XML salasana, Cisco XML EXE Enable ja Cisco XML EXE -todennustila. |
| 5 |
Valitse Tallenna kaikki muutokset. |
XML-palvelujen parametrit
Seuraavassa taulukossa on määritetty puhelimen WEB-käyttöliittymän XML-sovellusparametrien toiminta ja käyttö XML-palvelu -osassa Tab -kohdassa. 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 puhelinmäärityksissä 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 puhelinmäärityksissä 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 puhelinmäärityksissä XML tiedostossa (cfg.XML) kirjoittamalla merkkijonon tässä muodossa:
|
|
XML-salasana |
Oletus: tyhjä |
XML määritetyn XML-käyttäjänimen 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 puhelinmäärityksissä XML tiedostossa (cfg.XML) kirjoittamalla merkkijonon tässä muodossa:
|
|
Cisco XML EXE -todennustila |
Oletus: Paikallinen tunnistetieto Asetukset: Luotettu, Paikallinen tunnistetieto, Etätunnistetieto |
Määrittää EXE-ohjelman Cisco XML todennustilan.
Voit määrittää tämän parametrin myös puhelinmäärityksissä 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. |
| Väli-P | Korvattu yleisluont. parametreilla, jotka GPP_A GPP_P. |
| SA SD:n kautta | Korvattu erikoisparametrilla GPP_SA GPP_SD. Näissä parametreissa on näppäimiä tai salasanoja, joita käytetään valmistelussa. $SA-$SD tunnistetaan valinnaisen uudelleensynkronointi-URL-syyn argumentteina. |
| ÄITI | 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 ei asennettu. |
| 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. |
|
KYTKIN |
Ohjelmistoversiomerkkijono. Esimerkki: PHONEOS.3-2-1-0104-37 |
|
HWVER |
Laitteistoversiomerkkijono. Esimerkiksi 2.0.1 |
|
PRVST |
Valmistelutila (numeromerkkijono): -1 = uudelleensynkronointipyyntö, joka on esitetty uudelleensynkronointipyynnössä 0 = virran kytkennän uudelleensynkronointi 1 = määräaikainen uudelleensynkronointi 2 = uudelleensynkronointi epäonnistui, yritys uudelleen |
|
UPGST |
Päivityksen tila (numeromerkkijono): 1 = ensimmäinen päivitysyritys 2 = päivitys epäonnistui, yritys uudelleen |
|
UPGERR |
Edellisen päivitysyrityksen tulossanoma (ERR). Esimerkiksi http_get epäonnistui. |
|
PRVTMR |
Sekunteja edellisen uudelleensynkronointiyrityksen jälkeen. |
|
UPGTMR |
Sekunteja edellisen päivitysyrityksen jälkeen. |
|
REGTMR1 |
Sekuntia sen jälkeen, kun linja 1 menetti rekisteröinnin SIP-palvelimella. |
|
REGTMR2 |
Sekuntia sen jälkeen, kun linja 2 menetti rekisteröinnin SIP-palvelimella. |
|
UPGCOND |
Vanha makron nimi. |
|
JÄRJESTELMÄ |
Tiedoston käyttömalli, joka on osa TFTP-, HTTP- tai HTTPS-mallia, sellaisena kuin se on saatu uudelleensynkronoimisen tai URL-päivityksen jälkeen. |
|
PAL |
Pyydä kohdepalvelimen isäntänimeä sillä tavalla, joka haetaan uudelleensynkronoimisen tai url-päivityksen jälkeen. |
|
SERVIP |
Pyydä kohdepalvelinta IP osoite, joka on saatu uudelleensynkronointia tai päivitys-URL-osoitetta jäsennettyä, mahdollisesti DNS-haun jälkeen. |
|
SATAMA |
Pyydä kohdetta UDP/TCP portista sillä tavalla, joka haetaan uudelleensynkronoimisen tai päivityksen URL-osoitteen jäsentämisen jälkeen. |
|
POLKU |
Pyydä kohdetiedoston polkua sillä tavalla, joka haetaan uudelleensynkronoimisen tai päivityksen URL-osoitteen jäsennön jälkeen. |
|
EREHTYÄ |
Uudelleensynkronointi- tai päivitysyrityksen tulossanoma. Hyödyllinen vain tulos syslog-viestien luomisen kannalta. Arvo säilyy UPGERR-muuttujassa päivitysyritysten tapauksessa. |
|
UIDN |
Linjan n Käyttäjätunnus-määritysparametrin 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ö. |