Eseguire il debug del connettore della community

Puoi eseguire il debug del connettore della community in due modi:

  1. Attivazione dei messaggi di errore estesi
  2. Logging dei dati di esecuzione pertinenti

Questa guida illustra come utilizzare in modo efficace queste funzionalità.

Attivazione/disattivazione delle funzionalità di debug

isAdminUser() deve restituire true se l'utente corrente deve visualizzare i messaggi di debug e le analisi dello stack. Se isAdminUser() restituisce false o non è definito e si verifica un errore, l'utente visualizzerà un messaggio di errore generico.

Suggerimenti per il debug

  • Progetta isAdminUser() in modo che restituisca sempre true per gli sviluppatori.
  • Utilizza getEffectiveUser() in combinazione con un elenco di utenti attendibili per aggiungere o rimuovere facilmente gli utenti che devono visualizzare i dettagli completi dell'errore. Questo può essere particolarmente utile se un utente riscontra un errore che ha problemi di riproduzione.
  • Fai un uso liberale di newDebugError() per gli invarianti che devono valorizzare. Ciò può essere utile per limitare i problemi futuri.

Logging di Apps Script

Apps Script fornisce diversi meccanismi per il logging, tra cui Apps Script Logger, Stackdriver Logging e Stackdriver Error Reporting. Puoi anche provare ad accedere a un foglio Google. Il logging proattivo può aiutare a individuare rapidamente la causa dei bug, ma è necessario prestare attenzione a non registrare dati utente sensibili.