Descripción general

La interfaz de servicios XML (XSI) es un protocolo que permite la comunicación entre aplicaciones y el sistema telefónico. Puede agregar sus propios servicios de XSI a su teléfono mediante los objetos XML y las URI compatibles.

Después de suscribir el teléfono a los servicios, los usuarios pueden acceder a todos los servicios configurados en el teléfono navegando hasta Configuración > Red y servicio > Servicios XML de Cisco. Los servicios XML de Cisco son el nombre predeterminado. También puede cambiar el nombre. Para facilitar el acceso a los usuarios, puede agregar las aplicaciones XML a teclas programables o teclas de línea.

Las características compatibles son las siguientes:

  • Mensajes (imágenes y texto)
  • Paginación

Objetos XML soportados

  • CiscoIPPhoneMenu

  • Texto de CiscoIPPhone

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • Archivo de imagen de Cisco

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (excepto 9841)

  • CiscoIPPhoneStatusFile (excepto 9841)

  • CiscoIPPhoneExecute

URI compatibles

  • Dispositivo

  • Marcar

  • Editar dail

  • Init

  • Clave

  • Reproducir (solo tonos de llamada)

  • Tecla programable

Para obtener más detalles acerca de la configuración del servicio de XSI, consulte las Notas de desarrollo de aplicaciones de servicios telefónicos IP de Cisco Unified.

Configurar un teléfono para conectarse a un servicio XML

1

Acceda a la página web de administración del teléfono.

2

Seleccione Voz > Teléfono.

3

En la sección Servicio XML, configure los parámetros Nombre del servicio de la aplicación XML y URL del servicio de la aplicación XML como se definen en Parámetros para los servicios XML.

4

(Opcional) Para agregar autenticación para acceder al servicio de la aplicación, configure estos campos: Nombre de usuario XML, Contraseña XML, Habilitación de CISCO XML EXE y Modo de autenticación CISCO XML EXE.

5

Haga clic en Guardar todos los cambios.

Parámetros para servicios XML

En la siguiente tabla, se definen la función y el uso de los parámetros de la aplicación XML en la sección Servicio XML en la pestaña Voz > Teléfono en la interfaz web del teléfono. También define la sintaxis de la cadena que se agrega al archivo de configuración del teléfono (cfg.xml) con código XML para configurar un parámetro.

Tabla 1. Parámetros para servicios XML

Parámetro

Opciones y predeterminadas

Descripción

Nombre del servicio de la aplicación XML

Valor predeterminado: Vacío

Nombre de la aplicación XML. El nombre aparece en el teléfono como opción de aplicación web.

También puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) si ingresa una cadena con este formato:

<XML_Application_Service_Name ua="na">Nombre de la APLICACIÓN XML</XML_Application_Service_Name>

URL del servicio de la aplicación de XML

Valor predeterminado: Vacío

La URL donde se encuentra la aplicación XML.

También puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) si ingresa una cadena con este formato:

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

Las variables de macros se admiten en las URL XML. Para las variables de macros válidas, consulte Variables de macros admitidas en direcciones URL XML.

Solo se proporciona soporte para los protocolos HTTP o HTTP en la URL.

Nombre de usuario de XML

Valor predeterminado: Vacío

Nombre de usuario del servicio XML con fines de autenticación.

También puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) si ingresa una cadena con este formato:

<XML_User_Name ua="na">nombre de usuario</XML_User_Name>

Contraseña de XML

Valor predeterminado: Vacío

Contraseña del servicio XML para el nombre de usuario XML especificado.

La contraseña que introdujo en este campo aparece en el archivo de configuración (cfg.xml) como se indica a continuación:

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

Activación de EXE DE XML de CISCO

Valor predeterminado: No

Opciones: Sí, No

Especifica si se requiere autenticación para acceder al servidor de aplicaciones XML.

También puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) si ingresa una cadena con este formato:

<CISCO_XML_EXE_enable ua="na">Sí</CISCO_XML_EXE_Enable>

Modo de autenticación EXE de XML de CISCO

Valor predeterminado: Credencial local

Opciones: De confianza, credencial local, credencial remota

Especifica el modo de autenticación para el EXE de XML de Cisco.

  • De confianza: no se realiza ninguna autenticación independientemente de la credencial local.

  • Local Credential (Credencial local): la autenticación se basa en la autenticación implícita con la credencial local, si se establece. Si no se establece la credencial local, no se realiza ninguna autenticación.

  • Remote Credential (Credencial remota): la autenticación se basa en la autenticación implícita que utiliza la credencial remota como se establece en la aplicación XML en la página web (para acceder a un servidor de aplicaciones XML).

También puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) si ingresa una cadena con este formato:

<CISCO_XML_EXE_AUTH_Mode ua="na">Credencial local</CISCO_XML_EXE_Auth_Mode>

Añade una aplicación XML a una tecla programable

Agregue las aplicaciones de uso frecuente a las teclas programables para que los usuarios accedan fácilmente al servicio.

Antes de comenzar

El servicio de aplicación XML se ha configurado correctamente.

1

Acceda a la página web de administración del teléfono.

2

Seleccione Voz > Teléfono.

3

En la sección Teclas programables, defina Activación de teclas programables en Sí.

También puede configurar este parámetro en el archivo de configuración (cfg.xml). Introduzca una cadena con este formato:

<Programmable_Softkey_Enable ua="na">Sí</Programmable_Softkey_Enable>
4

En la sección Teclas programables, edite los campos disponibles de PSK1 a PSK16 en este formato:

fnc=xml;url=<xml_app_path>;nme=<app_name>

donde url es el enlace donde se almacena la aplicación XML; nme es el nombre para mostrar de la aplicación en la pantalla del teléfono.

Ejemplo fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

También puede configurar este parámetro en el archivo de configuración (cfg.xml). Introduzca una cadena con este formato:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<código de configuración></PSK_n>

donde n es el número de la tecla programable.

5

Haga clic en Guardar todos los cambios.

Añade una aplicación XML a una tecla de línea

Agregue las aplicaciones de uso frecuente a las teclas de línea para que los usuarios accedan fácilmente a los servicios.

Antes de comenzar

El servicio de aplicación XML se ha configurado correctamente.

1

Acceda a la página web de administración del teléfono.

2

Seleccione Voz > Teléfono.

3

Seleccione una tecla de línea.

4

Defina el parámetro Extensión en Deshabilitado para deshabilitar la extensión.

Si la función Direct PLK Configuration (Configuración de PLK directo) está desactivada, debe desactivar la extensión para agregar una función extendida a la tecla de línea. Si la característica está habilitada, puede omitir este paso. Para obtener detalles, consulte Habilitar configuración de PLK directo.
5

En el parámetro Función extendida, introduzca una cadena con este formato:

fnc=xml;url=<xml_app_path>;nme=<app_name>

donde url es el enlace donde se almacena la aplicación XML; nme es el nombre para mostrar de la aplicación en la pantalla del teléfono.

Ejemplo fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

También puede configurar este parámetro en el archivo de configuración (cfg.xml). Introduzca una cadena con este formato:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<código de configuración></Extended_Function_n_>

donde n es el número de extensión.

6

Haga clic en Guardar todos los cambios.

Variables de macros compatibles con las URL XML

Puede utilizar variables de macros en direcciones URL XML. Se admiten las siguientes variables de macros:

  • ID de usuario: UID1, UID2 a UIDn

  • Nombre para mostrar: DISPLAYNAME1, DISPLAYNAME2 a DISPLAYNAMEn

  • ID de autenticación: AUTHID1, AUTHID2 a AUTHIDn

  • Proxy: PROXY1, PROXY2 a PROXYn

  • Dirección MAC que utiliza dígitos hexadecimales en minúsculas: MA

  • Nombre del producto: PN

  • Número de serie de producto: PSN

  • Número de serie: SERIAL_NUMBER

Tabla 2. Macros compatibles
Nombre de la macroExpansión de macros
$El formulario $$ se expande a un solo carácter $.
De A a PSe ha sustituido por parámetros de uso general GPP_A hasta GPP_P.
SA a SDSe ha sustituido por parámetros de propósito especial GPP_SA hasta GPP_SD. Estos parámetros contienen claves o contraseñas utilizadas en el aprovisionamiento.
$SA a $SD se reconocen como argumentos para el calificador de URL de resincronización opcional, --key.
maDirección MAC que utiliza dígitos hexadecimales en minúsculas (000e08aabbcc).
MAUDirección MAC que utiliza dígitos hexadecimales en mayúsculas (000E08AABBCC).
macDirección MAC que utiliza dígitos hexadecimales en minúsculas con dos puntos para separar pares de dígitos hexadecimales (00:0e:08:aa:bb:cc).
pnNombre de producto; por ejemplo, Video Phone 8875, Desk Phone 9851.
psnNúmero de serie de producto; por ejemplo, 8875, 9841, 9861
snCadena de número de serie; por ejemplo, 88012BA01234.
ccertEstado del certificado del cliente SSL, instalado o no instalado.
IPDirección IP del teléfono dentro de su subred local; por ejemplo, 192.168.1.100.
exconsejoIP externa del teléfono, como se ve en Internet; por ejemplo, 66.43.16.52.

oscilación

Cadena de versión de software. Por ejemplo,

phoneos.3-2-1-0104-37

hwver

Cadena de versión de hardware. Por ejemplo, 2.0.1

prvst

Estado de aprovisionamiento (una cadena numérica):

-1 = solicitud de resincronización explícita

0 = resincronización de encendido

1 = resincronización periódica

2 = falló la resincronización, reintentar

Categoría: Upgst

Estado de actualización (una cadena numérica):

1 = primer intento de mejora

2 = error de mejora, reintentar

upgerr

Mensaje de resultado (ERR) del intento de actualización anterior; por ejemplo, http_get falló.

prvtmr

Segundos desde el último intento de resincronización.

upgtmr

Segundos desde el último intento de actualización.

regtmr1

Segundos desde que la Línea 1 perdió el registro con el servidor SIP.

regtmr2

Segundos desde que la Línea 2 perdió el registro con el servidor SIP.

cond. upgcond

Nombre de macro heredado.

esquema

Esquema de acceso a archivos, uno de TFTP, HTTP o HTTPS, como se obtuvo después de analizar la URL de resincronización o actualización.

serv

Solicite el nombre de host del servidor de destino, como se obtuvo después de analizar la URL de resincronización o actualización.

servicio

Solicite la dirección IP del servidor de destino, como se obtuvo después de analizar la URL de resincronización o actualización, posiblemente después de la búsqueda de DNS.

puerto

Solicite el puerto UDP/TCP de destino, como se obtuvo después de analizar la URL de actualización o resincronización.

ruta

Solicite la ruta de archivo de destino, como se obtuvo después de analizar la URL de resincronización o actualización.

err

Mensaje de resultado de intento de resincronización o actualización. Solo es útil para generar mensajes syslog de resultados. El valor se conserva en la variable UPGERR en caso de intentos de actualización.

UIDn

El contenido del parámetro de configuración UserID de línea n.

iscusta

Si la unidad está personalizada, valor=1, de lo contrario, 0.

El estado de personalización es visible en la página de información de la interfaz de usuario web.

nombre internoNombre asociado con la primera llamada conectada, con el timbre o entrante.
remotenumber

Número de teléfono de la primera llamada conectada, entrante o que suene. Si hay varias llamadas, se proporcionan los datos asociados con la primera llamada encontrada.

Nombre PARA MOSTRARnEl contenido del parámetro de configuración Line N Display Name (Nombre para mostrar línea N).
AUTENTICACIÓNnEl contenido del parámetro de configuración del ID de autenticación de línea N.