Depurar seu conector da comunidade

Existem duas maneiras de depurar seu conector da comunidade:

  1. Ativar mensagens de erro estendidas
  2. Registrar dados de execução relevantes

Este guia explica como usar esses recursos com eficiência.

Ativar/desativar recursos de depuração

isAdminUser() precisará retornar true se o usuário atual precisar receber mensagens de depuração e stack traces. Se isAdminUser() retornar falso ou não estiver definido e ocorrer um erro, o usuário verá uma mensagem de erro genérica.

Dicas de depuração

  • Crie o valor isAdminUser() de modo que ele sempre retorne true para os desenvolvedores.
  • Use getEffectiveUser() com uma lista de e-mails seguros de usuários confiáveis para adicionar ou remover facilmente as pessoas que verão todos os detalhes do erro. Isso é especialmente útil para os casos em que um usuário encontra um erro difícil de reproduzir.
  • Faça uso livre de newDebugError() para as invariantes que devem retornar "true". Isso ajuda a reduzir os problemas no futuro.

Registro do Apps Script

O Apps Script fornece mecanismos diferentes para geração de registros, incluindo o Apps Script Logger integrado, o Cloud Logging e o Cloud Error Reporting. Você também pode tentar criar um registro em uma Planilha Google. A geração de registros proativa pode ajudar a limitar rapidamente a causa dos bugs, mas tome cuidado para não registrar dados confidenciais do usuário.