Uma macro é um pequeno programa executado originalmente no dispositivo de sala, mesa ou board. Uma macro é escrita em JavaScript com suporte para recursos como funções de seta, promessas, classes e assíncrona/espera. Todos os dispositivos de sala, mesa e quadro, exceto macros de suporte SX10.

Uma macro pode registrar comentários de eventos, alterações de configuração e alterações de status no dispositivo. A macro pode ouvir para esses eventos e alterações e usar a API do dispositivo para invocar mais comandos e alterações de configuração. Se você combinar o uso de macros com os painéis de interface de usuário personalizados, você pode aumentar a interface de usuário com funcionalidade local, por exemplo, botões de discagem rápida.

Você precisa de um usuário Admin local para executar com macros que envolvem comandos xAPI no dispositivo.

Para saber mais sobre como criar painéis de interface do usuário personalizados, consulte o artigo de extensões de UI.

Criar e administrar macros

Você pode usar o Editor de macros para criar e administrar macros. O editor está disponível por meio da interface da Web local do dispositivo.

A interface da Web local está disponível diretamente no navegador da Web, para usuários administrativos locais ou por meio da exibição de cliente no Control Hub na área Configurações do dispositivo. No navegador da Web, digite http(s)://<ip do dispositivo ou nome do host> no campo de endereço da URL. Em seguida, insira as credenciais do usuário admin.

Uma vez na interface da Web local, o Editor de macros fica disponível na área de Personalização do lado esquerdo.

Se as macros estiverem desativadas, você terá a opção de Ativar macros quando você tentar iniciar o editor.

Mais informações

Leia o artigo Administração de usuário local e o artigo Configurações avançadas para obter mais informações sobre usuários locais e como acessar a interface da Web.

Saiba mais detalhes sobre as macros e como usar o Editor de macros no Guia de personalização.

Os recursos de aprendizado adicionais estão disponíveis no Editor de macros:

  • Clique em Tutorial para abrir o Tutorial de script de macros Cisco.

  • Clique em Ajuda para localizar uma breve introdução ao usar macros em um dispositivo e alguns exemplos de código para estudo ou uso.

O suporte da Cisco (TAC) não é compatível com a depuração do código de terceiros, incluindo macros. Verifique a Comunidade de Colaboração Cisco para desenvolvedores se precisar de ajuda com macros e código de terceiros. Além disso, existem muitos recursos integradores e para desenvolvedores neste site. Você pode encontrar vários exemplos de codificação de macros aqui.