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

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

Tabella 1. Parametri per XML servizi

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_Name ua="na">XML Nome APP</XML_Application_Service_Name>

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:

<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 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_User_Name ua="na">nome utente</XML_User_Name>

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:

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

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_Enable ua="na">Sì</CISCO_XML_EXE_Enable>

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.

  • Trusted: non viene eseguita alcuna autenticazione indipendentemente dalla credenziale locale.

  • Local Credential: l'autenticazione si basa sull'autenticazione del digest mediante la credenziale locale, se è impostata. Se non è impostata, non viene eseguita l'autenticazione.

  • Remote Credential: l'autenticazione si basa sull'autenticazione del digest mediante la credenziale locale 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">Credenziale locale</CISCO_XML_EXE_Auth_Mode>

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

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:

<Programmable_Softkey_Enable ua="na">Sì</Programmable_Softkey_Enable>
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 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 nel seguente 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 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 Voce > Telefono.

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 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 nel seguente 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

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

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 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".
MAIndirizzo MAC con cifre esadecimali minuscole (000e08aabbcc).
MAUIndirizzo MAC con cifre esadecimali maiuscole (000E08AABBCC).
MACIndirizzo MAC con cifre esadecimali minuscole e due punti come separatore delle coppie di cifre esadecimali (00:0e:08:aa:bb:cc).
PNNome del prodotto; ad esempio, Video Phone 8875, Desk Phone 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.
EXTIPIndirizzo 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.

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

DISPLAYNAMEnIl contenuto del parametro di configurazione Display Name per la linea n.
AUTHIDnIl contenuto del parametro di configurazione Auth ID per la linea n.