- Home
- /
- Articolo
Grazie per il feedback.
Configurazione delle applicazioni XML per telefoni 9800 e 8875 (BroadWorks)
In questo articolo
Feedback?Questo articolo della Guida si applica al telefono da tavolo Cisco serie 9800 e al telefono video Cisco 8875 registrati presso Cisco BroadWorks. Leggi questo articolo per gli oggetti XML supportati, gli URI e i passaggi per configurare i servizi XSI sulla pagina web del telefono.
Panoramica
XML Services Interface (XSI) è un protocollo che consente la comunicazione tra le applicazioni e il sistema telefonico. Può aggiungere i suoi servizi XSI al suo telefono utilizzando gli oggetti e gli URI XML supportati.
Dopo aver abbonato il telefono ai servizi, gli utenti possono accedere a tutti i servizi configurati sul telefono accedendo a . Cisco XML Services è il nome predefinito. Può anche cambiare il nome. Per fornire un facile accesso agli utenti, può aggiungere le applicazioni XML ai softkey o ai tasti di riga.
Le funzionalità supportate sono:
- Messaggi (immagini e testo)
- Cercapersone
Oggetti XML supportati
-
Menu Cisco IP Phone
-
Testo del telefono Cisco IP
-
Ingresso telefonico Cisco IP
-
Elenco telefonico Cisco IP
-
Immagine del telefono Cisco IP
-
File di immagine del telefono Cisco IP
-
Menu delle icone del telefono Cisco IP
-
Menu File delle icone del telefono Cisco IP
-
Cisco IPPhoneStatus (eccetto 9811 e 9841)
-
File di stato dell'iPhone Cisco (eccetto 9811 e 9841)
-
Cisco IP PhoneExecute
URI supportati
-
Dispositivo
-
Quadrante
-
Modifica Dail
-
Iniziare
-
Chiave
-
Play (solo suonerie)
-
Softkey
Per maggiori dettagli sulla configurazione del servizio XSI, vedere le note sullo sviluppo delle applicazioni Cisco Unified IP Phone Services.
Configurare un telefono per connettersi a un servizio XML
| 1 |
Accedere alla pagina web di amministrazione del telefono. |
| 2 |
Seleziona . |
| 3 |
Nella sezione Servizio XML, configura i parametri XML Application Service Name e XML Application Service URL come definiti in Parametri per i servizi XML. |
| 4 |
(Facoltativo) Per aggiungere l'autenticazione per l'accesso al servizio applicativo, configura questi campi: Nome utente XML, Password XML, abilitazione CISCO XML EXE e modalità di autenticazione CISCO XML EXE. |
| 5 |
Faccia clic su Salva tutte le modifiche. |
Parametri per i servizi XML
La tabella seguente definisce la funzione e l'utilizzo dei parametri dell'applicazione XML nella sezione Servizio XML della scheda nell'interfaccia web del telefono. Definisce inoltre la sintassi della stringa che viene aggiunta nel file di configurazione del telefono (cfg.xml) con codice XML per configurare un parametro.
|
Parametro |
Impostazioni predefinite e opzioni |
Descrizione |
|---|---|---|
|
Nome del servizio dell'applicazione XML |
Predefinito: vuoto |
Nome dell'applicazione XML. Il nome viene visualizzato sul telefono come applicazione web scelta. Può anche configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) inserendo una stringa in questo formato: |
|
URL del servizio di applicazione XML |
Predefinito: vuoto |
L'URL in cui si trova l'applicazione XML. Può anche configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) inserendo 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. Nell'URL sono supportati solo i protocolli HTTP o HTTPs. |
|
Nome utente XML |
Predefinito: vuoto |
Nome utente del servizio XML per scopi di autenticazione. Può anche configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) inserendo una stringa in questo formato: |
|
Password XML |
Predefinito: vuoto |
Password del servizio XML per il nome utente XML specificato. La password che ha inserito in questo campo è riportata nel file di configurazione (cfg.xml) come segue: |
|
Attivazione CISCO XML EXE |
Predefinito: No Opzioni: Sì, No |
Specifica se è richiesta l'autenticazione per accedere al server delle applicazioni XML. Può anche configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) inserendo una stringa in questo formato: |
|
Modalità di autenticazione CISCO XML EXE |
Predefinito: credenziale locale Opzioni: affidabile, credenziale locale, credenziale remota |
Specifica la modalità di autenticazione per Cisco XML EXE.
Può anche configurare questo parametro nel file XML di configurazione del telefono (cfg.xml) inserendo una stringa in questo formato: |
Aggiungere un'applicazione XML a un softkey
Aggiunga le applicazioni utilizzate di frequente ai softkey per consentire agli utenti di accedere facilmente al servizio.
Prima che Lei cominci
L'Application Service XML è stato configurato correttamente.
| 1 |
Accedere alla pagina web di amministrazione del telefono. |
| 2 |
Seleziona . |
| 3 |
Nella sezione Softkey programmabili, imposti il Softkey programmabile abilitato su Sì. Può configurare questo parametro anche nel file di configurazione (cfg.xml). Inserisca una stringa in questo formato: |
| 4 |
Nella sezione Softkeys programmabili, modifica i campi disponibili da PSK1 a PSK16 in questo formato: fnc=xml;url=<xml_app_path>;nme=<app_name>
dove
Esempio
Può configurare questo parametro anche nel file di configurazione (cfg.xml). Inserisca una stringa in questo formato:
dove n è il numero del softkey. |
| 5 |
Faccia clic su Salva tutte le modifiche. |
Aggiungere un'applicazione XML a un tasto di riga
Aggiungere le applicazioni utilizzate di frequente ai tasti di riga per consentire agli utenti di accedere facilmente ai servizi.
Prima che Lei cominci
L'Application Service XML è stato configurato correttamente.
| 1 |
Accedere alla pagina web di amministrazione del telefono. |
| 2 |
Seleziona . |
| 3 |
Seleziona un tasto di riga. |
| 4 |
Impostare il parametro Estensione su Disabilitato per disabilitare l'estensione. Se la funzione Direct PLK Configuration è disabilitata, deve disabilitare l'estensione per aggiungere una funzione estesa al tasto di linea. Se la funzione è abilitata, può saltare questo passaggio. Per i dettagli, vedere Abilitare la configurazione Direct PLK. |
| 5 |
Nel parametro Extended Function, inserisca una stringa in questo formato: fnc=xml;url=<xml_app_path>;nme=<app_name>
dove
Esempio
Può configurare questo parametro anche nel file di configurazione (cfg.xml). Inserisca una stringa in questo formato:
dove n è il numero di estensione. |
| 6 |
Faccia clic su Salva tutte le modifiche. |
Variabili macro supportate negli URL XML
Può utilizzare le variabili macro negli URL XML. Sono supportate le seguenti variabili macro:
-
ID utente: UID1, da UID2 a UIdN
-
Nome visualizzato: da DisplayName1, da DISPLAYNAME2 a DisplayNameN
-
ID di autenticazione: AUTHID1, da AUTHID2 a AuthIDN
-
Proxy—Proxy1, da PROXY2 a ProXyN
-
Indirizzo MAC con cifre esadecimali minuscole: MA
-
Nome del prodotto—PN
-
Numero di serie del prodotto: PSN
-
Numero di serie — Serial_number
| Nome macro | Espansione macro |
|---|---|
| $ | Il modulo $$ si espande in un solo carattere $. |
| Da A a P | Sostituito dai parametri generici da GPP_A a GPP_P. |
| SA tramite SD | Sostituito dai parametri speciali da GPP_SA a GPP_SD. Questi parametri
contengono le chiavi o le password utilizzate nel provisioning. Da $SA a $SD sono riconosciuti come argomenti del qualificatore URL di risincronizzazione opzionale, --key. |
| MA | Indirizzo MAC con cifre esadecimali minuscole (000e08aabbcc ). |
| MAU | Indirizzo MAC con cifre esadecimali maiuscole (000E08AABBCC). |
| MAC | Indirizzo MAC che utilizza cifre esadecimali minuscole con due punti per separare le coppie di cifre esadecimali (00:0 e:08:aa:bb:cc). |
| PN | Nome del 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 non installato. |
| IP | Indirizzo IP del telefono all'interno della sottorete locale; ad esempio, 192.168.1.100. |
| EXTIP | IP esterno del telefono, visto 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 hardware. Ad esempio, 2.0.1 |
|
PRVST |
Stato di fornitura (una stringa numerica): -1 = richiesta di risincronizzazione esplicita 0 = risincronizzazione dell'accensione 1 = risincronizzazione periodica 2 = risincronizzazione fallita, tentativo di nuovo tentativo |
|
UPGST |
Upgrade State (una stringa numerica): 1 = primo tentativo di upgrade 2 = aggiornamento fallito, riprova |
|
UPGERR |
Messaggio di risultato (ERR) del precedente tentativo di aggiornamento; ad esempio http_get fallito. |
|
PRVTMR |
Secondi dall'ultimo tentativo di risincronizzazione. |
|
UPGTMR |
Secondi dall'ultimo tentativo di aggiornamento. |
|
REGTMR1 |
Pochi secondi da quando Line 1 ha perso la registrazione al server SIP. |
|
REGTMR2 |
Pochi secondi da quando Line 2 ha perso la registrazione al server SIP. |
|
UPGCOND |
Nome macro precedente. |
|
SCHEME |
Schema di accesso ai file, uno tra TFTP, HTTP o HTTPS, ottenuto dopo l'analisi dell'URL di risincronizzazione o aggiornamento. |
|
SERV |
Richiedere il nome host del server di destinazione, ottenuto dopo l'analisi dell'URL di risincronizzazione o aggiornamento. |
|
SERVIP |
Richiedere l'indirizzo IP del server di destinazione, ottenuto dopo l'analisi dell'URL di risincronizzazione o aggiornamento, possibilmente dopo una ricerca DNS. |
|
PORT |
Richiedere la porta UDP/TCP di destinazione, ottenuta dopo aver analizzato l'URL di risincronizzazione o aggiornamento. |
|
PATH |
Richiedere il percorso del file di destinazione, ottenuto dopo aver analizzato l'URL di risincronizzazione o aggiornamento. |
|
ERR |
Messaggio di risultato della risincronizzazione o del tentativo di aggiornamento. Utile solo per generare messaggi syslog con i risultati. Il valore viene mantenuto nella variabile UPGERR in caso di tentativi di aggiornamento. |
|
UIdN |
Il contenuto del parametro di configurazione Line n UserID. |
| ISCUST |
Se l'unità è personalizzata, valore=1, altrimenti 0. Lo stato della personalizzazione è visualizzabile nella pagina di informazioni sull'interfaccia utente Web. |
| INCOMINGNAME | Nome associato alla prima chiamata connessa, che squilla o in entrata. |
| REMOTENUMBER |
Numero di telefono della prima chiamata connessa, che squilla o in entrata. Se ci sono più chiamate, vengono forniti i dati associati alla prima chiamata trovata. |
| Nome visualizzato | Il contenuto del parametro di configurazione Line N Display Name. |
| AutHIDN | Il contenuto del parametro di configurazione Line N auth ID. |
