Histórico de importações e desfazer

Toda importação por arquivo do painel grava um lote, e esse lote pode ser desfeito. O comportamento é o mesmo em cinco telas — Lojas, Redes, Produtos e Blacklist, no grupo Cadastros, e a aba Posições da campanha — e por isso vale um artigo só.

O histórico de importações fica abaixo da listagem da própria tela, não em um lugar separado do menu.

O arquivo

O botão "Importar arquivo" abre o formulário de importação. O arquivo é de texto ou CSV, um registro por linha, com as colunas separadas por ponto e vírgula ou vírgula. Vale o CSV salvo pelo Excel, Google Sheets ou LibreOffice, em UTF-8 ou na codificação padrão do Excel. Nas telas do grupo Cadastros, a própria tela informa o limite de 5 MB e 50.000 linhas.

O cabeçalho é opcional: se a primeira linha trouxer os nomes das colunas, ela é ignorada. O botão "Baixar modelo" entrega o CSV com o cabeçalho e uma linha de exemplo, que pode ficar no arquivo — a importação a reconhece e ignora.

Durante o processamento a tela pede para não ser fechada até a importação terminar.

O lote

A importação que grava ao menos um registro gera um lote, e só os registros gravados são dele. O que foi ignorado porque já existia nunca sai pelo desfazer: ele não é do lote. Importação que não gravou nada não entra no histórico.

O histórico

O histórico lista os lotes do mais recente para o mais antigo, com a data e a hora, quem importou, o nome do arquivo, as contagens do relatório da importação e quantos registros do lote existem agora — que é o número que o desfazer removeria. Nas posições o histórico traz também o prêmio, a rede e quantas são premiadas e não premiadas.

Lote já desfeito continua na lista, com o selo "Desfeita", quem desfez e quando.

O arquivo em si não é guardado, só o nome.

O relatório da importação

O relatório não é sucesso ou falha. Ele traz as linhas no arquivo, quantas foram importadas, quantas foram ignoradas (já cadastradas ou repetidas), as linhas não importadas com o número e o motivo, e os avisos. Importação é parcial: entra o que está certo e cada linha recusada vem na lista, com o número da linha.

Os avisos são separados dos erros: eles trazem o que foi deixado de lado sem ser erro e não entram em nenhuma contagem. O exemplo mais comum é o registro inativo que não foi reativado.

Na importação de produtos o relatório traz também quantos entraram pelo EAN e quantos pelo código.

Desfazer: tudo ou nada

O botão "Desfazer" abre uma confirmação que diz quantos registros serão removidos — inclusive os editados depois da importação, que continuam sendo do lote — e lembra que os que já estavam cadastrados antes do arquivo ficam.

O desfazer é tudo ou nada. Se algum registro do lote já estiver em uso, nada é removido e a mensagem diz quantos impedem. O que conta como uso muda por cadastro:

• Lojas: loja vinculada a campanha ou com nota fiscal impede.
• Redes: rede usada em loja, campanha, prêmio, produto de campanha, posição premiada, nota fiscal, usuário ou outra importação impede. Esta é a única situação em que uma rede é de fato apagada.
• Produtos: produto vinculado a campanha, com item de nota fiscal ou exigido por uma regra de geração com base de produto impede.
• Blacklist: bloqueio vinculado a campanha impede.
• Posições: posição já distribuída ou com participante vinculado impede.

Nas posições, os registros saem de verdade — excluídos, não inativados.

Lote já desfeito também é recusado. Lote de outra campanha não é encontrado.

Depois de importar ou desfazer, a listagem, o resumo e o histórico recarregam.

Importar e desfazer podem levar mais tempo que as outras ações. Se a tela avisar que a operação demorou mais que o esperado, confira no histórico se ela foi concluída antes de tentar de novo.

Permissões

Listar o histórico segue a permissão de ler o cadastro correspondente; desfazer segue a permissão de excluir daquele cadastro.

O desfazer existe para o caso de arquivo errado, e funciona bem enquanto nada do lote foi usado. Quatro orientações:

Desfazer só alcança o que aquele arquivo gravou. Se o arquivo tinha quinhentas linhas e quatrocentas foram ignoradas porque já existiam, o desfazer remove cem — as outras quatrocentas não eram do lote.

Desfazer é tudo ou nada, e vale a pena fazer logo. Se uma única posição do lote já foi distribuída, ou uma única loja já recebeu nota, o lote inteiro deixa de poder ser desfeito e o caminho passa a ser corrigir registro por registro.

O histórico fica abaixo da listagem da própria tela. O cliente não precisa procurar um menu de importações.

O arquivo enviado não é guardado, só o nome dele. Se o cliente precisar reenviar, precisa ter o arquivo.

• Falha: o desfazer foi recusado e nada foi removido.
• Possivel causa: algum registro do lote já está em uso. O desfazer é tudo ou nada.
• Como orientar: a mensagem do servidor diz quantos registros impedem. Nada foi alterado. O caminho passa a ser corrigir ou inativar registro por registro.
• Quando escalar: se nenhum registro do lote estiver em uso e o desfazer continuar sendo recusado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o desfazer removeu menos registros do que o arquivo tinha.
• Possivel causa: as linhas ignoradas porque o registro já existia não são do lote e nunca saem pelo desfazer.
• Como orientar: compare com o relatório da importação. Só o que entrou como importado é do lote. O número que o desfazer remove aparece no próprio histórico.
• Quando escalar: não é falha.

• Falha: a importação não aparece no histórico.
• Possivel causa: ela não gravou nenhum registro. Importação que não grava nada não gera lote.
• Como orientar: confira o relatório da importação. Se tudo foi ignorado ou recusado, não há lote para listar.
• Quando escalar: se o relatório indicar registros importados e o lote não aparecer no histórico, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o arquivo é recusado antes de qualquer linha ser lida.
• Possivel causa: o arquivo passa do limite informado na tela (nos cadastros, 5 MB e 50.000 linhas) ou não é um arquivo de texto ou CSV.
• Como orientar: divida o arquivo em partes menores ou salve de novo como CSV a partir do Excel, Google Sheets ou LibreOffice.
• Quando escalar: se o arquivo estiver dentro dos limites e continuar recusado, abrir issue no Jira (projeto DEV) com as evidências e o arquivo.

• Falha: a importação recusou várias linhas e o cliente não entende o motivo.
• Possivel causa: cada linha recusada vem no relatório com o número da linha e a mensagem do servidor.
• Como orientar: leia as linhas não importadas uma por uma. Corrija o arquivo e reimporte só as linhas corrigidas, se preferir.
• Quando escalar: se a mensagem de erro de linha não explicar o motivo, abrir issue no Jira (projeto DEV) com as evidências e o arquivo.

• Falha: o registro que está no bloco de avisos não entrou e não aparece como erro.
• Possivel causa: avisos trazem o que foi deixado de lado sem ser erro. O caso mais comum é o registro inativo, que não é reativado pela importação.
• Como orientar: localize o registro na listagem e ative manualmente, se ele deve voltar a valer.
• Quando escalar: não é falha.

• Falha: a tela avisou que a importação ou o desfazer demorou mais que o esperado.
• Possivel causa: o arquivo era grande e a operação passou do tempo de espera da tela, mas pode ter sido concluída.
• Como orientar: recarregue a tela e confira o histórico e a listagem antes de repetir a operação.
• Quando escalar: se o histórico não mostrar o resultado e a operação falhar de novo, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: registros editados à mão saíram no desfazer do lote.
• Possivel causa: registro editado depois da importação continua sendo do lote e é removido pelo desfazer. A confirmação avisa isso.
• Como orientar: explique o comportamento e oriente a ler a confirmação antes de desfazer. Os registros precisam ser cadastrados de novo.
• Quando escalar: não é falha.