Skip to content

Atribuições em massa

As atribuições em massa permitem-lhe emitir distintivos para centenas ou milhares de destinatários de uma só vez, através do carregamento de um ficheiro CSV. O processo tem quatro passos, com acompanhamento de progresso, pausa/retomar e gestão de erros integrados.

Vista geral

O processo segue quatro etapas:

  1. Configurar — escolha o distintivo e as opções
  2. Carregar — prepare e envie o ficheiro CSV
  3. Processar — acompanhe o progresso à medida que as atribuições são criadas
  4. Resultados — reveja os resultados e transfira relatórios

Passo 1: configurar

Atribuições em massa — passo 1, configurar

  1. Abra a página Atribuições na barra lateral.
  2. Clique em Atribuição em massa.
  3. Escolha o distintivo a atribuir através do selector de distintivos.
  4. Opcionalmente, configure:
    • Emitido em — a data a usar em todas as atribuições (por defeito, a data de hoje)
    • Expira — data de expiração opcional para todas as atribuições
    • Enviar e-mail — se cada destinatário deve receber automaticamente um e-mail quando a atribuição é criada
  5. Clique em Seguinte.

Passo 2: carregar CSV

Atribuições em massa — passo 2, carregar

Formato do CSV

O ficheiro CSV deve ter duas colunas: name e email. A primeira linha deve ser o cabeçalho.

csv
name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Transferir modelo

Clique em Transferir modelo para obter um ficheiro CSV em branco com os cabeçalhos correctos. Preencha-o com os destinatários e carregue-o.

Carregar

  1. Clique em Carregar CSV ou arraste e largue o ficheiro.
  2. O ficheiro é validado antes de começar o processamento.

Regras de validação

Cada linha é validada:

  • Nome tem de ter pelo menos 5 caracteres
  • E-mail tem de ser um endereço válido
  • E-mails duplicados dentro do ficheiro são sinalizados
  • Linhas vazias são ignoradas

Se forem detectados erros de validação, são apresentados com o número da linha. Corrija os problemas no CSV e volte a carregar.

  1. Clique em Seguinte para iniciar o processamento.

Passo 3: processamento

Após arrancar o processamento, surge uma barra de progresso e o estado em directo:

  • Barra de progresso — mostra a percentagem de linhas processadas
  • Linha actual — que linha está a ser processada
  • Contagem de sucessos — quantas atribuições foram criadas
  • Contagem de erros — quantas linhas falharam

Pausar e retomar

  • Clique em Pausar para suspender temporariamente o processamento. Não são criadas novas atribuições enquanto estiver pausado.
  • Clique em Retomar para continuar a partir do ponto onde ficou.

Cancelar

  • Clique em Cancelar para parar totalmente o processamento. As atribuições já criadas são mantidas.

Gestão de erros

Quando uma linha falha (por exemplo, dados inválidos ou limite mensal de atribuições atingido):

  • O erro é registado com detalhes
  • O processamento avança automaticamente para a linha seguinte
  • As linhas com falha são recolhidas para o passo dos resultados

Recuperação após recarregar a página

Se fechar o navegador por engano ou recarregar a página durante o processamento, a sessão de atribuição em massa é recuperada quando regressar. O progresso retoma a partir de onde parou.

Passo 4: resultados

Depois de concluído (ou cancelado) o processamento, o ecrã de resultados mostra:

  • Total processado — número de linhas tentadas
  • Bem-sucedidas — número de atribuições criadas
  • Falhadas — número de linhas com falha

Transferir relatórios

  • Transferir CSV de sucessos — um CSV com todas as atribuições criadas com sucesso, incluindo nomes, e-mails e URLs de verificação
  • Transferir CSV de falhas — um CSV com todas as linhas falhadas e os detalhes do erro

Tentar novamente os que falharam

Se algumas linhas falharem, pode transferir o CSV de falhas, corrigir os problemas e carregá-lo como uma nova atribuição em massa para voltar a tentar esses destinatários.

badges.ninja Documentation