- Página inicial
- /
- Artigo
Obrigado pelos seus comentários.
configuração de aplicativosXML para os telefones 9800 e 8875 (BroadWorks)
Neste artigo
Comentários?Este artigo da Ajuda aplica-se ao Cisco Desk Phone 9800 Series e Cisco Video Phone 8875 que estão registrados no Cisco BroadWorks. Leia este artigo para os XML objetos, URIs e as etapas para configurar os serviços XSI na página da Web do telefone.
Visão geral
A XML Services Interface (XSI) é um protocolo que permite comunicação entre aplicativos e o sistema do telefone. Você pode adicionar seus próprios serviços XSI ao telefone usando os XML objetos e URIs compatíveis.
Depois de inscrever o telefone nos serviços, os usuários podem acessar todos os serviços configurados no telefone navegando por . Cisco XML serviços é o nome padrão. Você também pode alterar o nome. Para fornecer um acesso fácil aos usuários, você pode adicionar os aplicativos XML a teclas de função ou teclas de linha.
Os recursos suportados são:
- Mensagens (imagens e texto)
- Paginação
XML objetos compatíveis
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
Inc. CiscoIPPhone
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
Arquivo de imagem do CiscoIPPhone
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (exceto 9811 e 9841)
-
CiscoIPPhoneStatusFile (exceto 9811 e 9841)
-
CiscoIPPhoneExecute
URIs suportadas
-
Dispositivo
-
Discar
-
EditarDail
-
Init
-
Chave
-
Reproduzir (apenas toques)
-
Tecla de função
Para obter mais detalhes sobre a configuração de serviço XSI, consulte Cisco Unified IP Phone Notas de Desenvolvimento de Aplicativo de Serviços.
Configurar um telefone para se conectar a um serviço XML
| 1 |
Acesse a página da Web de administração do telefone. |
| 2 |
Selecione . |
| 3 |
Na seção Serviço XML, configure os parâmetrosXML Application Service Name e XML Application Service, conforme definido nos Parâmetros para serviços XML. |
| 4 |
(Opcional) Para adicionar autenticação para acessar o serviço de aplicativo, configure estes campos: XML Nome de usuário, XML Senha, Cisco XML ATIVAr EXE e Cisco XML Modo Auth EXE. |
| 5 |
Clique em Salvar todas as alterações. |
Parâmetros dos serviços XML
A tabela a seguir define a função e o uso dos parâmetros do aplicativo XML na seção Serviço XML sob o #da interface da Web do telefone. Ela também define a sintaxe da string que é adicionada ao arquivo de configuração do telefone (cfg.xml) com o código XML para configurar um parâmetro.
|
Parâmetro |
Padrão e opções |
Descrição |
|---|---|---|
|
XML Nome do serviço de aplicativos |
Padrão: vazio |
Nome do aplicativo XML. O nome é exibido no telefone como uma escolha de aplicativo Web. Você também pode configurar esse parâmetro no arquivo de configuração XML do telefone (cfg.XML) inserindo uma cadeia de caracteres neste formato: |
|
URL do XML Application Service |
Padrão: vazio |
A URL em que a aplicação XML está localizada. Você também pode configurar esse parâmetro no arquivo de configuração XML do telefone (cfg.XML) inserindo uma cadeia de caracteres neste formato: As variáveis de macro são suportadas em URLs do XML. Para as variáveis de macro válidas, consulte as variáveis de macro suportadas em XML URLs. Somente os protocolos HTTP ou HTTPs são suportados na URL. |
|
XML nome de usuário |
Padrão: vazio |
XML nome de usuário do serviço para fins de autenticação. Você também pode configurar esse parâmetro no arquivo de configuração XML do telefone (cfg.XML) inserindo uma cadeia de caracteres neste formato: |
|
Senha XML |
Padrão: vazio |
XML senha do serviço para o nome de usuário XML especificado. A senha inserida nesse campo aparece no arquivo de configuração (cfg.XML) como a seguir: |
|
Ativar Cisco XML EXE |
Padrão: No Opções: Sim, Não |
Especifica se a autenticação é necessária para acessar o servidor de aplicativos XML. Você também pode configurar esse parâmetro no arquivo de configuração XML do telefone (cfg.XML) inserindo uma cadeia de caracteres neste formato: |
|
Modo Auth Cisco XML EXE |
Padrão: Credencial local Opções: confiável, Credencial local, Credencial remota |
Especifica o modo de autenticação do Cisco XML EXE.
Você também pode configurar esse parâmetro no arquivo de configuração XML do telefone (cfg.XML) inserindo uma cadeia de caracteres neste formato: |
Adicionar um aplicativo XML a uma tecla de função
Adicione os aplicativos usados com frequência a teclas de função para que os usuários acessem o serviço facilmente.
Antes de começar
O XML Application Service foi devidamente configurado.
| 1 |
Acesse a página da Web de administração do telefone. |
| 2 |
Selecione . |
| 3 |
Na seção Teclas de função programáveis, defina a tecla de função programável Ativar para Sim. Você também pode configurar esse parâmetro no arquivo de configuração (cfg.XML). Insira uma cadeia de caracteres nesse formato: |
| 4 |
Na seção Teclas de função programáveis, edite os campos disponíveis de PSK1 para PSK16 neste formato: fnc=XML; url=<xml_app_path>; nme=<app_name>
onde
Exemplo Você também pode configurar esse parâmetro no arquivo de configuração (cfg.XML). Insira uma cadeia de caracteres nesse formato:
onde n é o número da tecla de função. |
| 5 |
Clique em Salvar todas as alterações. |
Adicionar um aplicativo XML a uma tecla de linha
Adicione os aplicativos usados com frequência às chaves de linha para que os usuários acessem os serviços facilmente.
Antes de começar
O XML Application Service foi devidamente configurado.
| 1 |
Acesse a página da Web de administração do telefone. |
| 2 |
Selecione . |
| 3 |
Selecione uma tecla de linha. |
| 4 |
Defina o parâmetro Ramal como Desabilitado para desabilitar o ramal. Se o recurso de Configuração de PLK direta estiver desativado, você deverá desativar o ramal para adicionar uma função ampliada à tecla de linha. Se o recurso estiver habilitado, você poderá ignorar esta etapa. Para obter detalhes, consulte a configuração de Ativar PLK direta. |
| 5 |
No parâmetro Função estendida, insira uma string neste formato: fnc=XML; url=<xml_app_path>; nme=<app_name>
onde
Exemplo Você também pode configurar esse parâmetro no arquivo de configuração (cfg.XML). Insira uma cadeia de caracteres nesse formato:
onde n é o número do ramal. |
| 6 |
Clique em Salvar todas as alterações. |
Variáveis de macro suportadas em URLs do XML
Você pode usar variáveis de macro em URLs do XML. São suportadas as variáveis de macro a seguir:
-
ID de usuário — UID1, UID2 a UIDn
-
Nome de exibição — DISPLAYNAME1, DISPLAYNAME2 a DISPLAYNAMEn
-
ID da auth — AUTHID1, AUTHID2 para AUTHIDn
-
Proxy — PROXY1, PROXY2 a PROXYn
-
MAC Endereço usando dígitos hex minúsculas— MA
-
Nome do produto — PN
-
Número de série de produtos — UM DESEMP.
-
Número de série — SERIAL_NUMBER
| Nome da macro | Expansão de macro |
|---|---|
| $ | O formulário $$ expande para um único caractere de $. |
| A a P | Substituídos por parâmetros de uso geral GPP_A por meio de GPP_P. |
| SA a SD | Substituído por parâmetros de finalidade especial GPP_SA a GPP_SD. Esses parâmetros contêm chaves ou senhas usadas em provisionamento. $SA a $SD são reconhecidos como argumentos para o qualificador de URL de ressincronização opcional, --key. |
| MA | MAC endereço usando os dígitos hex de letra minúscula (000e08abbcc). |
| MAU | MAC endereço utilizando dígitos hex maiúsculos (000E08ABBCC). |
| MAC | MAC endereço usando dígitos hex minúsculas com dois-pontos para separar os pares de dígitos hex (00:0e:08:AA:bb:cc). |
| PN | Nome do produto; por exemplo, Telefone de vídeo 8875, Telefone de mesa 9851. |
| PSN | Número da série de produtos; por exemplo, 8875, 9841, 9861 |
| SN | Cadeia de caracteres do número de série; por exemplo, 88012BA01234. |
| CCERT | SSL status do Certificado do Cliente, instalado ou não instalado. |
| IP | IP endereço do telefone dentro de sua sub-rede local; por exemplo, 192.168.1.100. |
| EXTIP | IP externas do telefone, conforme visto na internet; por exemplo, 66.43.16.52. |
|
SWVER |
String de versão do software. Por exemplo: PHONEOS.3-2-1-0104-37 |
|
HWVER |
String de versão do hardware. Por exemplo, 2.0.1 |
|
PRVST |
Estado de provisionamento (uma string numérica): -1 = Solicitação de ressincronização explícita 0 = Ressincronização de inicialização 1 = Ressincronização periódica 2 = falha na ressincronização. tente novamente |
|
UPGST |
Estado da atualização (uma string numérica): 1 = Primeira tentativa de atualização 2 = Falha na atualização, tente novamente |
|
UPGERR |
Mensagem de resultado (ERR) da tentativa de atualização anterior; por exemplo http_get falhou. |
|
PRVTMR |
Segundos desde a última tentativa de ressincronização. |
|
UPGTMR |
Segundos desde a última tentativa de atualização. |
|
REGTMR1 |
Segundos desde que a Linha 1 perdeu o registro com o servidor SIP. |
|
REGTMR2 |
Segundos desde que a Linha 2 perdeu o registro com o servidor SIP. |
|
UPGCOND |
Nome da macro herdada. |
|
SCHEME |
Esquema de acesso a arquivo, um de TFTP, HTTP ou HTTPS, conforme obtido após a análise da nova sincronização ou da atualização da URL. |
|
SERV |
Nome do host do servidor de destino da solicitação, conforme obtido após a análise da URL de ressincronização ou atualização. |
|
SERVIP |
Endereço IP do servidor de destino da solicitação, conforme obtido após a análise da nova sincronização ou atualização da URL, possivelmente seguindo a pesquisa DNS. |
|
PORTA |
Porta UDP/TCP de destino da solicitação, conforme obtido após a análise da nova sincronização ou da atualização da URL. |
|
CAMINHO |
Caminho do arquivo de destino da solicitação, conforme obtido após a análise da nova sincronização ou da atualização do URL. |
|
ERR |
Mensagem de resultado da tentativa de ressincronização ou atualização. Útil apenas para gerar mensagens syslog de resultado. O valor é preservado na variável UPGERR no caso de tentativas de atualização. |
|
UIDn |
O conteúdo do parâmetro de configuração UserID da Linha n. |
| ISCUST |
Se a unidade for personalizada, valor=1, caso contrário, 0. O status de personalização pode ser visualizado na página de Informações da UI da Web. |
| NOME DE ENTRADA | Nome associado à primeira chamada conectada, tocando ou recebida. |
| NÚMERO REMOTO |
O número de telefone da primeira chamada conectada, tocando ou recebida. Se houver várias chamadas, os dados associados à primeira chamada encontrados serão fornecidos. |
| NOME DE EXIBIÇÃO | O conteúdo do parâmetro de configuração de nome de exibição da Linha N. |
| AUTHIDn | O conteúdo do parâmetro de configuração do Auth ID da Linha N. |
