Pular para o conteúdo principal

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:

  1. Leia a mensagem de erro

    • Ela indica exatamente qual parte do nome está incorreta
    • Exemplo: "Campo 3 inválido: esperado 2 letras, encontrado 3"
  2. 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
  3. Corrija o nome

    • Clique no campo "Nome do Item"
    • Edite a parte indicada no erro
    • Pressione Enter para validar
  4. 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:

  1. Verifique se o valor que você está digitando é válido
  2. Veja a lista de códigos aceitos (se disponível)
  3. Use um dos valores pré-definidos
  4. 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:

  1. Verifique campos vazios

    • Procure campos com asterisco (*) vazios
    • Role a lista de arquivos
    • Cada arquivo deve ter todos campos obrigatórios preenchidos
  2. Verifique nomes inválidos

    • Procure arquivos com ❌ marca vermelha
    • Corrija os nomes conforme as mensagens de erro
  3. 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:

  1. Veja outros arquivos já cadastrados

    • Abra o quadro do Monday.com
    • Veja valores usados em itens similares
    • Use o mesmo padrão
  2. Consulte a documentação do projeto

    • Pode haver um guia de preenchimento
    • Ou uma lista de códigos/valores padrão
  3. Pergunte ao administrador

    • Ele pode orientar sobre o valor correto
    • Ou pode tornar o campo não obrigatório
  4. 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:

  1. Nome base diferente: O restante do nome não é exatamente igual

    • ABC-ARQ-...ABC-ARQU-...
    • Verifique letra por letra
  2. 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
  3. 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:

  1. Revise manualmente

    • Confirme que é realmente a próxima revisão
    • Verifique se o vínculo sugerido está correto
  2. Corrija se necessário

    • Ajuste o número da revisão
    • Ou altere o vínculo manualmente
  3. 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:

  1. Administrador configurou quadro de arquivos publicados?
  2. Administrador configurou colunas de vínculo e indicador?
  3. Há uma regra de nomenclatura ativa com campo de revisão?

Se falta alguma configuração:

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:

  1. 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
  2. Confirme se deveria enviar

    • Verifique se este tipo de documento é sua responsabilidade
    • Talvez outro colega deva enviar
  3. 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
  4. 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:

  1. NÃO feche a aplicação

    • O upload continua em andamento
    • Fechar interrompe o processo
  2. Seja paciente

    • Sistema processa em lotes de 10 arquivos
    • Arquivos grandes (>500MB) são enviados individualmente
    • Pode levar vários minutos
  3. Acompanhe o progresso

    • Mensagem indica quantos arquivos já foram enviados
    • Exemplo: "Processando 15 de 50 arquivos..."
  4. 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:

  1. Verifique o arquivo

    • Arquivo está corrompido?
    • Consegue abrir o arquivo normalmente?
    • Tamanho está dentro do limite? (Monday.com: até 500MB)
  2. Tente novamente

    • Envie apenas este arquivo
    • Se funcionar, problema foi temporário
    • Se falhar novamente, próximo passo
  3. Verifique a internet

    • Conexão está estável?
    • Teste com outro arquivo menor
    • Se internet estiver instável, aguarde melhorar
  4. 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:

  1. Identifique o que foi enviado

    • Abra o quadro do Monday.com
    • Veja quais itens foram criados
    • Anote os nomes dos arquivos enviados
  2. Prepare nova lista

    • Separe apenas os arquivos que faltaram
    • Não reenvie os que já foram cadastrados
    • Evite criar duplicatas
  3. 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:

  1. Veja detalhes dos erros

    • Clique para expandir a lista de erros
    • Cada erro indica o arquivo e o motivo
  2. Corrija os problemas

    • Para cada arquivo com erro:
      • Leia o motivo específico
      • Corrija conforme indicado
      • Prepare para reenvio
  3. 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:

  1. Não enviar (recomendado)

    • Se for realmente duplicata acidental
    • Remova o arquivo da lista
    • Evita criar itens repetidos
  2. Enviar mesmo assim

    • Se for intencional (ex: arquivo em pastas diferentes)
    • Sistema permite, mas haverá dois itens com mesmo nome
    • Pode dificultar buscas depois
  3. 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:

  1. Use o clique

    • Clique na área de upload
    • Selecione arquivos no diálogo
    • Funciona da mesma forma
  2. Verifique o navegador

    • Chrome, Edge, Firefox: suportam drag and drop
    • Navegadores antigos: podem não suportar
    • Atualize o navegador se possível
  3. 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:

  1. Verifique sua internet

    • Teste abrindo outro site
    • Verifique se Wi-Fi/cabo está conectado
  2. Recarregue a página

    • Pressione F5
    • Ou feche e abra o Monday.com novamente
  3. Aguarde alguns minutos

    • Pode ser instabilidade temporária
    • Segunda da API volta sozinha
  4. Use outra rede

    • Se possível, teste em outra conexão
    • Pode ser bloqueio do firewall da empresa
  5. 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

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!