Compartilhar via

Extensão do DevTools do Power Pages

  • Artigo

A extensão do Power Pages para o DevTools do Microsoft Edge é uma ferramenta de desenvolvedor projetada para aprimorar a experiência de desenvolvimento e solução de problemas para criadores e administradores que trabalham em sites do Power Pages. Ela oferece recursos como a exibição de mensagens de rastreamento do Liquid e mensagens de erro do servidor. Com essa ferramenta, criadores e administradores podem identificar, diagnosticar e resolver problemas do ambiente do Power Pages com eficiência. Ao habilitar os recursos de registro e rastreamento em código do Liquid, além de fornecer insights claros sobre cenários de erro, a extensão do Power Pages facilita fluxos de trabalho de desenvolvimento mais tranquilos e melhora a qualidade geral dos sites do Power Pages.

Observação

A extensão da ferramenta para desenvolvedores está disponível atualmente apenas para o Microsoft Edge.

Para trabalhar com as ferramentas para desenvolvedores, você precisa:

  • Instalar a extensão do navegador.
  • Habilitar a configuração de diagnóstico.
  • Revisar o erro do servidor e seguir os detalhes da mitigação.
  • Exibir mensagens de log personalizadas adicionadas usando código do Liquid.

Instalar a extensão DevTools do navegador

Para instalar a extensão do DevTools para Power Pages:

  1. Acesse Extensão do Microsoft Power Pages para Microsoft Edge.
  2. Selecione Obter.

Habilitar a configuração de diagnóstico

Observação

Se o status de visibilidade do site for privado, a configuração de diagnóstico será habilitada por padrão.

Para habilitar a configuração de diagnóstico para um site público:

  1. Abra o Aplicativo Power Pages Management.
  2. Adicione ou atualize a Configuração do Site com o nome UserTrace/Debug.
  3. Defina o valor como true.

Revise as mensagens de erro do servidor

Quando você habilita a configuração de diagnóstico, a plataforma registra todos os erros que ocorrem no servidor. Para capturar essas mensagens de erro do servidor, você precisa:

  1. Abra o navegador da Web do Microsoft Edge.

  2. Navegar até o site do Power Pages.

  3. Abrir as DevTools do navegador.

  4. Selecione a guia Power Pages.

    Captura de tela das DevTools do Microsoft Edge com a guia do Power Pages selecionada.

  5. Reproduza o cenário em que você encontrou o erro.

A ferramenta exibe uma lista de todas as mensagens de erro do servidor com as resoluções prováveis.

Observação

No momento, você pode ver apenas um número limitado de mensagens de erro de falha. No entanto, cada versão subsequente incluirá mensagens de erro adicionais para vários tipos de falhas.

Seguem-se alguns exemplos de mensagens de erro:

  • Erro com o provedor de entrada Local se o atributo LogonEnabled for falso para o contato do Portal.

    Captura de tela das DevTools do Microsoft Edge com a guia do Power Pages selecionada e uma mensagem de erro de exemplo exibida.

  • A pesquisa de entidade externa não está configurada corretamente.

Registrar mensagens personalizadas com o Liquid

Os criadores podem adicionar instruções de log em seu código do Liquid. Quando o site do Power pages está em execução, os logs adicionados pelo criador no código do Liquid são mostrados na extensão da ferramenta do desenvolvedor do Power Pages. Saiba mais em Objetos do Liquid disponíveis.