- Inicio
- /
- Artículo
Configuración de aplicaciones XML para teléfonos en BroadWorks
Este artículo de ayuda se aplica a Cisco Desk Phone serie 9800 y Cisco Video Phone 8875 que están registrados en Cisco BroadWorks. Lea este artículo para conocer los objetos XML compatibles, las URI y los pasos para configurar los servicios de XSI en la página web del teléfono.
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
. 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 . |
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 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.
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:
|
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:
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:
|
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:
|
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:
|
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.
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:
|
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 . |
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:
|
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
También puede configurar este parámetro en el archivo de configuración (cfg.xml). Introduzca una cadena con este formato:
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 . |
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
También puede configurar este parámetro en el archivo de configuración (cfg.xml). Introduzca una cadena con este formato:
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
Nombre de la macro | Expansión de macros |
---|---|
$ | El formulario $$ se expande a un solo carácter $. |
De A a P | Se ha sustituido por parámetros de uso general GPP_A hasta GPP_P. |
SA a SD | Se 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. |
ma | Dirección MAC que utiliza dígitos hexadecimales en minúsculas (000e08aabbcc). |
MAU | Dirección MAC que utiliza dígitos hexadecimales en mayúsculas (000E08AABBCC). |
mac | Direcció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; por ejemplo, Video Phone 8875, Desk Phone 9851. |
psn | Número de serie de producto; por ejemplo, 8875, 9841, 9861 |
sn | Cadena de número de serie; por ejemplo, 88012BA01234. |
ccert | Estado del certificado del cliente SSL, instalado o no instalado. |
IP | Dirección IP del teléfono dentro de su subred local; por ejemplo, 192.168.1.100. |
exconsejo | IP 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 interno | Nombre 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 MOSTRARn | El contenido del parámetro de configuración Line N Display Name (Nombre para mostrar línea N). |
AUTENTICACIÓNn | El contenido del parámetro de configuración del ID de autenticación de línea N. |