Como importar cards em CSV

Importar cards em CSV permite criar ou atualizar vários registros de uma vez, garantindo agilidade e padronização das informações.

1º Passo: Acessando o módulo de Cards

No menu lateral superior esquerdo, clique em “Cards” para abrir a listagem disponível.
Você pode navegar pelas abas de pipeline na parte superior para escolher em qual fluxo deseja importar os cards.

2º Passo: Baixando o template de importação

1. Na listagem de Cards, clique no botão "Importar CSV" representado pelo ícone de upload no canto superior direito.

2. Na janela “Importar Dados”, clique em "Baixar Template" para obter o CSV modelo.

O template contém as colunas obrigatórias:

• code (código de rastreamento do card)

• name (nome dado ao card)

• tags (etiquetas associadas, separadas por vírgula)

• sla (prazo configurado em horas)

• last_stage_updated_at (data/hora da última movimentação de estágio)

• pipeline (nome do pipeline)

• pipeline_stage (nome do estágio atual)

• owner_user (nome do responsável)

• creator_user (usuário que criou o card)

• pipeline_uuid (identificação única do pipeline)

• pipeline_stage_uuid (identificação única do estágio)

• owner_user_uuid (identificação única do responsável)

• creator_user_uuid (identificação única do criador)

• created_at (data e hora de criação)

• updated_at (data e hora da última edição)

• cf_<uuid> (colunas de campos customizados, se houver)
  

3º Passo: Preenchendo o arquivo CSV

1. Abra o template em um editor de planilhas e preencha cada linha com os dados do card.

   • Mantenha a ordem exata das colunas.

   • Use UUIDs sempre que possível para evitar ambiguidade.

2. Salve o arquivo no formato CSV, sem alterar o cabeçalho.
   
   

4º Passo: Importando o arquivo preenchido

1. Na janela “Importar Dados”, arraste o CSV para a área indicada ou clique para selecionar o arquivo.

2. Clique em “Importar Dados” para iniciar a importação.
   
   

5º Passo: Finalizando a importação

1. Após o processamento, será exibida a mensagem: Sucesso! Os cards foram importados com sucesso.

2. A listagem de Cards será recarregada, mostrando os novos registros ou alterações.
   
   

Boas práticas:

• Use sempre o template oficial para evitar erros.

• Prefira UUIDs para pipelines, estágios e usuários.

• Faça um teste com poucas linhas antes de grandes volumes.

• Mantenha backup do CSV original.

• Valide as colunas cf_<uuid> (Campos Personalizados) ao usar campos customizados.
  
  

Conclusão:

Seguindo este processo, é possível importar cards de forma rápida e organizada, garantindo consistência nas informações. Em caso de dúvidas, entre em contato com o suporte.