- Inicio
- /
- Artículo
Gracias por sus comentarios.
Configuración de aplicaciones XML para teléfonos 9800 y 8875 (BroadWorks)
En este artículo
¿Comentarios?Este artículo de ayuda se aplica a Cisco Desk Phone 9800 Series y Cisco Video Phone 8875 registrados en Cisco BroadWorks. Lea este artículo para conocer los objetos XML admitidos, los URI y los pasos para configurar los servicios 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 las aplicaciones y el sistema telefónico. Puede agregar sus propios servicios XSI a su teléfono utilizando 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 . Cisco XML Services es el nombre predeterminado. También puede cambiar el nombre. Para proporcionar un acceso fácil a los usuarios, puede agregar las aplicaciones XML a teclas de función o teclas de línea.
Las características soportadas son:
- Mensajes (imágenes y texto)
- Paginación
Objetos XML admitidos
-
Menú de Cisco IPPhone
-
Texto del teléfono Cisco
-
Entrada de teléfono Cisco IP
-
Directorio de teléfonos Cisco IP
-
Imagen del iPhone Cisco
-
Archivo de imagen de Cisco IPPHONE
-
Menú de Icono de Cisco IPPhone
-
Menú de archivo de Icono de Cisco IPPhone
-
Cisco IPPhoneSTATU (excepto 9811 y 9841)
-
Archivo de Estado de Cisco IPPhone (excepto 9811 y 9841)
-
Cisco IPPhoneExecute
URI soportados
-
Dispositivo
-
Marque
-
EditarDail
-
Init
-
Clave
-
Reproducir (solo tonos de llamada)
-
Softkey
Para obtener más detalles sobre la configuración del servicio XSI, consulte las Notas de desarrollo de aplicaciones de Cisco Unified IP Phone Services.
Configurar un teléfono para conectarse a un servicio XML
| 1 |
Acceda a la página web de administración telefónica. |
| 2 |
Seleccione . |
| 3 |
En la sección Servicio XML, configure los parámetros Nombre del servicio de aplicación XML y URL del servicio de aplicación XML tal como se definen en Parámetros para servicios XML. |
| 4 |
(Opcional) Para agregar autenticación para acceder al servicio de aplicaciones, configure estos campos: Nombre de usuario XML, Contraseña XML, CISCO XML EXE Enable y modo de autenticación CISCO XML EXE. |
| 5 |
Haga clic en Guardar todos los cambios. |
Parámetros para los servicios XML
La siguiente tabla define la función y el uso de los parámetros de la aplicación XML en la sección Servicio XML en la ficha en la interfaz web del teléfono. También 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 configurar un parámetro.
|
Parámetro |
Predeterminado y opciones |
Descripción |
|---|---|---|
|
Nombre del servicio de aplicación XML |
Predeterminado: Vacío |
Nombre de la aplicación XML. El nombre aparece en el teléfono como una 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) introduciendo una cadena en este formato: |
|
URL del servicio de aplicación XML |
Predeterminado: Vacío |
La dirección 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) introduciendo una cadena en este formato: Las variables de macro son compatibles con las URL XML. Para obtener información sobre las variables de macro válidas, consulte Variables de macro admitidas en las direcciones URL XML. Sólo los protocolos HTTP o HTTPS son compatibles en la URL. |
|
Nombre de usuario XML |
Predeterminado: Vacío |
Nombre de usuario del servicio XML para fines de autenticación. También puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) introduciendo una cadena en este formato: |
|
Contraseña XML |
Predeterminado: Vacío |
Contraseña de servicio XML para el nombre de usuario XML especificado. La contraseña que ingresó en este campo se muestra en el archivo de configuración (cfg.xml) de la siguiente manera: |
|
Habilitar CISCO XML EXE |
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) introduciendo una cadena en este formato: |
|
Modo de Authth CISCO XML EXE |
Predeterminado: Credencial local Opciones: Credencial local de confianza, credencial remota |
Especifica el modo de autenticación para Cisco XML EXE.
También puede configurar este parámetro en el archivo XML de configuración del teléfono (cfg.xml) introduciendo una cadena en este formato: |
Agregar una aplicación XML a una tecla de software
Agregue las aplicaciones de uso frecuente a las teclas de acceso rápido para que los usuarios accedan al servicio fácilmente.
Antes de comenzar
El servicio de aplicaciones XML se ha configurado correctamente.
| 1 |
Acceda a la página web de administración telefónica. |
| 2 |
Seleccione . |
| 3 |
En la sección Teclas programables, establezca Activar la tecla programable de teclas programables en Sí. También puede configurar este parámetro en el archivo de configuración (cfg.xml). Escriba una cadena en 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
Ejemplo
También puede configurar este parámetro en el archivo de configuración (cfg.xml). Escriba una cadena en este formato:
donde n es el número de llave blanda. |
| 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 claves de línea para que los usuarios puedan acceder fácilmente a los servicios.
Antes de comenzar
El servicio de aplicaciones XML se ha configurado correctamente.
| 1 |
Acceda a la página web de administración telefónica. |
| 2 |
Seleccione . |
| 3 |
Seleccione una clave de línea. |
| 4 |
Establezca el parámetro Extensión en Deshabilitado para deshabilitar la extensión. Si la función Configuración directa de PLK está deshabilitada, debe deshabilitar la extensión para agregar una función extendida a la tecla de línea. Si la función está habilitada, puede omitir este paso. Para obtener más información, consulte Habilitar la configuración de PLK directa. |
| 5 |
En el parámetro Función extendida, escriba una cadena en este formato: fnc=xml;url=<xml_app_path>;nme=<app_name>
donde
Ejemplo
También puede configurar este parámetro en el archivo de configuración (cfg.xml). Escriba una cadena en este formato:
donde n es el número de extensión. |
| 6 |
Haga clic en Guardar todos los cambios. |
Variables de macro admitidas en URL XML
Puede usar variables de macro en direcciones URL XML. Se admiten las siguientes variables de macro:
-
ID de usuario: UID1, UID2 a UIDN
-
Nombre para mostrar: displayName1, DISPLAYNAME2 a DisplayName
-
ID de autenticación: AUTHID1, AUTHID2 a authIDN
-
Proxy: Proxy1, PROXY2 a ProxyN
-
Dirección MAC usando dígitos hexamales en minúscula: MA
-
Nombre del producto—PN
-
Número de serie de producto—PSN
-
Número de serie: número de serie
| Nombre de la macro | Expansión macro |
|---|---|
| $ | El formulario $$ se expande a un solo carácter $. |
| A a P | Reemplazado por parámetros de uso general GPP_A a GPP_P. |
| SA a SD | Reemplazado por parámetros de propósito especial GPP_SA a 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 con dígitos hexademinúscula (000e08aabbcc). |
| MAU | Dirección MAC con dígitos hexadecimales en mayúsculas (000E08AABBCC). |
| MAC | Dirección MAC que utiliza dígitos hexápdices minúsculas con dos puntos para separar pares de dígitos hexáctimas (00:0 e:08:aa:bb:cc). |
| PN | Nombre del producto; por ejemplo, teléfono de video 8875, teléfono de escritorio 9851. |
| PSN | Número de serie del producto; por ejemplo, 8875, 9841, 9861 |
| SN | Cadena de número de serie; por ejemplo, 88012BA01234. |
| CCERT | Estado del certificado de cliente SSL, instalado o no instalado. |
| IP | Dirección IP del teléfono dentro de su subred local; por ejemplo, 192.168.1.100. |
| EXTIP | IP externa del teléfono, como se ve en Internet; por ejemplo, 66.43.16.52. |
|
SWVER |
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 explícita de resincronización 0 = resincronización de encendido 1 = resincronización periódica 2 = error de resincronización, intento de reintento |
|
UPGST |
Estado de actualización (una cadena numérica): 1 = primer intento de actualización 2 = error de actualización, intento de reintento |
|
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. |
|
UPGCOND |
Nombre de macro heredado. |
|
SCHEME |
Esquema de acceso a archivos, uno de TFTP, HTTP o HTTPS, según se obtiene después de analizar la URL de resincronización o actualización. |
|
SERV |
Solicite el nombre de host del servidor de destino, tal como se obtiene después de analizar la URL de resincronización o actualización. |
|
SERVIP |
Solicite la dirección IP del servidor de destino, tal como se obtiene después de analizar la URL de resincronización o actualización, posiblemente después de la búsqueda de DNS. |
|
PORT |
Solicite el puerto UDP/TCP de destino, tal como se obtiene después de analizar la URL de resincronización o actualización. |
|
PATH |
Solicite la ruta del archivo de destino, tal como se obtiene después de analizar la URL de resincronización o actualización. |
|
ERR |
Mensaje de resultado de intento de resincronización o actualización. Únicamente útil para generar mensajes de syslog de resultados. El valor se conserva en la variable UPGERR en el caso de intentos de actualización. |
|
IdN |
El contenido del parámetro de configuración Line n UserID. |
| ISCUST |
Si la unidad está personalizada, valor = 1, de lo contrario 0. El estado de personalización se puede ver en la página de información de la interfaz de usuario web. |
| INCOMINGNAME | Nombre asociado con la primera llamada conectada, sonando o entrante. |
| REMOTENUMBER |
Número de teléfono de la primera llamada conectada, sonando o entrante. Si hay varias llamadas, se proporcionan los datos asociados con la primera llamada encontrada. |
| Nombre de pantalla | El contenido del parámetro de configuración Nombre de visualización de la línea N. |
| AuthIDN | El contenido del parámetro de configuración de ID de auth de línea N. |
