Aprenda como importar cards em lote para a octapipe usando um arquivo CSV baseado em template, incluindo download do modelo e importação completa

Support Team
Publicado em 15 de agosto de 2025

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\_** (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\_** (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.
Mantenha-se atualizado sobre sobre a Octaworks, incluindo atualizações e lançamentos de novos produtos.