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 Impostazioni > Rete e servizio > Servizi XML Cisco. 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 Voce > Telefono.

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 Voice > Phone 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.

Tabella 1. Parametri per i servizi XML

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:

<XML_Application_Service_Name ua="na">Nome APP XML</XML_Application_Service_Name>

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:

<XML_Application_Service_URL ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

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:

<XML_User_Name ua="na">nomeutente</XML_User_Name>

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:

<!-- <XML_Password ua="na">;*************</XML_Password> -->

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:

<CISCO_XML_EXE_Enable ua="na">Sì</CISCO_XML_EXE_Enable>

Modalità autenticazione CISCO XML EXE

Impostazione predefinita: Credenziale locale

Opzioni: Attendibile, credenziale locale, credenziale remota

Specifica la modalità di autenticazione per Cisco XML EXE.

  • Trusted: non viene eseguita alcuna autenticazione indipendentemente dalle credenziali locali.

  • Local Credential: l'autenticazione si basa sull'autenticazione del digest mediante la credenziale locale, se impostata. Se le credenziali locali non sono impostate, non viene eseguita alcuna autenticazione.

  • Remote Credential: l'autenticazione si basa sull'autenticazione del digest mediante la credenziale remota impostata nell'applicazione XML nella pagina Web, per accedere a un server di applicazione 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 ua="na">Credenziali locali</CISCO_XML_EXE_Auth_Mode>

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 Voce > Telefono.

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:

<Programmable_Softkey_Enable ua="na">Sì</Programmable_Softkey_Enable>
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 fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

È inoltre possibile configurare questo parametro nel file di configurazione (cfg.xml). Immettere una stringa in questo formato:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<codice di configurazione></PSK_n>

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 Voce > Telefono.

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 fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

È inoltre possibile configurare questo parametro nel file di configurazione (cfg.xml). Immettere una stringa in questo formato:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<codice di configurazione></Extended_Function_n_>

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

Tabella 2. Macro supportate
Nome macroEspansione macro
$La forma $$ si espande in un singolo carattere $.
Da A a PSostituiti dai parametri generici da GPP_A a GPP_P.
Da SA a SDSostituiti 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.
maIndirizzo MAC con cifre esadecimali minuscole (000e08aabbcc).
MAUIndirizzo MAC con cifre esadecimali maiuscole (000E08AABBCC).
macIndirizzo MAC con cifre esadecimali minuscole e due punti per separare le coppie di cifre esadecimali (00:0e:08:aa:bb:cc).
pnNome prodotto, ad esempio videotelefono 8875, telefono fisso 9851.
psnNumero di serie del prodotto, ad esempio 8875, 9841, 9861
snStringa del numero di serie, ad esempio 88012BA01234.
CCERTStato del certificato client SSL, installato o meno.
IPIndirizzo IP del telefono nella propria subnet locale, ad esempio 192.168.1.100.
spigoloIndirizzo 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.

nomeNome 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.

NOMEVISUALIZZATOIl contenuto del parametro di configurazione Display Name per la linea n.
ID AUTORIZZAZIONEIl contenuto del parametro di configurazione auth ID per la linea n.