- Home
- /
- Articolo
Configurazione delle applicazioni XML per i telefoni su BroadWorks
Questo articolo della Guida si applica a Cisco Desk Phone serie 9800 e Cisco Video Phone 8875 registrati su 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 abbonato il telefono ai servizi, gli utenti possono accedere a tutti i servizi configurati sul telefono passando a
. I servizi XML Cisco sono il nome predefinito. È inoltre possibile modificare il nome. Per fornire un accesso facile agli utenti, è possibile aggiungere le applicazioni XML ai softkey o ai tasti di linea.Le funzioni supportate sono:
- Messaggi (immagini e testo)
- Cercapersone
Oggetti XML supportati
-
MenuTelefonoIP Cisco
-
Testo IP Cisco
-
Input telefono IP Cisco
-
RubricaIP Cisco
-
Immagine telefono IP Cisco
-
FileImmagineCisco
-
Menu icona telefono IP Cisco
-
MenuFileIconaIP Cisco
-
CiscoIPPhoneStatus (tranne 9841)
-
CiscoIPPhoneStatusFile (tranne 9841)
-
Esecuzione telefono IP Cisco
URI supportati
-
Dispositivo
-
Chiama
-
Modifica
-
Init
-
Chiave
-
Riproduci (solo suonerie)
-
Softkey
Per ulteriori dettagli sulla configurazione del servizio XSI, vedi Note di sviluppo dell'applicazione per i servizi del telefono IP Cisco Unified.
Configurazione di 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 Nome servizio applicazione XML e URL servizio applicazione XML come definito in Parametri per i servizi XML. |
4 |
(Opzionale) Per aggiungere l'autenticazione per l'accesso al servizio dell'applicazione, configurare queste campi: Nome utente XML, Password XML, Abilitazione CISCO XML EXE e Modalità autenticazione CISCO XML EXE. |
5 |
Fare clic su Salva tutte le modifiche. |
Parametri per i servizi XML
La seguente tabella definisce la funzione e l'utilizzo dei parametri per le applicazioni XML nella sezione XML Service della scheda nell'interfaccia Web del telefono. Definisce inoltre la sintassi della stringa aggiunta nel file di configurazione del telefono (cfg.xml) con codice XML per la configurazione di un parametro.
Parametro |
Predefinito e opzioni |
Descrizione |
---|---|---|
Nome servizio applicazione XML |
Impostazione predefinita: Vuoto |
Nome dell'applicazione XML. Il nome viene visualizzato sul telefono 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:
|
URL servizio applicazione XML |
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 HTTPs sono supportati nell'URL. |
Nome utente XML |
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:
|
Password XML |
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:
|
Abilitazione di CISCO XML EXE |
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:
|
Modalità autenticazione CISCO XML EXE |
Impostazione predefinita: Credenziale locale Opzioni: Attendibile, credenziale locale, credenziale remota |
Specifica 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:
|
Aggiunta di 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 applicazione XML è stato configurato correttamente.
1 |
Accedere alla pagina Web di amministrazione del telefono. |
2 |
Selezionare . |
3 |
Nella sezione Softkey programmabili, impostare Abilita softkey programmabile su Sì. È inoltre possibile configurare questo parametro nel file di configurazione (cfg.xml). Immettere una stringa in questo formato:
|
4 |
Nella sezione Softkey programmabili, modificare i campi disponibili da PSK1 a PSK16 nel seguente formato: fnc=xml;url=<xml_app_path>;nme=<app_name>
dove url è il collegamento in cui è memorizzata l'applicazione XML; nme è il nome visualizzato dell'applicazione sullo schermo del telefono.
Esempio
È inoltre possibile configurare questo parametro nel file di configurazione (cfg.xml). Immettere una stringa in questo formato:
dove n è il numero del softkey. |
5 |
Fare clic su Salva tutte le modifiche. |
Aggiunta di un'applicazione XML a un tasto di linea
Aggiungere le applicazioni utilizzate di frequente ai tasti di linea per consentire agli utenti di accedere facilmente ai servizi.
Operazioni preliminari
Il servizio applicazione 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 Disabilitato per disabilitare l'interno. Se la funzione Configurazione PLK diretto è disabilitata, è necessario disabilitare l'interno per aggiungere una funzione estesa al tasto di linea. Se la funzione è abilitata, è possibile ignorare questo passaggio. Per dettagli, vedere Abilitazione configurazione PLK diretto. |
5 |
Nel parametro Funzione estesa, immettere una stringa in questo formato: fnc=xml;url=<xml_app_path>;nme=<app_name>
dove url è il collegamento in cui è memorizzata l'applicazione XML; nme è il nome visualizzato dell'applicazione sullo schermo del telefono.
Esempio
È inoltre possibile configurare questo parametro nel file di configurazione (cfg.xml). Immettere una stringa in questo formato:
dove n è il numero di interno. |
6 |
Fare 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
-
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 contengono i tasti o le password utilizzati nel provisioning. 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 per separare le coppie di cifre esadecimali (00:0e:08:aa:bb:cc). |
pn | Nome prodotto, ad esempio videotelefono 8875, telefono fisso 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. |
spigolo | Indirizzo IP esterno del telefono, come visualizzato su Internet, ad esempio 66.43.16.52. |
scambiatore |
Stringa della versione del software. Ad esempio, foneos.3-2-1-0104-37 |
Categoria: Hwver |
Stringa della versione dell'hardware. Ad esempio, 2.0.1 |
prvst |
Stato provisioning (stringa numerica): -1 = richiesta di risincronizzazione esplicita 0 = risincronizzazione all'accensione 1 = risincronizzazione periodica 2 = risincronizzazione non riuscita, nuovo tentativo |
superiore |
Stato dell'aggiornamento (stringa numerica): 1 = primo tentativo di aggiornamento 2 = aggiornamento non riuscito, nuovo tentativo |
ascendente |
Risultato (ERR) del tentativo di aggiornamento precedente, ad esempio http_get non riuscito. |
prvtmr |
Secondi dall'ultimo tentativo di risincronizzazione. |
ugo |
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 preesistente. |
schema |
Schema di accesso di file (uno tra TFTP, HTTP o HTTPS), ottenuto dopo l'analisi di risincronizzazione o aggiornamento dell'URL. |
servizio |
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 ottenuto dopo l'analisi di risincronizzazione o aggiornamento dell'URL, eventualmente seguendo una ricerca DNS. |
porta |
Richiedere porta UDP/TCP di destinazione, come ottenuto dopo l'analisi di risincronizzazione o aggiornamento dell'URL. |
percorso |
Richiedere percorso file di destinazione, come ottenuto dopo l'analisi di risincronizzazione o aggiornamento dell'URL. |
errato |
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. |
nUID |
Il contenuto del parametro di configurazione UserID per la linea n. |
iscust |
Se l'unità è personalizzata, valore = 1, in caso contrario 0. Lo stato della personalizzazione è visualizzabile nella pagina Info dell'interfaccia utente Web. |
nome | Nome associato alla prima chiamata connessa, in arrivo o in entrata. |
numero di remotenumber |
Numero di telefono del primo chiamata connessa, in arrivo o in entrata. Se sono presenti più chiamate, vengono forniti i dati associati alla prima chiamata trovata. |
NOMEVISUALIZZATO | Il contenuto del parametro di configurazione Display Name per la linea n. |
ID AUTORIZZAZIONE | Il contenuto del parametro di configurazione auth ID per la linea n. |