Migrar do Pivotal Tracker, do Jira e de outros trackers

O East Agile Tracker importa de onze fontes. Dez leem o arquivo de exportação que a outra ferramenta já produz; o GitHub se conecta ao repositório diretamente. Todas as fontes passam pela mesma tela e pela mesma prévia, então os passos abaixo valem para todas. As seções seguintes listam o que cada fonte traz.

Importar uma exportação

1. Exporte o seu trabalho da outra ferramenta — a seção da sua fonte, mais abaixo, indica o menu.
2. Abra Project Settings → Import / Export no projeto onde você quer as histórias. Crie primeiro um projeto vazio, se precisar de um.
3. Escolha a origem e selecione o arquivo de exportação.
4. Rode a prévia em modo dry-run. Ela analisa o arquivo inteiro e relata o que uma importação real faria — quantas histórias e labels, quantas linhas são ignoradas e qualquer pessoa que não tenha conseguido associar a um membro — sem escrever nada.
5. Importe.

Reimportar o mesmo arquivo é seguro. Uma linha que já foi importada é reconhecida pelo seu id de origem e ignorada, então uma segunda execução complementa o projeto em vez de duplicá-lo.

Um upload é limitado a 10 MiB, e uma única importação a 5.000 histórias. Uma migração maior se divide em lotes e, porque reimportar é idempotente, os lotes podem se sobrepor sem criar duplicatas.

O que toda fonte traz

• Histórias, estados e labels. Cada linha ou cartão vira uma história, o seu status cai no estado mais próximo do ciclo unstarted → started → finished → delivered → accepted, e as suas labels vêm junto. Um status cancelado ou “won’t fix” chega rejeitado e arquivado, de modo que o trabalho abandonado fica fora do quadro e fora da velocidade.
• Donos. Uma célula com um e-mail que corresponde a um membro anexa esse membro. Qualquer outro valor — um nome de exibição, um nome de usuário — anexa uma pessoa externa só para exibição, de modo que quem era dono do quê sobrevive mesmo para pessoas que não têm conta aqui.
• Datas. As datas de criação e de conclusão são importadas, de modo que as iterações históricas e os gráficos que as leem ficam preenchidos em vez de vazios.
• Iterações, para toda fonte cuja exportação traga sprints ou ciclos.

Solicitantes, comentários, épicos e tarefas dependem da fonte; a seção dela, mais abaixo, diz quais.

O que não vem junto

• Anexos. Nenhum importador carrega arquivos. As histórias chegam sem eles.
• Pessoas como contas. Um dono, solicitante ou comentarista que ainda não é membro é anexado como pessoa externa só para exibição. Nada é descartado e nada é atribuído errado, mas nenhuma conta é criada e nenhum convite é enviado — convide as pessoas normalmente e o histórico delas já está anexado.
• Datas de última modificação. Não há carimbo updated na entrada.
• Nuances de workflow. Status personalizados se reduzem ao estado mais próximo no ciclo acima. A prévia em modo dry-run é onde conferir uma amostra antes de importar um projeto grande.

Do Pivotal Tracker

Origem: Pivotal Tracker (CSV export). O Pivotal Tracker encerrou em 30 de abril de 2025, então não existe mais um serviço no ar do qual exportar; o que este importador lê é uma exportação CSV guardada de antes do encerramento. O quadro, os estados das histórias e o ciclo de aceitação seguem o mesmo modelo, de modo que um projeto importado se lê como se lia antes.

Pivotal Tracker	Torna-se
Title, Description	O título e a descrição da história. A coluna URL é mantida como procedência da história, e um link View original issue é adicionado a uma descrição que tenha texto.
Type	O tipo de história — feature, bug, chore e release todos têm um equivalente direto.
Current State	O estado da história.
Estimate	A estimativa em pontos da história.
Labels	Labels, uma por valor.
Owned By	Os donos da história. O Pivotal repete essa coluna por dono e todas são lidas.
Requested By	O solicitante da história.
Comment (uma coluna por comentário)	Comentários da história, com o autor original e o horário original.
Task / Task Status	Tarefas na história, com as tarefas concluídas chegando concluídas.
Blocker / Blocker Status	Bloqueios, com os resolvidos chegando resolvidos.
Linhas Type=epic	Épicos de verdade, reconstruídos e ligados às histórias que os referenciam, com a descrição do épico.
Iteration, Iteration Start	A grade de iterações. Histórias de uma iteração que ainda não havia começado ficam no Backlog, ordenadas por sprint.
Created at, Accepted at	As datas de criação e de conclusão da história.
Deadline	A data planejada de uma história release.

Uma exportação do Pivotal não tem coluna de início do trabalho, então os números de tempo de ciclo ficam vazios para as histórias importadas. Uma linha de épico que nenhuma história referencia não cria nada, porque os épicos são reconstruídos pelas suas histórias membro.

Do Jira

Origem: Jira (CSV export). No Jira, busque as issues que você quer e use Export → Export Excel CSV (all fields). Pegue a exportação com todos os campos — a exportação dos campos atuais omite as colunas de sprint, de pontos de história e de comentários.

Jira	Torna-se
Summary	O título da história. Uma linha com o resumo vazio não é importada.
Description	A descrição da história, convertida do wiki markup do Jira para markdown. Títulos, negrito, blocos de código, listas e links são convertidos; todo o resto é mantido como texto literal.
Issue Type	O tipo de história — Bug vira um bug, Story e Feature viram features, e Task vira um chore.
Status	O estado da história.
Priority	A prioridade da história, de Highest até Lowest.
Campo personalizado de pontos de história	A estimativa da história. É usada a primeira coluna cujo cabeçalho menciona pontos de história, então Custom field (Story Points) e Custom field (Story point estimate) funcionam os dois.
Labels	Labels, uma por valor.
Fix Version/s	Uma label Release: <version> por valor.
Sprint	A grade de iterações. O Jira repete a coluna uma vez por sprint pelo qual a issue passou, e o último é onde ela terminou; um sprint com nome também sobrevive como uma label Sprint: <name>.
Assignee	O dono da história, como pessoa externa só para exibição — um CSV do Jira não traz endereço de e-mail com que associar um membro.
Reporter	O solicitante da história, pela mesma regra.
Comment (uma coluna por comentário)	Comentários da história, cada um com o seu autor e horário originais.
Issues Sub-task	Tarefas na história pai, com as subtarefas concluídas chegando completas. Uma subtarefa cujo pai está ausente do arquivo se torna uma história própria.
Issues Epic	Uma label com o nome do épico, aplicada a cada issue filha nele.
Issue key	Anexada à descrição como texto puro (Original issue: PROJ-12).
Created, Resolved	As datas de criação e de conclusão da história.

Um épico do Jira chega como uma label nas suas filhas, e não como um registro de épico: o agrupamento sobrevive e é pesquisável, a descrição do próprio épico não. O Jira exporta nomes de sprint, mas não as suas datas, então as iterações são ordenadas por nome de sprint.

Do Linear

Origem: Linear (CSV export) — no Linear, Workspace settings → Import/Export → Export CSV.

• Assignee vira o dono e Creator o solicitante.
• Project vira o épico da história.
• Sub-issues viram tarefas na sua história pai.
• Os ciclos montam a grade de iterações; um ciclo que ainda não começou mantém as suas histórias no Backlog, ordenadas por ciclo.
• A coluna Started é lida, então o tempo de ciclo funciona para as histórias importadas.
• O CSV do Linear não tem coluna de tipo: uma história com a label Bug chega como bug; caso contrário, como feature.
• A exportação CSV do Linear não tem comentários, e issues arquivadas são ignoradas.

Do Asana

Origem: Asana (CSV export) — no Asana, Project menu → Export/Print → CSV.

• Assignee vira o dono, associado a um membro por meio de Assignee Email quando houver.
• Tags viram labels.
• Subtarefas viram tarefas na sua história pai.
• Uma tarefa com uma data em Completed At chega aceita.
• O CSV do Asana não tem coluna de criador nem comentários, então o membro que importa é o solicitante.

Do Trello

Origem: Trello (JSON export) — no Trello, Menu → Print and export → Export as JSON.

• Cada cartão vira uma história, e a lista em que ele está define o seu estado (To Do, Doing, Done e nomes parecidos).
• Os membros de um cartão viram donos.
• Os comentários vêm junto, com os seus autores e horários.
• Os itens de checklist viram tarefas.
• As labels mantêm os seus nomes e cores; uma label com cor e sem nome chega como Trello-<colour>.
• Um cartão arquivado chega arquivado.
• Um cartão com a label Bug chega como bug. O Trello não tem épicos nem estimativas, então nenhum dos dois é criado.

Do Shortcut

Origem: Shortcut (CSV export) — no Shortcut, Settings → Import/Export → Export to CSV.

• owners viram os donos e requester o solicitante.
• epic vira o épico da história.
• tasks viram tarefas na história; o CSV não registra nenhum indicador de concluído, então elas chegam abertas.
• As iterações montam a grade de iterações.
• A coluna started_at é lida, então o tempo de ciclo funciona para as histórias importadas.
• Uma história arquivada chega arquivada. O CSV do Shortcut não tem comentários.

Do GitLab

Origem: GitLab (CSV export) — no GitLab, abra a lista de issues e use Export as CSV; o GitLab envia o arquivo para você por e-mail.

• Uma issue aberta chega como unstarted, uma fechada como accepted.
• Weight vira a estimativa.
• O responsável vira o dono e o autor o solicitante.
• A URL da issue é mantida como a sua procedência.
• Ative Include milestones para transformar cada milestone em um épico; desativado, a coluna de milestones é ignorada.
• O CSV de issues do GitLab não tem comentários.

Do Plane

Origem: Plane (CSV export) ou Plane (JSON export) — no Plane, Workspace settings → Exports.

• Cada responsável vira um dono.
• Os comentários vêm junto, com os seus autores e horários.
• Os grupos de estados do Plane definem o estado; uma issue cancelada chega rejeitada e arquivada.
• Um ciclo monta a grade de iterações e também sobrevive como uma label Cycle: <name>; um módulo vira uma label Module: <name>.
• As exportações do Plane não têm coluna de criador, então o membro que importa é o solicitante. O Plane não exporta data de início do trabalho, então não há tempo de ciclo.

Do GitHub

Origem: GitHub (Issues via API). Informe o dono e o repositório em vez de fazer upload de um arquivo. As issues viram histórias com os seus responsáveis, autor, labels, comentários e itens de checklist; pull requests, milestones (como épicos) e releases são opcionais. Tokens, limites de taxa e o resto estão em Popular um projeto a partir de um repositório do GitHub.

De outro projeto do East Agile Tracker

Origem: East Agile Tracker (native export) — no outro projeto, Settings → Import / Export → Baixar exportação. Este é o caminho sem perdas: seguidores, revisores, épicos, tarefas, bloqueios, links e o Icebox voltam todos, e os donos são reassociados aos membros por e-mail.

Depois da importação

As histórias são histórias comuns — a máquina de estados, as iterações e a velocidade se aplicam todas. A mesma tela exporta o projeto novamente mais adiante, para o formato do East Agile Tracker, para uma cópia sem perdas, ou para o formato de qualquer uma das outras ferramentas; veja Instruções de Operação → Exportando um projeto.

Crie um projeto e importe a sua exportação — o importador está na tela de configurações de todo projeto.