En este artículo
dropdown icon
Descripción general
    Objetos XML admitidos
    URI admitidas
Configurar un teléfono para conectarse a un servicio XML
Parámetros para los servicios XML
Agregar una aplicación XML a una tecla programada
Agregar una aplicación XML a una clave de línea
Variables de macro admitidas en URL XML
Configuración de aplicaciones

XML para teléfonos 9800 y 8875 (BroadWorks)

list-menuEn este artículo
list-menu¿Comentarios?

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 Configuración > Red y servicios > Cisco XML servicios. 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 Voice (Voz) > Phone (Teléfono).

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 > Teléfono 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.

Tabla 1. Parámetros para los servicios XML

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_Application_Service_Name ua="na">XML Nombre de la aplicación</XML_Application_Service_Name>

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:

<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 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:

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

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:

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

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_EXE_Enable ua="na">Sí</CISCO_XML_EXE_Enable>

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.

  • De confianza: no se realiza ninguna autenticación independientemente de la credencial local.

  • Credencial local: la autenticación se basa en la autenticación implícita que utiliza la credencial local, si está definida. Si no se establece la credencial local, no se realiza ninguna autenticación.

  • Credencial remota: la autenticación se basa en la autenticación implícita utilizando la credencial remota establecida 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 XML de configuración del teléfono (cfg.XML) introduciendo una cadena en este formato:

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

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 Voice (Voz) > Phone (Teléfono).

3

En la sección Teclas programables programables, establezca Activar tecla programable programable en.

También puede configurar este parámetro en el archivo de configuración (cfg.XML). Introduzca una cadena en 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 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 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). Introduzca una cadena en este formato:

<PSK_n ua="na">fnc=XML; url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<código de configuración></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 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 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). Introduzca una cadena en este formato:

<Extended_Function_n_ ua="na">fnc=XML; url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<código de configuración></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 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

Tabla 2. Macros admitidas
Nombre de macroExpansió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).

MAMAC dirección con dígitos hexadecimales minúsculas (000E08AABBCC).
MAUMAC dirección con dígitos hexadecimales en mayúsculas (000E08AABBCC).
MACMAC 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.
IPIP 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.

INCOMINGNAMENombre 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.

DISPLAYNAMEnContenido del parámetro de configuración Nombre de visualización de línea N.
AUTHIDnEl contenido del parámetro de configuración del ID de autenticación de línea N.
¿Ha encontrado este artículo útil?
¿Ha encontrado este artículo útil?