CSV: Validação pré-upload

Atualizado por Larson Guimarães

CSV: Validação pré-upload

Durante o processo de upload do CSV para gestão de usuários em massa, ocorrerá uma validação pré-upload para identificar as ações que serão realizadas a partir do arquivo. Durante essa validação o sistema também verificará se existem erros ou dados faltantes no arquivo.

Vale salientar que, essa validação é realizada apenas no arquivo, após o upload, o administrador receberá um e-mail com o resultado de processamento (podendo ter sido com êxito ou não).

Caso seja encontrada alguma divergência, a plataforma irá apresentar a descrição (lista abaixo) e informar a linha que deverá ser corrigida.

Validação do arquivo

Formato de arquivo inválido

O arquivo não está no formato CSV UTF-8 Separado por virgulas ou está com codificação errada.

Valores no arquivo devem ser separados por vírgula ou ponto e vírgula

O Arquivo não está no formato CSV UTF-8 Separado por virgulas.

Validação dos headers (cabeçalho/coluna)

Cabeçalho obrigatório: Arquivo sem o cabeçalho action

O Arquivo não possui a coluna ACTION (obrigatória).

Cabeçalho inválido: “metadado” ou “metadata” não são cabeçalhos permitidos

Existe alguma coluna chamada “metadado” ou “metadata” no arquivo.

Cabeçalhos duplicados: o nome dos campos no cabeçalho devem ser únicos para garantir a integridade dos dados

Existe mais de uma coluna com o mesmo cabeçalho no arquivo.

Validação dos headers x actions

Action inválida: apenas o valores CREATE, OVERWRITE, INVITE e APPEND_TEAMS são aceitos, certifique-se de que eles estão preenchidos, escritos em maiúsculo e sem caracteres especiais, espaços ou acentos

Existe alguma informação errada na coluna action .

Action inválida: a ação APPEND_TEAMS não pode ser utilizada em conjunto com as ações CREATE, OVERWRITE ou INVITE

Existe uma linha com o a action APPEND_TEAMS em um arquivo com outras actions.

Cabeçalho obrigatório: “name” deve ser especificado

Existe uma linha com a action CREATE no arquivo e a coluna NAME não foi preenchida.

Cabeçalho obrigatório: “email” ou “username” deve ser especificado

Existe uma linha com a action CREATE no arquivo e não existe preenchimento na coluna “EMAIL” ou na “USERNAME” (ao menos uma deve estar preenchida).

Cabeçalho obrigatório: “password” deve ser especificado

Existe uma linha com a action CREATE no arquivo e a coluna PASSWORD não foi preenchida.

Cabeçalho obrigatório: “id” deve ser especificado

Existe uma linha com a action OVERWRITE no arquivo e a coluna ID não foi preenchida.

Cabeçalho obrigatório: “email” deve ser especificado

Existe uma linha com a action INVITE no arquivo e a coluna EMAIL não foi preenchida.

Cabeçalho obrigatório: “id” deve ser especificado

Existe uma linha com a action APPEND_TEAMS no arquivo e a coluna ID não foi preenchida.

Cabeçalho obrigatório: “teams” deve ser especificado

Existe uma linha com a action APPEND_TEAMS no arquivo e a coluna TEAMS não foi preenchida.

Campos inválidos: apenas os campos obrigatórios são aceitos para a action APPEND_TEAMS

Existem colunas preenchidas com dados que não são necessários/permitidos para a action APPEND_TEAMS.

Campo obrigatório: “name” não pode ser nulo ou vazio

Não existe a coluna obrigatória name ou ela está vazia.

Campo obrigatório: “email” ou “username” não pode ser nulo ou vazio

Não existe a coluna obrigatória "email" ou "username" ou elas estão vazias.

Campo obrigatório: “password” não pode ser nulo ou vazio

Não existe a coluna obrigatória password ou ela está vazia.

Campo obrigatório: “id” não pode ser nulo ou vazio

Não existe a coluna obrigatória id ou ela está vazia.

Campo obrigatório: “email” não pode ser nulo ou vazio

Não existe a coluna obrigatória email ou ela está vazia.

Campo obrigatório: “id” não pode ser nulo ou vazio

Não existe a coluna obrigatória id ou ela está vazia.

Campo obrigatório: “teams” não pode ser nulo ou vazio

Não existe a coluna obrigatória teams ou ela está vazia.

Comando inválido: “[DELETE]” não permitido para a action CREATE

O comando Delete é valido apenas para a action OVERWRITE.

Comando inválido: “[DELETE]” não permitido para a action INVITE

O comando Delete é valido apenas para a action OVERWRITE.

Comando inválido: “[DELETE]” não permitido para a action APPEND_TEAMS

O comando Delete é valido apenas para a action OVERWRITE.

Comando inválido: Deve ser especificado em inglês, no formato maiúsculo e entre colchetes "[DELETE]"

O comando Delete foi escrito de forma errada na coluna.

Comando inválido: [DELETE] não permitido para o campo especificado

O comando Delete foi incluído em uma coluna que não possui ação.

Comando inválido: [DELETE] não permitido, pelo menos um dos campos 'email' ou 'username' deve ser especificado"

O comando Delete foi incluído na coluna email ou username sem que a outra tenha sido preenchida.

Validação dos dados

Name inválido: Não deve conter somente caracteres especiais ou acentos

A coluna Name foi preenchida apenas com caracteres especiais ou acentos.

Username inválido: Não deve conter somente caracteres especiais ou espaços e acentos

A coluna Username foi preenchida apenas com caracteres especiais ou acentos.

Email inválido: Deve seguir o formato padrão “@email.com”

A coluna Email ou preenchida com um dado no formato incorreto.

Password inválido: Deve seguir o formato texto puro (sem criptografia), e conter no mínimo: 6 caracteres (entre letras e números (0-9))

A coluna Password foi preenchida com uma senha fora do padrão.

Rule inválida: Deve ser especificado como "admin", "expert" ou "student" em inglês, no formato minúsculo

A coluna Rule foi preenchida com um dado ou escrita incorreta.

Active inválido: Deve ser especificado como “true” (Ativo) ou “false” (Inativo)

A coluna Active foi preenchida com um dado incorreto.

Language inválida: Deve ser especificado como “pt-BR” (Português), “en-US” (Inglês) ou “es-ES” (Espanhol)

A coluna Language foi preenchida com um dado incorreto.

Valores duplicados em campos obrigatórios: Conjunto de valores de action e id não podem ser repetidos

Existe um usuário que será afetado por mais de uma Action no mesmo arquivo.

Valores duplicados em campos obrigatórios: Conjunto de valores de action e email não podem ser repetidos

Existe um usuário que será afetado por mais de uma Action no mesmo arquivo.

Valores duplicados em campos obrigatórios: Conjunto de valores de action e username não podem ser repetidos

Existe um usuário que será afetado por mais de uma Action no mesmo arquivo.

Leaders inválidos: Para colocar mais de um “email” ou “username”, deve-se utilizar somente duas barras "//" como separador

Formato de separação na coluna Leaders está fora do padrão.

Teams inválidos: Para colocar mais de um “time” deve-se utilizar somente duas barras "//" como separador

Formato de separação na coluna Teams está fora do padrão.

Alertas de alterações substanciais

Após a validação pré-upload, você receberá um alerta relacionado as alterações substanciais presentes no arquivo (se existirem), só será possível prosseguir com o upload após confirmar que deseja seguir. Os alertas são gerados nas seguintes situações:

  • Quantidade elevada de campos sendo removidos.
  • Ações diferentes sendo utilizadas em conjunto no mesmo arquivo de importação.
  • Inativação de usuários em massa.
  • Criação ou edição de metadados.

Resumo de ações

Após a validação pré-upload, se todas as informações estiverem corretas, você receberá um resumo com todas as ações presentes no arquivo. O resumo seguirá o modelo abaixo:

  1. Arquivo validado com sucesso e está pronto para ser carregado;
    1. X novos usuários serão cadastrados;
    2. X usuários terão seus dados atualizados;
    3. X usuários serão convidados para se cadastrarem na plataforma;
    4. X usuários receberão a adição de novos times;


O que você achou desse artigo? Gostou?


Powered by HelpDocs (opens in a new tab)