- Home
- /
- Articolo
XML per telefoni su BroadWorks
Questo articolo della Guida si applica a Cisco Desk Phone serie 9800 e Cisco Video Phone 8875 registrati in Cisco BroadWorks. Leggere questo articolo per gli oggetti XML supportati, gli URI e la procedura per la configurazione dei servizi XSI nella pagina Web del telefono.
Panoramica
XML Services Interface (XSI) è un protocollo che consente la comunicazione tra le applicazioni e il sistema telefonico. È possibile aggiungere i propri servizi XSI al telefono utilizzando gli oggetti XML e gli URI supportati.
Dopo aver sottoscritto il telefono ai servizi, gli utenti possono accedere a tutti i servizi configurati sul telefono accedendo a
. Cisco XML services è il nome predefinito. È anche possibile modificare il nome. Per fornire un facile accesso agli utenti, è possibile aggiungere le XML applicazioni ai softkey o ai tasti linea.Le funzionalità supportate sono:
- Messaggi (immagini e testo)
- Cercapersone
Oggetti XML supportati
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (eccetto 9841)
-
CiscoIPPhoneStatusFile (eccetto 9841)
-
CiscoIPPhoneExecute
URI supportati
-
Dispositivo
-
Digitare
-
EditDail
-
Iniz
-
Chiave
-
Riproduci (solo suonerie)
-
Softkey
Per ulteriori informazioni sulla configurazione del servizio XSI, vedere Cisco Unified IP Phone Note sullo sviluppo di applicazioni di servizi.
Configurare un telefono per la connessione a un servizio XML
1 |
Accedere alla pagina Web di amministrazione del telefono. |
2 |
Selezionare . |
3 |
Nella sezione Servizio XML configurare i parametri XML Nome servizio applicazione e XML URL servizio applicazione come definito in Parametri per XML servizi. |
4 |
(Opzionale) Per aggiungere l'autenticazione per l'accesso al servizio dell'applicazione, configurare questi campi: XML Nome utente,XML Password,Abilitazione EXE CISCO XML e Modalità autenticazione EXE XML CISCO. |
5 |
Fai clic su Salva tutte le modifiche. |
Parametri per XML servizi
La tabella seguente definisce la funzione e l'utilizzo dei parametri dell'applicazione XML nella sezione Servizio XML nella nell'interfaccia Web del telefono. Definisce inoltre la sintassi della stringa aggiunta nel file di configurazione del telefono con codice XML (cfg.xml) per la configurazione di un parametro.
Parametro |
Predefinito e opzioni |
Descrizione |
---|---|---|
XML Application Service Name |
Impostazione predefinita: vuoto |
Il nome dell'applicazione XML. Il nome viene visualizzato sul telefono dell'utente come opzione di applicazione Web. È inoltre possibile configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) immettendo una stringa in questo formato:
|
XML Application Service URL |
Impostazione predefinita: vuoto |
URL in cui si trova l'applicazione XML. È inoltre possibile configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) immettendo una stringa in questo formato:
Le variabili macro sono supportate negli URL XML. Per le variabili macro valide, vedere Variabili macro supportate negli URL XML. Solo i protocolli HTTP o HTTP sono supportati nell'URL. |
XML User Name |
Impostazione predefinita: vuoto |
Nome utente del servizio XML per scopi di autenticazione. È inoltre possibile configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) immettendo una stringa in questo formato:
|
XML Password |
Impostazione predefinita: vuoto |
Password del servizio XML per il nome utente XML specificato. La password immessa in questo campo viene visualizzata nel file di configurazione (cfg.xml) come segue:
|
CISCO XML EXE Enable |
Impostazione predefinita: No Opzioni: Sì, No |
Specifica se è necessaria l'autenticazione per accedere al server applicazioni XML. È inoltre possibile configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) immettendo una stringa in questo formato:
|
CISCO XML EXE Auth Mode |
Predefinito: Local Credential Opzioni: Attendibile, Credenziale locale, Credenziale remota |
Consente di specificare la modalità di autenticazione per Cisco XML EXE.
È inoltre possibile configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) immettendo una stringa in questo formato:
|
Aggiungere un'applicazione XML a un softkey
Aggiungere le applicazioni utilizzate di frequente ai softkey per consentire agli utenti di accedere facilmente al servizio.
Operazioni preliminari
Il servizio applicativo XML è stato configurato correttamente.
1 |
Accedere alla pagina Web di amministrazione del telefono. |
2 |
Selezionare . |
3 |
Nella sezione Programmable Softkeys, impostare Programmable Softkey Enable su Yes. È inoltre possibile configurare questo parametro nel file di configurazione (cfg.xml). Immettere una stringa nel seguente formato:
|
4 |
Nella sezione Softkey programmabili, modificare i campi disponibili da PSK1 a PSK16 in questo formato: fnc=xml;url=<xml_app_path>; nme=<app_name>
dove
Esempio È inoltre possibile configurare questo parametro nel file di configurazione (cfg.xml). Immettere una stringa nel seguente formato:
dove n è il numero softkey. |
5 |
Fai clic su Salva tutte le modifiche. |
Aggiungere un'applicazione XML a una chiave di riga
Aggiungere le applicazioni utilizzate di frequente alle chiavi di linea per consentire agli utenti di accedere facilmente ai servizi.
Operazioni preliminari
Il servizio applicativo XML è stato configurato correttamente.
1 |
Accedere alla pagina Web di amministrazione del telefono. |
2 |
Selezionare . |
3 |
Selezionare un tasto di linea. |
4 |
Impostare il parametro Interno su Disattivato per disabilitare l'interno. Se la funzione Direct PLK Configuration è disabilitata, è necessario disabilitare l'interno per aggiungere una funzione estesa al tasto di linea. Se la funzione è abilitata, è possibile ignorare questo passaggio. Per informazioni dettagliate, vedere Abilitazione della configurazione Direct PLK. |
5 |
Nel parametro Funzione estesa immettere una stringa nel seguente formato: fnc=xml;url=<xml_app_path>; nme=<app_name>
dove
Esempio È inoltre possibile configurare questo parametro nel file di configurazione (cfg.xml). Immettere una stringa nel seguente formato:
dove n è il numero di interno. |
6 |
Fai clic su Salva tutte le modifiche. |
Variabili macro supportate negli URL XML
È possibile utilizzare variabili macro negli URL XML. Sono supportate le seguenti variabili macro:
-
ID utente: UID1, da UID2 a UIDn
-
Nome visualizzato: DISPLAYNAME1, da DISPLAYNAME2 a DISPLAYNAMEn
-
ID autenticazione: AUTHID1, da AUTHID2 a AUTHIDn
-
Proxy: PROXY1, da PROXY2 a PROXYn
-
Indirizzo MAC con cifre esadecimali minuscole: MA
-
Nome prodotto: PN
-
Numero di serie del prodotto: PSN
-
Il numero di serie: SERIAL_NUMBER
Nome macro | Espansione macro |
---|---|
$ | La forma $$ si espande in un singolo carattere $. |
Da A a P | Sostituiti dai parametri generici da GPP_A a GPP_P. |
Da SA a SD | Sostituiti dai parametri speciali da GPP_SA a GPP_SD. Questi parametri includono i tasti o le password utilizzati per il provisioning. I parametri da $SA a $SD vengono riconosciuti come argomenti per il qualificatore dell'URL di risincronizzazione opzionale "--key". |
MA | Indirizzo MAC con cifre esadecimali minuscole (000e08aabbcc). |
MAU | Indirizzo MAC con cifre esadecimali maiuscole (000E08AABBCC). |
MAC | Indirizzo MAC con cifre esadecimali minuscole e due punti come separatore delle coppie di cifre esadecimali (00:0e:08:aa:bb:cc). |
PN | Nome del prodotto; ad esempio, Video Phone 8875, Desk Phone 9851. |
PSN | Numero di serie del prodotto; Ad esempio, 8875, 9841, 9861 |
SN | Stringa del numero di serie, ad esempio 88012BA01234. |
CCERT | Stato del certificato client SSL, installato o meno. |
IP | Indirizzo IP del telefono nella propria subnet locale, ad esempio 192.168.1.100. |
EXTIP | Indirizzo IP esterno del telefono, come visualizzato su Internet, ad esempio 66.43.16.52. |
SWVER |
Stringa della versione del software. Ad esempio: PHONEOS.3-2-1-0104-37 |
HWVER |
Stringa della versione dell'hardware. Ad esempio, 2.0.1 |
PRVST |
Stato del provisioning (stringa numerica): -1 = richiesta di risincronizzazione esplicita 0 = risincronizzazione all'accensione 1 = risincronizzazione periodica 2 = risincronizzazione non riuscita, nuovo tentativo |
UPGST |
Stato dell'aggiornamento (stringa numerica): 1 = primo tentativo di aggiornamento 2 =aggiornamento non riuscito, nuovo tentativo |
UPGERR |
Risultato (ERR) del tentativo di aggiornamento precedente; ad esempio http_get non riuscito. |
PRVTMR |
Secondi dall'ultimo tentativo di risincronizzazione. |
UPGTMR |
Secondi dall'ultimo tentativo di aggiornamento. |
REGTMR1 |
Secondi dalla mancata registrazione della Linea 1 con il server SIP. |
REGTMR2 |
Secondi dalla mancata registrazione della Linea 2 con il server SIP. |
UPGCOND |
Nome macro precedente. |
SCHEME |
Schema di accesso di file (uno tra TFTP, HTTP o HTTPS), ottenuto dopo l'analisi di risincronizzazione o aggiornamento dell'URL. |
SERV |
Richiedere il nome dell'host del server di destinazione, come ottenuto dopo l'analisi di risincronizzazione o aggiornamento dell'URL. |
SERVIP |
Richiedere l'indirizzo IP del server di destinazione, come ottenute dopo l'analisi di risincronizzazione o aggiornamento dell'URL, eventualmente seguendo ricerca DNS. |
PORTA |
Richiedere porta UDP/TCP di destinazione, come ottenuto dopo l'analisi di risincronizzazione o aggiornamento dell'URL. |
PATH |
Richiedere percorso file di destinazione, come ottenuto dopo l'analisi di risincronizzazione o aggiornamento dell'URL. |
ERR |
Risultato del tentativo di risincronizzazione o aggiornamento. Solo utili per la generazione di messaggi syslog di risultato. Il valore viene mantenuto nella variabile UPGERR nel caso di tentativi di aggiornamento. |
UIDn |
Il contenuto del parametro di configurazione UserID per la linea n. |
ISCUST |
Se l'unità è personalizzata, valore = 1, in caso contrario 0. Lo stato di personalizzazione è visualizzabile nella pagina Informazioni interfaccia utente Web. |
INCOMINGNAME | Nome associato alla prima chiamata connessa, in arrivo o in entrata. |
REMOTENUMBER |
Numero di telefono del prima chiamata connessa, in arrivo o in entrata. Se sono presenti più chiamate, vengono forniti i dati associati alla prima chiamata trovata. |
DISPLAYNAMEn | Il contenuto del parametro di configurazione Display Name per la linea n. |
AUTHIDn | Il contenuto del parametro di configurazione Auth ID per la linea n. |