Descripción general

XML Services Interface (XSI) es un protocolo que permite la comunicación entre las aplicaciones y el sistema telefónico. Puede agregar sus propios servicios XSI al teléfono mediante los objetos XML y URI admitidos.

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

Las características admitidas son:

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

Objetos XML admitidos

  • CiscoIPPhoneMenu (MenuDelTelefonoIPCisco)

  • CiscoIPPhoneText (TextoDelTelefonoIPCisco)

  • CiscoIPPhoneInput (EntradaDelTelefonoIPCisco)

  • CiscoIPPhoneDirectory (DirectorioDelTelefonoIPCisco)

  • CiscoIPPhoneImage (ImagenDelTelefonoIPCisco)

  • CiscoIPPhoneImageFile (ArchivoDeImagenDelTelefonoIPCisco)

  • CiscoIPPhoneIconMenu (MenuDelIconoDelTelefonoIPCisco)

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (excepto 9841)

  • CiscoIPPhoneStatusFile (excepto 9841)

  • CiscoIPPhoneExecute (EjecucionDelTextoDelTelefonoIPCisco)

URI admitidas

  • Disp.

  • Marcar

  • EditDail

  • Init

  • Llave

  • Reproducir (solo tonos de llamada)

  • Tecla programable

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

Configurar un teléfono para conectarse a un servicio de XML

1

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

2

Seleccione Voice (Voz) > Phone (Teléfono).

3

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

4

(Opcional) Para agregar autenticación para acceder al servicio de aplicación, configure estos campos: XML Nombre de usuario, XML contraseña, CISCO XML EXE Enable y CISCO XML EXE Auth Mode.

5

Haga clic en Guardar todos los cambios.

Parámetros para XML servicios

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

Tabla 1. Parámetros para XML servicios

Parámetro

Valores predeterminados y opciones

Descripción

XML Application Service Name (Nombres del servicio de la aplicación XML)

Valor predeterminado: Empty (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 de configuración XML del teléfono (cfg.xml) mediante la escritura de una cadena con este formato:

<XML_Application_Service_Name ua="na">XML Nombre de la aplicación</XML_Application_Service_Name>

XML Application Service URL (URL del servicio de la aplicación XML)

Valor predeterminado: Empty (Vacío)

La dirección URL donde se encuentra la aplicación XML.

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

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

Las variables de macro son compatibles con las URL de XML. Para conocer las variables de macro válidas, consulte Variables de macro admitidas en direcciones URL de XML.

En la dirección URL solo se admiten protocolos HTTP o HTTP.

XML User Name (Nombre de usuario XML)

Valor predeterminado: Empty (Vacío)

Nombre de usuario del servicio XML a efectos de autenticación.

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

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

XML Password (Contraseña de XML)

Valor predeterminado: Empty (Vacío)

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

La contraseña introducida en este campo se muestra en el archivo de configuración (cfg.xml) como la siguiente:

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

CISCO XML EXE Enable (Habilitar ejecución de XML de Cisco)

Valor predeterminado: no

Opciones: Sí y No

Especifica si la autenticación es necesaria para acceder al servidor de la aplicación XML.

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

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

CISCO XML EXE Auth Mode (Modo de autenticación de ejecución de XML de Cisco)

Valor predeterminado: Local Credential (Credencial local)

Opciones: De confianza, Credencial local, Credencial remota

Especifica el modo de autenticación de ejecución de XML de Cisco.

  • Trusted (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 la autenticación.

  • Remote Credential (Credencial remota): la autenticación se basa en la autenticación implícita con 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 de configuración XML del teléfono (cfg.xml) mediante la escritura de una cadena con este formato:

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

Agregar una aplicación XML a una tecla programable

Agregue las aplicaciones de uso frecuente a las teclas programadas 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 Voice (Voz) > Phone (Teléfono).

3

En la sección Programmable Softkeys (Teclas programables), establezca Programmable Softkey Enable (Habilitar tecla programable) en Yes (Sí).

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

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

En la sección Teclas programables 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 vínculo 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). Ingrese una cadena con este formato:

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

donde n es el número de tecla programable.

5

Haga clic en Guardar todos los cambios.

Agregar una aplicación XML a una clave 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 Voice (Voz) > Phone (Teléfono).

3

Seleccione una tecla de línea.

4

Establezca el parámetro Extensión en Deshabilitado para deshabilitarla.

Si la función Configuración directa de PLK está deshabilitada, debe deshabilitar la extensión para agregar una función extendida a la clave de línea. Si la función está habilitada, puede omitir este paso. Para obtener más información, consulte Habilitar configuración de Direct PLK.
5

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

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

donde url es el vínculo 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). Ingrese una cadena con este formato:

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

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

6

Haga clic en Guardar todos los cambios.

Variables de macro admitidas en URL de XML

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

  • User ID (ID de usuario): UID1, UID2 a UIDn

  • Display name (Nombre de visualización): DISPLAYNAME1, DISPLAYNAME2 a DISPLAYNAMEn

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

  • Proxy: PROXY1, PROXY2 a PROXYn

  • MAC Address using lowercase hex digits (Dirección MAC que utiliza dígitos hexadecimales en minúsculas): MA

  • Product Name (Nombre del producto): PN

  • Product Series Number (Número de serie del producto): PSN

  • Serial Number (Número de serie): SERIAL_NUMBER (NUMERO_SERIE)

Tabla 2. Macros admitidas
Nombre de macroExpansión de macros
$El formulario $$ se extiende a un solo caracter $.
A through P (De A a P)Se ha sustituido por parámetros de propósitos generales GPP_A hasta GPP_P.
SA through SD (SA hasta SD)Se ha sustituido por los parámetros de propósito especiales GPP_SA hasta GPP_SD. Estos parámetros contienen claves o contraseñas que se usan en el aprovisionamiento.
$SA hasta $SD se reconocen como argumentos del calificador de URL de resincronización opcional, --key (--clave).
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).
PN (Nombre de producto)Nombre del producto; por ejemplo, Video Phone 8875, Desk Phone 9851.
PSN (NSP)Número de serie del producto; Por ejemplo, 8875, 9841, 9861
SN (Cadena de número de serie)Cadena de número de serie; por ejemplo, 88012BA01234.
CCERT (Certificado cliente)Estado 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.
EXTIP (IPEXT)IP externa del teléfono, tal como se ve en internet; por ejemplo, 66.43.16.52.

SWVER (Versión de software)

Cadena de versión de software. Por ejemplo,

PHONEOS.3-2-1-0104-37

HWVER (Versión de hardware)

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

PRVST (Estado de aprovisionamiento)

Estado de aprovisionamiento (una cadena numérica):

-1 = solicitud de resincronización explícita

0 = resincronización en encendido

1 = resincronización periódica

2 = fallo de resincronización, reintentar

UPGST (Estado de actualización)

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

1 = primer intento de actualización

2 = fallo de actualización, reintentar

UPGERR (Error de actualización)

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.

UPGCOND

Nombre de macro heredado.

SCHEME (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 (Servidor)

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

SERVIP (IP del servidor)

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

PORT (Puerto)

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

PATH (Ruta)

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

ERR (Error)

Mensaje de resultado de intento de resincronización o actualización. Solo es útil para generar resultados de mensajes de registros del sistema. 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 (IDUsuario) de Line n.

ISCUST

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

El estado de personalización se puede ver en la página Información de la interfaz de usuario web.

INCOMINGNAME (Nombre entrante)Nombre asociado con la primera llamada conectada, la llamada entrante o el timbre de llamada.
REMOTENUMBER (Número remoto)

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

DISPLAYNAMEn (Nombre de visualización)El contenido del parámetro de configuración Line N Display Name (Nombre de visualización de línea N).
AUTHIDnEl contenido del parámetro de configuración Line N auth ID (Autenticación de ID de línea N).