- Inicio
- /
- Artículo
XML para teléfonos 9800 y 8875 (BroadWorks)
Este artículo de Ayuda se aplica a Cisco Teléfono de escritorio serie 9800 y Cisco Teléfono de video 8875 que están registrados en Cisco BroadWorks. Lea este artículo para conocer los objetos XML compatibles, los URI y los pasos para configurar los servicios XSI en la página web del teléfono.
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 a su teléfono utilizando los objetos XML y 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 a . Cisco XML services es el nombre predeterminado. También puede cambiar el nombre. Para proporcionar un fácil acceso a los usuarios, puede agregar las aplicaciones XML a teclas programables o teclas de línea.
Las características admitidas son:
- Mensajes (imágenes y texto)
- Paginación
Objetos XML admitidos
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
Archivo CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (excepto 9811 y 9841)
-
CiscoIPPhoneStatusFile (excepto 9811 y 9841)
-
CiscoIPPhoneExecute
URI admitidas
-
Disp.
-
Marcar
-
EditDail
-
Init
-
Llave
-
Reproducir (solo tonos de llamada)
-
Tecla programable
Para obtener más información sobre la configuración del servicio XSI, consulte Cisco Unified IP Phone Services Application Development Notes.
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 XML Service , configure los parámetros XML Application Service Name y XML Application Service URL como se define en Parameters for XML services. |
| 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 Habilitar EXE y Cisco XML Modo de autenticación EXE. |
| 5 |
Haga clic en Guardar todos los cambios. |
Parámetros para los 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 Voz Tab 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.
|
Parámetro |
Valores predeterminados y opciones |
Descripción |
|---|---|---|
|
XML Nombre del servicio de la aplicación |
Valor predeterminado: Empty (Vacío) |
Nombre de la aplicación XML. El nombre se muestra 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:
|
|
XML URL del servicio de aplicación |
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 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 conocer las variables de macro válidas , consulteVariables de macro admitidas en direcciones URL XML. En la dirección URL solo se admiten protocolos HTTP o HTTP. |
|
XML Nombre de usuario |
Valor predeterminado: Empty (Vacío) |
XML nombre de usuario del servicio 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 |
Valor predeterminado: Empty (Vacío) |
XML contraseña de servicio 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:
|
|
Cisco XML EXE Habilitar |
Valor predeterminado: no Opciones: Sí y 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:
|
|
Cisco XML Modo de autenticación EXE |
Valor predeterminado: Credencial local Opciones: De confianza, Credencial local, 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 programada
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 . |
| 3 |
En la sección Teclas programables programables, establezca Activar tecla programable programable en Sí . También puede configurar este parámetro en el archivo de configuración (cfg.XML). Introduzca una cadena en este formato:
|
| 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
Ejemplo También puede configurar este parámetro en el archivo de configuración (cfg.XML). Introduzca una cadena en este formato:
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 . |
| 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
Ejemplo También puede configurar este parámetro en el archivo de configuración (cfg.XML). Introduzca 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 utilizar variables de macro en las URL XML. Se admiten las siguientes variables de macro:
-
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
-
MAC Dirección con dígitos hexadecimales en minúsculas—MA
-
Nombre del producto: PN
-
Número de serie del producto: PSN
-
Número de serie: SERIAL_NUMBER
| Nombre de macro | Expansión de macros |
|---|---|
| $ | La forma $$ se expande a un solo carácter $. |
| A through P (De A a P) | Reemplazado por parámetros de propósito general GPP_A a 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). |
| MA | MAC dirección con dígitos hexadecimales minúsculas (000E08AABBCC). |
| MAU | MAC dirección con dígitos hexadecimales en mayúsculas (000E08AABBCC). |
| MAC | MAC Dirección usando dígitos hexadecimales 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) | SSL Estado del certificado de cliente, instalado o no instalado. |
| IP | IP dirección del teléfono dentro de su subred local; por ejemplo, 192.168.1.100. |
| EXTIP (IPEXT) | IP externos del teléfono, 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 está 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 asociado a la primera llamada conectada, sonora o entrante. |
| NÚMERO REMOTO |
Número de teléfono de la primera llamada conectada, sonora o entrante. Si hay varias llamadas, se proporcionan los datos asociados con la primera llamada encontrada. |
| DISPLAYNAMEn | Contenido del parámetro de configuración Nombre de visualización de línea N. |
| AUTHIDn | El contenido del parámetro de configuración del ID de autenticación de línea N. |