Solução de Problemas
Esta página contém soluções para os problemas mais comuns ao usar o módulo de Upload.
Problemas com Nomenclatura
Arquivo com nome inválido
Sintoma: Arquivo aparece com marca vermelha e mensagem de erro.
Causa: O nome não atende a nenhuma das regras de nomenclatura configuradas.
Soluções:
-
Leia a mensagem de erro
- Ela indica exatamente qual parte do nome está incorreta
- Exemplo: "Campo 3 inválido: esperado 2 letras, encontrado 3"
-
Identifique o padrão esperado
- Consulte a documentação do projeto
- Ou pergunte ao administrador qual o padrão
- Ou veja exemplos de arquivos válidos já cadastrados
-
Corrija o nome
- Clique no campo "Nome do Item"
- Edite a parte indicada no erro
- Pressione Enter para validar
-
Aguarde validação
- O sistema revalida automaticamente
- Quando aparecer marca verde, está correto
Exemplo:
- Erro: "Campo Disciplina: esperado 3 caracteres, encontrado 2"
- Nome atual: ABC-AR-EX-0001-PLA-TERR-R00.dwg
- Nome correto: ABC-ARQ-EX-0001-PLA-TERR-R00.dwg
- Corrija: "AR" para "ARQ"
Nenhuma regra de nomenclatura configurada
Sintoma: Todos os arquivos são aceitos, independente do nome.
Causa: O quadro não possui regras de nomenclatura ativas.
Impacto:
- Você pode enviar qualquer arquivo
- Não há controle de revisões
- Não há preenchimento automático
Solução:
- Se você é administrador: Configure regras em Configuração
- Se você é usuário: Solicite ao administrador que configure as regras
Campo de texto livre não aceita valor
Sintoma: Erro ao preencher campo que deveria ser livre.
Causa: O campo possui restrições configuradas no mapeamento.
Solução:
- Verifique se o valor que você está digitando é válido
- Veja a lista de códigos aceitos (se disponível)
- Use um dos valores pré-definidos
- Ou solicite ao administrador que adicione o novo código
Problemas com Campos Obrigatórios
Botão "Iniciar Upload" desabilitado
Sintoma: O botão está cinza e não pode ser clicado.
Causa: Há campos obrigatórios não preenchidos ou arquivos com erro.
Diagnóstico:
-
Verifique campos vazios
- Procure campos com asterisco (*) vazios
- Role a lista de arquivos
- Cada arquivo deve ter todos campos obrigatórios preenchidos
-
Verifique nomes inválidos
- Procure arquivos com ❌ marca vermelha
- Corrija os nomes conforme as mensagens de erro
-
Verifique revisões bloqueadas
- Procure arquivos com status vermelho em revisão
- Corrija os números de revisão
Solução passo a passo:
Para cada arquivo na lista:
- Nome válido? (marca verde)
- Não: Corrija o nome
- Sim: Próximo passo
- Todos campos obrigatórios preenchidos? (marcados com *)
- Não: Preencha os campos vazios
- Sim: Próximo passo
- Revisão válida? (verde ou amarelo)
- Não (vermelho): Corrija revisão
- Sim: Arquivo OK
Quando todos os arquivos estiverem OK, o botão é habilitado.
Não sei qual valor colocar em um campo
Sintoma: Campo obrigatório, mas você não sabe o que preencher.
Solução:
-
Veja outros arquivos já cadastrados
- Abra o quadro do Monday.com
- Veja valores usados em itens similares
- Use o mesmo padrão
-
Consulte a documentação do projeto
- Pode haver um guia de preenchimento
- Ou uma lista de códigos/valores padrão
-
Pergunte ao administrador
- Ele pode orientar sobre o valor correto
- Ou pode tornar o campo não obrigatório
-
Use valor genérico temporário
- Exemplo: "A definir", "N/A", "Pendente"
- Atualize depois diretamente no Monday.com
Problemas com Revisões
Revisão bloqueada
Sintoma: Arquivo com status vermelho "Revisão bloqueada" ou "Sequência inválida".
Causa: O número da revisão não segue a sequência correta.
Cenários comuns:
Cenário 1: Revisão regressiva
Problema: Tentando enviar R01 quando R02 já existe.
Solução:
- Verifique se você tem a versão correta do arquivo
- Se for realmente uma revisão mais antiga, considere:
- Cadastrar como documento diferente
- Ou não cadastrar (já foi superada)
- Se deveria ser R03, corrija o nome
Cenário 2: Pulando sequência
Problema: Tentando enviar R03 quando só existe R01.
Solução:
- Verifique se R02 existe no quadro de publicados
- Se R02 foi pulada intencionalmente:
- Crie um item para R02 primeiro (mesmo que vazio)
- Ou ajuste o nome para R02
- Se foi erro de digitação, corrija para R02
Cenário 3: Revisão anterior não encontrada
Problema: Sistema não encontra a versão anterior para vincular.
Possíveis causas:
-
Nome base diferente: O restante do nome não é exatamente igual
ABC-ARQ-...≠ABC-ARQU-...- Verifique letra por letra
-
Arquivo anterior em quadro diferente: A revisão R00 está em outro quadro
- Mova R00 para o quadro de publicados configurado
- Ou cadastre R01 como primeira revisão
-
Primeira revisão real: Não há anterior mesmo
- Use R00 ou R01 conforme padrão do projeto
- Sistema permitirá como primeira revisão
Status "Atenção" em revisão
Sintoma: Arquivo com status amarelo.
Significado: Sistema identificou possível problema, mas não bloqueia.
Ações:
-
Revise manualmente
- Confirme que é realmente a próxima revisão
- Verifique se o vínculo sugerido está correto
-
Corrija se necessário
- Ajuste o número da revisão
- Ou altere o vínculo manualmente
-
Prossiga com cuidado
- Se tiver certeza, pode enviar
- O upload não será bloqueado
Controle de revisão não está funcionando
Sintoma: Sistema não valida revisões ou não sugere vínculos.
Diagnóstico:
Verifique se o controle está ativo:
- Administrador configurou quadro de arquivos publicados?
- Administrador configurou colunas de vínculo e indicador?
- Há uma regra de nomenclatura ativa com campo de revisão?
Se falta alguma configuração:
- Você é admin: Configure em Configuração do Módulo
- Você é usuário: Solicite ao administrador
Se está tudo configurado mas não funciona:
- Recarregue a página (F5)
- Feche e abra o módulo novamente
- Se persistir, contate o suporte
Problemas com Restrições
"Você não tem permissão para este tipo de documento"
Sintoma: Erro ao tentar enviar arquivo com determinado código.
Causa: Administrador configurou restrições e você não está autorizado.
Solução:
-
Verifique se o código está correto
- Pode ser erro de digitação no nome
- Exemplo: "AQR" em vez de "ARQ"
- Corrija o nome se for o caso
-
Confirme se deveria enviar
- Verifique se este tipo de documento é sua responsabilidade
- Talvez outro colega deva enviar
-
Solicite autorização
- Entre em contato com o administrador do quadro
- Explique por que precisa enviar este tipo
- Aguarde ele adicionar você à lista de autorizados
-
Alternativa temporária
- Peça a um colega autorizado para fazer o envio
- Ou ao administrador (que sempre pode enviar tudo)
Nota: Administradores do quadro sempre têm permissão total e ignoram restrições.
Problemas com Upload
Upload não finaliza / Demora muito
Sintoma: Processo de upload fica em andamento por muito tempo.
Causas possíveis:
- Arquivos muito grandes
- Muitos arquivos de uma vez
- Internet lenta ou instável
- Segunda da API do Monday.com (raro)
Solução:
-
NÃO feche a aplicação
- O upload continua em andamento
- Fechar interrompe o processo
-
Seja paciente
- Sistema processa em lotes de 10 arquivos
- Arquivos grandes (>500MB) são enviados individualmente
- Pode levar vários minutos
-
Acompanhe o progresso
- Mensagem indica quantos arquivos já foram enviados
- Exemplo: "Processando 15 de 50 arquivos..."
-
Se demorar muito (>30min)
- Anote quantos arquivos foram concluídos
- Recarregue a página (F5)
- Envie os arquivos restantes em novo upload
- Contate o suporte se continuar lento
"Erro desconhecido ao cadastrar arquivo"
Sintoma: Mensagem genérica de erro após upload.
Causa: Falha na comunicação com Monday.com ou problema no arquivo.
Solução:
-
Verifique o arquivo
- Arquivo está corrompido?
- Consegue abrir o arquivo normalmente?
- Tamanho está dentro do limite? (Monday.com: até 500MB)
-
Tente novamente
- Envie apenas este arquivo
- Se funcionar, problema foi temporário
- Se falhar novamente, próximo passo
-
Verifique a internet
- Conexão está estável?
- Teste com outro arquivo menor
- Se internet estiver instável, aguarde melhorar
-
Contate o suporte
- Se erro persistir após tentativas
- Informe: nome do arquivo, tamanho, horário
- Anexe screenshot do erro se possível
Upload foi interrompido
Sintoma: Upload parou no meio, alguns arquivos foram enviados, outros não.
Causa: Você fechou a aplicação ou internet caiu.
Solução:
-
Identifique o que foi enviado
- Abra o quadro do Monday.com
- Veja quais itens foram criados
- Anote os nomes dos arquivos enviados
-
Prepare nova lista
- Separe apenas os arquivos que faltaram
- Não reenvie os que já foram cadastrados
- Evite criar duplicatas
-
Envie o restante
- Faça novo upload com arquivos pendentes
- Desta vez, mantenha aplicação aberta
- Aguarde conclusão completa
Alguns arquivos falharam, outros tiveram sucesso
Sintoma: Mensagem de conclusão mostra X sucessos e Y erros.
Solução:
-
Veja detalhes dos erros
- Clique para expandir a lista de erros
- Cada erro indica o arquivo e o motivo
-
Corrija os problemas
- Para cada arquivo com erro:
- Leia o motivo específico
- Corrija conforme indicado
- Prepare para reenvio
- Para cada arquivo com erro:
-
Reenvie apenas os que falharam
- Não precisa reenviar os bem-sucedidos
- Faça novo upload só com os corrigidos
Erros comuns:
- "Coluna não encontrada": Administrador removeu/renomeou coluna
- "Valor inválido": Valor não é aceito pela coluna (ex: status inexistente)
- "Permissão negada": Restrição de usuário
Problemas com Duplicatas
"Arquivo já existe no quadro"
Sintoma: Alerta ao adicionar arquivo com nome já cadastrado.
Significado: Já existe um item com este nome no quadro.
Decisões possíveis:
-
Não enviar (recomendado)
- Se for realmente duplicata acidental
- Remova o arquivo da lista
- Evita criar itens repetidos
-
Enviar mesmo assim
- Se for intencional (ex: arquivo em pastas diferentes)
- Sistema permite, mas haverá dois itens com mesmo nome
- Pode dificultar buscas depois
-
Enviar como revisão
- Se for versão atualizada do documento
- Corrija o nome para incluir próximo número de revisão
- Exemplo:
...-R00.dwg→...-R01.dwg
Problemas de Interface
Não consigo arrastar arquivos
Sintoma: Drag and drop não funciona.
Solução:
-
Use o clique
- Clique na área de upload
- Selecione arquivos no diálogo
- Funciona da mesma forma
-
Verifique o navegador
- Chrome, Edge, Firefox: suportam drag and drop
- Navegadores antigos: podem não suportar
- Atualize o navegador se possível
-
Teste com um arquivo só
- Pode ser limite de quantidade
- Tente arrastar poucos por vez
Não vejo o botão de configurações
Sintoma: Não aparece ícone de engrenagem.
Causa: Você não é administrador do quadro.
Solução:
- Apenas proprietários/admins do quadro veem configurações
- Se você precisa configurar algo, solicite ao administrador
- Ou peça que ele te conceda permissão de administrador no quadro
Interface está quebrada no celular
Sintoma: Layout desorganizado em dispositivos móveis.
Causa: Módulo é otimizado para desktop.
Solução:
- Recomendado: Use computador/notebook
- Upload de múltiplos arquivos é mais eficiente no desktop
- Interface mobile tem suporte limitado
Problemas de Rede
"Erro de conexão com Monday.com"
Sintoma: Mensagem de falha de conexão.
Solução:
-
Verifique sua internet
- Teste abrindo outro site
- Verifique se Wi-Fi/cabo está conectado
-
Recarregue a página
- Pressione F5
- Ou feche e abra o Monday.com novamente
-
Aguarde alguns minutos
- Pode ser instabilidade temporária
- Segunda da API volta sozinha
-
Use outra rede
- Se possível, teste em outra conexão
- Pode ser bloqueio do firewall da empresa
-
Contate TI
- Se erro persistir
- Pode haver bloqueio de rede corporativa
Como Obter Ajuda
Se você não encontrou solução aqui:
1. Documente o problema
Antes de pedir ajuda, anote:
- ✅ O que você estava tentando fazer
- ✅ O que aconteceu (mensagem de erro exata)
- ✅ Nome do quadro
- ✅ Nome do arquivo problemático
- ✅ Horário do erro
- ✅ Screenshot (se possível)
2. Tente reproduzir
- Tente fazer a mesma ação novamente
- O erro se repete sempre?
- Acontece com todos os arquivos ou só alguns?
- Outros usuários têm o mesmo problema?
3. Consulte outras páginas da documentação
- Como Usar: Passo a passo completo
- Configuração: Para administradores
- Visão Geral: Conceitos gerais
4. Entre em contato com suporte
Opção 1 - WhatsApp:
- Link: WhatsApp MakePro
- Envie as informações documentadas acima
- Inclua screenshots se possível
Opção 2 - Administrador:
- Entre em contato com o administrador do quadro
- Ele pode ter configuração que resolve
- Ou pode reportar ao suporte técnico
Checklist de Diagnóstico Geral
Use este checklist para diagnosticar problemas antes de pedir ajuda:
Configuração:
- Regras de nomenclatura estão ativas?
- Mapeamentos estão configurados?
- Colunas obrigatórias estão definidas?
- Controle de revisão está ativo (se necessário)?
Arquivo:
- Nome do arquivo segue o padrão?
- Arquivo não está corrompido?
- Tamanho está dentro do limite (até 500MB)?
- Extensão do arquivo é suportada?
Campos:
- Todos campos obrigatórios (*) preenchidos?
- Valores estão no formato correto?
- Não há campos com erro de validação?
Revisão (se aplicável):
- Número de revisão está correto?
- Revisão anterior existe no quadro?
- Nome base é idêntico à versão anterior?
Permissões:
- Você tem permissão para acessar este quadro?
- Você tem permissão para este tipo de documento?
- Não há restrições bloqueando seu usuário?
Conexão:
- Internet está funcionando?
- Monday.com está acessível?
- Não há bloqueios de firewall?
Lembre-se: A maioria dos problemas tem solução simples. Leia as mensagens de erro com atenção - elas geralmente indicam exatamente o que precisa ser corrigido!