- Inicio
- /
- Artículo
XML para teléfonos en BroadWorks
Este artículo de Ayuda se aplica a Cisco Desk Phone 9800 Series y Cisco Video Phone 8875 que están registrados en Cisco BroadWorks. Lea este artículo para conocer los objetos de XML admitidos, 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 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
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 . |
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 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 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 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:
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 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:
|
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 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.
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:
|
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 . |
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:
|
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). Ingrese una cadena con 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). Ingrese una cadena con 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 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)
Nombre de macro | Expansió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). |
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) | 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. |
IP | Direcció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). |
AUTHIDn | El contenido del parámetro de configuración Line N auth ID (Autenticación de ID de línea N). |