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 você quiser que o usuário atual receba mensagens de depuração e rastreamentos de pilha. Se isAdminUser() retornar "false" 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 permissões contendo e-mails de usuários confiáveis para facilitar a adição ou remoção das pessoas que verão os detalhes completos 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 criação de registros, incluindo o Apps Script Logger integrado, o Stackdriver Logging e o Stackdriver Error Reporting. Você também pode tentar criar um registro em uma Planilha Google. O registro proativo ajuda a restringir a causa dos bugs com rapidez, embora seja necessário tomar cuidado para não registrar dados confidenciais dos usuários.