A importação de arquivos CSV no Jira é uma funcionalidade essencial para quem deseja migrar dados de outras plataformas, carregar múltiplas issues de uma só vez ou atualizar registros existentes de maneira eficiente.

Neste artigo, vamos mostrar como importar um arquivo CSV para um projeto no Jira, detalhando os requisitos do arquivo, o processo de mapeamento de campos e algumas boas práticas para garantir uma importação bem-sucedida.

---

🛠 Passo a Passo: Importando um CSV no Jira

1️⃣ Preparação do Arquivo CSV

Antes de iniciar a importação, é importante garantir que o arquivo CSV esteja formatado corretamente. Para isso, os nomes das colunas devem corresponder aos campos do Jira para um mapeamento mais preciso e cada linha do CSV deve representar uma issue a ser criada ou atualizada.
📌 Exemplo de estrutura de CSV:

Summary	Issue Type	Assignee	Priority	Status
Corrigir erro na página de login	Bug	joao.silva	Alta	Aberto
Criar novo relatório financeiro	Tarefa	maria.souza	Média	Em andamento

2️⃣ Iniciando a Importação no Jira

🔹Acesse o Jira e vá para Configurações (⚙️) > Sistema > Importação e Exportação > External System Import (Importação de Sistema Externo, em português).

🔹Clique em CSV.
🔹Faça o upload do arquivo CSV e, após, selecione o projeto no qual deseja importar os dados.

3️⃣ Mapeamento de Campos

Em seguida, o Jira solicitará o mapeamento das colunas do CSV com os campos do Jira.

⚠️ Certifique-se de que todos os campos obrigatórios estão corretamente mapeados.

🔹 Caso algum campo do Jira não tenha correspondência no CSV, ele pode ser deixado em branco ou configurado manualmente durante a importação.
🔹 Se estiver atualizando issues já existentes, o campo Issue Key deve ser incluído no CSV para que as issues sejam reconhecidas corretamente.

4️⃣ Revisão e Execução da Importação

Após concluir o mapeamento revise os dados e confirme se tudo está correto. Então, clique em Iniciar Importação e aguarde o processo ser concluído.
🚫 Caso ocorra algum erro, o Jira fornecerá um relatório indicando quais linhas não foram importadas e os motivos.

---

🎯 Melhores Práticas para Importação de CSV no Jira

✔️ Revise os dados antes da importação para evitar erros.
✔️ Use nomes de campos consistentes para facilitar o mapeamento.
✔️ Teste com um pequeno conjunto de dados antes de realizar uma importação maior.
✔️ Faça backup do Jira antes de grandes importações, especialmente ao atualizar issues já existentes.
✔️ Evite caracteres especiais no CSV, pois podem causar problemas de formatação.

A importação de arquivos CSV no Jira é uma forma prática de carregar grandes volumes de dados, migrar informações ou atualizar registros existentes de maneira rápida e eficiente.

Se sua equipe precisa automatizar a entrada de dados ou migrar projetos de outras plataformas, esse recurso pode ser uma excelente solução.

📩 Assine nossa newsletter e fique sempre por dentro das novidades do Mundo Atlassian!