Pular para o conteúdo principal

Perguntas Frequentes (FAQ)

1. Como a ferramenta encontra as variáveis no documento?​

As variáveis devem estar no formato {{nome_da_variavel}} no documento modelo. A ferramenta as detecta automaticamente e substitui pelos valores correspondentes na planilha.

2. Onde são armazenadas as configurações da ferramenta?​

As configurações ficam no serviço de propriedades do Google Apps Script, garantindo que os dados sejam protegidos.

3. O que fazer se uma variável não for substituída corretamente?​

  • Verifique o nome da variável: O nome no documento modelo deve corresponder exatamente ao nome na planilha.
  • Confira os dados na planilha: Certifique-se de que a coluna associada à variável contém valores válidos.
  • Evite caracteres especiais: Não utilize símbolos como ?, !, @ ou espaços dentro das variáveis.

4. Como posso verificar se um documento foi gerado com sucesso?​

A ferramenta atualiza automaticamente a planilha com colunas de status para facilitar o acompanhamento do processo. As colunas incluem:

  • Documento Criado ✅ → Marcado quando o documento é gerado com sucesso.
  • E-mail Enviado ✅ → Indica que o e-mail foi enviado corretamente.
  • Abrir Documento 🔗 → Exibe o link direto para acessar o documento gerado.
  • Caso algum campo não esteja preenchido, verifique os logs para identificar possíveis erros.

5. E se ocorrer um erro durante o processo?​

A ferramenta registra erros em um arquivo de log. Consulte-o para detalhes do erro. A função registrarErro captura as informações para depuração.

Solução de Problemas​

Como verificar os logs e depurar erros?​

Caso ocorra um erro inesperado, siga os passos abaixo para acessar os logs e entender a causa do problema:

1. Acesse o Editor de Scripts no Google Planilhas:​

  • Clique em Extensões → Apps Script.

2. Abra os registros de execução:​

  • No menu lateral esquerdo, clique em Registros da Execução.

3. Analise os logs:​

  • Identifique mensagens de erro e veja quais funções estavam sendo executadas no momento da falha.

4. Localize o arquivo de logs no Google Drive:​

  • Se configurado, os logs são armazenados dentro da pasta definida pelo usuário.
  • Caso contrário, os registros estarão no Drive, dentro da pasta:
  • 📂 Logs_Leo_Docs/log_erros_dia-mês-ano.log

Exemplo de erro nos registros:​

log_erros_dia-mês-ano.log
=========== ERROR DETECTED ===========
* Date and Time: 2025-02-18T17:53:28.087Z
* Function: criarDocumentos / criarDocumentosParaLinha 
* Custom Message: -----
* Original Error: "Nome do Arquivo" não encontrado. Verifique a configuração.
* Stack Trace: Error: "Nome do Arquivo" não encontrado. Verifique a configuração.
    at Object.criarDocumentosParaLinha (documento:13:24)
    at Object.criarDocumentos (main:30:26)
    at criarDocumentos (Código:3:44)
    at __GS_INTERNAL_top_function_call__.gs:1:8
* Additional Data: {
  "linha": 2
}
======================================

Principais Erros e Soluções​

1. Erro ao gerar o documento​

  • Causa provável: O nome das variáveis no documento modelo não corresponde ao nome das colunas na planilha.
  • Solução: Verifique o mapeamento das variáveis e remova caracteres especiais ou espaços desnecessários.

2. O e-mail não está sendo enviado​

  • Causa provável: O endereço de e-mail na planilha está inválido ou mal formatado.
  • Solução: Confirme que a coluna de e-mail contém endereços corretos e sem erros de digitação.

Se o problema persistir, consulte os logs para obter mais detalhes ou entre em contato através do Discord.