- Página inicial
- /
- Artigo
Obrigado pelos seus comentários.
Configuração de aplicativos XML para telefones 9800 e 8875 (BroadWorks)
Neste artigo
Comentários?Este artigo de ajuda se aplica ao Cisco Desk Phone 9800 Series e ao Cisco Video Phone 8875 registrados no Cisco BroadWorks. Leia este artigo para conhecer os objetos XML suportados, 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 a comunicação entre aplicativos e o sistema telefônico. Você pode adicionar seus próprios serviços XSI ao seu telefone usando os objetos XML 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 até . Cisco XML services é 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 às teclas programáveis ou teclas de linha.
Os recursos suportados são:
- Mensagens (imagens e texto)
- Paginação
Objetos XML compatíveis
-
Menu de telefone IP Cisco
-
Texto do Cisco IP Phone
-
Entrada de telefone IP Cisco
-
Diretório telefônico IP da Cisco
-
Imagem do telefone IP Cisco
-
Arquivo de imagem do telefone IP Cisco
-
Menu de ícones do Cisco IP Phone
-
Menu de arquivos do ícone do Cisco IP Phone
-
Status do telefone IP Cisco (exceto 9811 e 9841)
-
Arquivo de status do telefone IP Cisco (exceto 9811 e 9841)
-
Cisco IP Phone Execute
URIs compatíveis
-
Dispositivo
-
Mostrador
-
Editar diariamente
-
Iniciar
-
Chave
-
Reproduzir (somente toques)
-
Tecla programável
Para obter mais detalhes sobre a configuração do serviço XSI, consulte Notas de desenvolvimento de aplicativos do Cisco Unified IP Phone Services.
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âmetros Nome do serviço de aplicativo XML e URL do serviço de aplicativo XML conforme definido em Parâmetros para serviços XML. |
| 4 |
(Opcional) Para adicionar autenticação para acessar o serviço do aplicativo, configure estes campos: Nome de usuário XML, Senha XML, Cisco XML EXE Enable e CISCO XML EXE Auth Mode. |
| 5 |
Clique em Salvar todas as alterações. |
Parâmetros para 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 na guia na interface web do telefone. Ele também define a sintaxe da string que é adicionada ao arquivo de configuração do telefone (cfg.xml) com código XML para configurar um parâmetro.
|
Parâmetro |
Padrão e opções |
Descrição |
|---|---|---|
|
Nome do serviço de aplicativo XML |
Padrão: Vazio |
Nome do aplicativo XML. O nome é exibido no telefone como uma opção de aplicativo da web. Você também pode configurar esse parâmetro no arquivo XML de configuração do telefone (cfg.xml) inserindo uma string neste formato: |
|
URL do serviço de aplicativo XML |
Padrão: Vazio |
O URL em que o aplicativo XML está localizado. Você também pode configurar esse parâmetro no arquivo XML de configuração do telefone (cfg.xml) inserindo uma string neste formato: As variáveis de macro são suportadas em URLs XML. Para as variáveis de macro válidas, consulte Variáveis de macro suportadas em URLs XML. Somente protocolos HTTP ou HTTPs são suportados na URL. |
|
Nome de usuário XML |
Padrão: Vazio |
Nome de usuário do serviço XML para fins de autenticação. Você também pode configurar esse parâmetro no arquivo XML de configuração do telefone (cfg.xml) inserindo uma string neste formato: |
|
Senha XML |
Padrão: Vazio |
Senha de serviço XML para o nome de usuário XML especificado. A senha digitada nesse campo é exibida no arquivo de configuração (cfg.xml) da seguinte forma: |
|
Habilitar CISCO XML EXE |
Padrão: Não 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 XML de configuração do telefone (cfg.xml) inserindo uma string neste formato: |
|
Modo de autenticação 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 XML de configuração do telefone (cfg.xml) inserindo uma string neste formato: |
Adicionar um aplicativo XML a uma tecla programável
Adicione os aplicativos usados com frequência às teclas programáveis para que os usuários acessem o serviço com facilidade.
Antes de começar
O XML Application Service foi configurado corretamente.
| 1 |
Acesse a página da web de administração do telefone. |
| 2 |
Selecione . |
| 3 |
Na seção Teclas programáveis, defina a opção Ativar tecla programável como Sim. Você também pode configurar esse parâmetro no arquivo de configuração (cfg.xml). Insira uma string neste formato: |
| 4 |
Na seção Teclas programáveis, edite os campos disponíveis de PSK1 a 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 string neste formato:
onde n é o número da tecla programável. |
| 5 |
Clique em Salvar todas as alterações. |
Adicionar um aplicativo XML a uma chave de linha
Adicione os aplicativos usados com frequência às chaves de linha para que os usuários acessem os serviços com facilidade.
Antes de começar
O XML Application Service foi configurado corretamente.
| 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 Extensão como Desativado para desativar a extensão. Se o recurso de configuração direta de PLK estiver desativado, você deverá desativar a extensão para adicionar uma função estendida à chave de linha. Se o recurso estiver ativado, você poderá pular essa etapa. Para obter detalhes, consulte Habilitar a configuração direta de PLK. |
| 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 string neste formato:
onde n é o número do ramal. |
| 6 |
Clique em Salvar todas as alterações. |
Variáveis de macro suportadas em URLs XML
Você pode usar variáveis de macro em URLs XML. As seguintes variáveis macro são suportadas:
-
ID de usuário — UID1, UID2 a UIDn
-
Nome de exibição — DisplayName1, DISPLAYNAME2 para DisplayNameN
-
ID de autenticação — AUTHID1, AUTHID2 a AuthIDN
-
Proxy — PROXY1, PROXY2 a ProxyN
-
Endereço MAC usando dígitos hexadecimais minúsculos — MA
-
Nome do produto — PN
-
Número de série do produto — PSN
-
Número de série — SERIAL_NUMBER
| Nome da macro | Expansão macro |
|---|---|
| $ | O formulário $$ se expande para um único caractere $. |
| De A a P | Substituídos pelos parâmetros de uso geral GPP_A a GPP_P. |
| SA a SD | Substituídos por parâmetros de propósito especial GPP_SA a GPP_SD. Esses parâmetros
contêm chaves ou senhas usadas no provisionamento. $SA a $SD são reconhecidos como argumentos para o qualificador opcional de URL de ressincronização, --key. |
| MA | Endereço MAC usando dígitos hexadecimais minúsculos (000e08aabbcc). |
| MAU | Endereço MAC usando dígitos hexadecimais maiúsculos (000E08AABBCC). |
| MAC | Endereço MAC usando dígitos hexadecimais minúsculos com dois pontos para separar pares de dígitos hexadecimais (00:0 e:08:aa:bb:cc). |
| PN | Nome do produto; por exemplo, Video Phone 8875, Desk Phone 9851. |
| PSN | Número de série do produto; por exemplo, 8875, 9841, 9861 |
| SN | Cadeia de caracteres do número de série; por exemplo, 88012BA01234. |
| CCERT | Status do certificado de cliente SSL, instalado ou não instalado. |
| IP | Endereço IP do telefone em sua sub-rede local; por exemplo, 192.168.1.100. |
| EXTIP | IP externo do telefone, conforme visto na internet; por exemplo, 66.43.16.52. |
|
SWVER |
Cadeia de caracteres da versão do software Por exemplo, PHONEOS.3-2-1-0104-37 |
|
HWVER |
Sequência de caracteres da versão de hardware Por exemplo, 2.0.1 |
|
PRVST |
Estado de provisionamento (uma sequência numérica): -1 = solicitação explícita de ressincronização 0 = ressincronização de inicialização 1 = ressincronização periódica 2 = falha na ressincronização, tente novamente |
|
UPGST |
Estado da atualização (uma sequência numérica): 1 = primeira tentativa de atualização 2 = falha na atualização, tente novamente |
|
UPGERR |
Mensagem de resultado (ERR) da tentativa anterior de atualização; 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 no servidor SIP. |
|
REGTMR2 |
Segundos desde que a Linha 2 perdeu o registro no servidor SIP. |
|
UPGCOND |
Nome da macro legada. |
|
SCHEME |
Esquema de acesso a arquivos, TFTP, HTTP ou HTTPS, conforme obtido após a análise do URL de ressincronização ou atualização. |
|
SERV |
Solicite o nome do host do servidor de destino, conforme obtido após a análise do URL de ressincronização ou atualização. |
|
SERVIP |
Solicite o endereço IP do servidor de destino, conforme obtido após a análise do URL de ressincronização ou atualização, possivelmente após a pesquisa de DNS. |
|
PORT |
Solicite a porta UDP/TCP de destino, conforme obtida após a análise do URL de ressincronização ou atualização. |
|
PATH |
Solicite o caminho do arquivo de destino, conforme obtido após a análise do URL de ressincronização ou atualização. |
|
ERR |
Mensagem de resultado da tentativa de ressincronização ou atualização. Útil apenas na geração de mensagens de syslog de resultados. O valor é preservado na variável UPGERR no caso de tentativas de atualização. |
|
UIDN |
O conteúdo do parâmetro de configuração Line n UserID. |
| ISCUST |
Se a unidade for personalizada, valor=1, caso contrário, 0. O status da personalização pode ser visualizado na página de informações da interface do usuário da Web. |
| INCOMINGNAME | Nome associado à primeira chamada conectada, tocando ou recebida. |
| REMOTENUMBER |
Número de telefone da primeira chamada conectada, tocando ou recebida. Se houver várias chamadas, os dados associados à primeira chamada encontrada serão fornecidos. |
| Exibir nomes | O conteúdo do parâmetro de configuração Line N Display Name. |
| ID de autenticação | O conteúdo do parâmetro de configuração do ID de autenticação da Linha N. |
