Revisar e solucionar erros de importação de registros

Durante o processamento de um arquivo, o painel flutuante Importar dados soma o contador de Erros junto aos demais — veja Ver e analisar importações anteriores para o que o painel completo mostra. Se houver erros, aparece um link “Ver erros (N) →” ao lado da contagem.

O Registro de erros

Esse link abre o diálogo Registro de erros, com:

• Um campo para filtrar por linha ou mensagem.
• Um botão Baixar registro de erros.
• A lista numerada de erros, cada um com sua mensagem.

Se você enviar uma linha cujo stage não corresponde a nenhuma etapa existente — por exemplo NotARealStage12345 —, o erro é “Documento no encontrado por la llave primaria ‘NotARealStage12345’ en ‘stage’”. Essa mensagem aparece sempre em espanhol, qualquer que seja o idioma da conta: o diálogo ao redor (título, campo de filtro, botão) se traduz, o texto do erro não. Em português seria algo como “Documento não encontrado pela chave primária ‘NotARealStage12345’ em ‘stage’”. Algumas colunas — como stage — não são texto livre: são referências a um registro existente, e a importação falha linha por linha quando o valor não corresponde a nenhum.

O que gera erro e o que não gera

• Uma linha completamente vazia (sem nenhum valor em nenhuma coluna) não é importada nem contada como erro: o sistema a ignora silenciosamente.
• Uma linha com um valor de stage inexistente gera o erro acima.
• Um e-mail com um espaço no início — o tipo que um copiar-colar ou uma exportação do Excel costuma deixar — é importado como um contato novo, mesmo parecendo idêntico a um que já existe. O pareamento por e-mail não corta espaços em branco, embora ignore maiúsculas (veja Formatar arquivos de importação). Se depois de importar você ver um contato duplicado inesperado, suspeite primeiro de um espaço invisível nessa coluna.

Um e-mail com formato inválido (por exemplo not-an-email, sem @ nem domínio), por outro lado, é importado sem nenhum erro ou aviso.

Com muitos erros de uma vez

Com um arquivo de 30 linhas, todas com o mesmo valor de stage inexistente, a importação termina em 30 / 30 linhas, 100%, 0 importados, 30 erros, e o link aparece como “Ver erros (30) →”.

O diálogo Registro de erros — com o cabeçalho do módulo correspondente, por exemplo Contatos — não pagina nem agrupa as mensagens repetidas: mostra o total («30 erros») e em seguida a lista numerada de 1 a 30, uma entrada por linha, com a mesma mensagem repetida em todas. Percorre-se pela barra de rolagem do próprio diálogo.

Baixar registro de erros entrega um .csv chamado import-errors-<id da importação>.csv, com duas colunas — Row e Error — e uma linha por linha que falhou, com o mesmo texto que aparece na tela:

Row,Error
1,"Documento no encontrado por la llave primaria 'NotARealStage12345' en 'stage'"
2,"Documento no encontrado por la llave primaria 'NotARealStage12345' en 'stage'"

Baixe antes de fechar o painel: não há tela de importações anteriores para recuperá-lo depois — veja Ver e analisar importações anteriores.