GitScrum / Docs
Todas as Boas Práticas

Exportar Dados do Jira para GitScrum | Migração Completa

Migre do Jira para GitScrum: auditoria dados, mapeamento campos, importação estruturada. CSV/JSON export, validação, execução paralela.

6 min de leitura

Migrar do Jira para o GitScrum não significa perder o histórico do seu projeto. O GitScrum fornece capacidades de importação e estratégias de migração que ajudam equipes a fazer a transição suavemente enquanto preservam dados históricos valiosos, informações de sprint e fluxos de trabalho da equipe.

Visão Geral da Migração

FaseAtividadesDuração
PlanejamentoAuditar dados, mapear campos, planejar cronograma1-2 dias
ExportaçãoExtrair dados do Jira1 dia
ImportaçãoCarregar dados no GitScrum1-2 dias
ValidaçãoVerificar integridade dos dados1 dia
TransiçãoOnboarding da equipe, execução paralela1 semana

Processo de Exportação do Jira

EXPORTANDO DO JIRA
══════════════════

PASSO 1: AUDITAR SEUS DADOS
─────────────────────────────────────
Antes de exportar, entenda o que você tem:

□ Contagem de issues por tipo
  ├── Stories
  ├── Bugs
  ├── Tasks
  ├── Épicos
  └── Sub-tarefas

□ Campos customizados em uso
  ├── Campos obrigatórios
  ├── Campos opcionais
  └── Campos calculados

□ Estados do workflow
  ├── Status atuais
  ├── Transições
  └── Resoluções

□ Dados históricos necessários
  ├── Issues fechados
  ├── Histórico de sprints
  └── Time tracking

PASSO 2: OPÇÕES DE EXPORTAÇÃO
─────────────────────────────────────
Jira → Exportar → Escolher formato:

Exportação CSV:
├── Simples, funciona para maioria dos casos
├── Exportar todos os campos ou selecionados
├── Bom para < 10.000 issues
└── Fácil de revisar e limpar

Exportação JSON/XML:
├── Dados mais completos
├── Inclui relacionamentos
├── Melhor para projetos complexos
└── Requer mais processamento

Exportação API do Jira:
├── Mais completa
├── Inclui todo o histórico
├── Melhor para migrações grandes
└── Requer configuração técnica

Mapeamento de Campos para o GitScrum

MAPEAMENTO JIRA PARA GITSCRUM
═════════════════════════════

TIPOS DE ISSUES:
─────────────────────────────────────
Jira               →  GitScrum
Story              →  User Story
Bug                →  Bug
Task               →  Task
Epic               →  Epic
Sub-task           →  Subtask

CAMPOS:
─────────────────────────────────────
Summary            →  Title
Description        →  Description
Priority           →  Priority
Labels             →  Labels
Assignee           →  Assignee
Reporter           →  Creator
Story Points       →  Effort Points
Sprint             →  Sprint
Epic Link          →  Epic
Components         →  Labels (mapeados)
Fix Version        →  Milestone

MAPEAMENTO DE STATUS:
─────────────────────────────────────
To Do              →  To Do
In Progress        →  In Progress
In Review          →  Code Review
Done               →  Done

CAMPOS CUSTOMIZADOS:
─────────────────────────────────────
Documente seus campos customizados:
┌─────────────────────────────────────┐
│ Campo Jira       │ Campo GitScrum   │
├──────────────────┼──────────────────┤
│ Critérios Aceit. │ Acceptance Crit. │
│ Team             │ Label: team-name │
│ Categoria        │ Label: category  │
│ Data Limite      │ Due Date         │
└──────────────────┴──────────────────┘

Importar para o GitScrum

PROCESSO DE IMPORTAÇÃO GITSCRUM
═══════════════════════════════

PASSO 1: PREPARAR DADOS
─────────────────────────────────────
Limpar seu arquivo de exportação:
□ Remover entradas duplicadas
□ Padronizar valores de campos
□ Mapear contas de usuários
□ Resolver links quebrados
□ Corrigir problemas de encoding

PASSO 2: CRIAR ESTRUTURA DO PROJETO
─────────────────────────────────────
No GitScrum:
□ Criar projeto(s)
□ Configurar labels
□ Criar sprints
□ Configurar workflows
□ Adicionar membros da equipe

PASSO 3: IMPORTAR DADOS
─────────────────────────────────────
Importar em ordem:
1. Épicos primeiro (itens pai)
2. Stories e tasks
3. Subtasks por último
4. Comentários e anexos
5. Atribuições de sprint

PASSO 4: VALIDAR
─────────────────────────────────────
Verificar importação:
□ Contagem de issues confere
□ Relacionamentos preservados
□ Anexos acessíveis
□ Usuários atribuídos corretamente
□ Dados de sprint precisos

Estratégias de Migração

OPÇÕES DE ABORDAGEM
═══════════════════

MIGRAÇÃO COMPLETA:
─────────────────────────────────────
Todos os dados, histórico completo

Melhor para:
├── Mudança completa de plataforma
├── Dados históricos importantes
├── Corte limpo necessário
└── Requisitos de compliance

Cronograma: 1-2 semanas

MIGRAÇÃO SELETIVA:
─────────────────────────────────────
Apenas trabalho ativo, arquivar o antigo

Melhor para:
├── Transição rápida
├── Início fresco desejado
├── Dados antigos raramente acessados
└── Onboarding mais rápido

Cronograma: 2-3 dias

EXECUÇÃO PARALELA:
─────────────────────────────────────
Ambos sistemas temporariamente

Melhor para:
├── Mitigação de riscos
├── Transição gradual
├── Tempo de adaptação da equipe
└── Workflows complexos

Cronograma: 2-4 semanas overlap

ABORDAGEM RECOMENDADA:
─────────────────────────────────────
1. Migrar trabalho ativo (issues abertos)
2. Importar histórico recente (90 dias)
3. Arquivar dados mais antigos no Jira
4. Rodar em paralelo por 1-2 semanas
5. Completar cutover

Checklist Pós-Migração

APÓS A IMPORTAÇÃO
═════════════════

VERIFICAR DADOS:
─────────────────────────────────────
□ Todos os issues importados
□ Relacionamentos corretos
□ Usuários mapeados corretamente
□ Sprints precisos
□ Labels aplicadas

ONBOARDING DA EQUIPE:
─────────────────────────────────────
□ Sessões de treinamento agendadas
□ Guias de referência rápida criados
□ Canais de suporte estabelecidos
□ Power users identificados
□ FAQ documentado

CONFIGURAÇÃO DE WORKFLOW:
─────────────────────────────────────
□ Boards do GitScrum configurados
□ Automações configuradas
□ Integrações conectadas
  ├── Repositório Git
  ├── Slack/Teams
  └── CI/CD
□ Notificações configuradas

DESCOMISSIONAR JIRA:
─────────────────────────────────────
□ Exportar backup final
□ Notificar stakeholders
□ Atualizar documentação
□ Redirecionar links
□ Arquivar acesso

Melhores Práticas

  • Planejar exaustivamente antes de iniciar migração
  • Limpar dados na origem antes de exportar
  • Testar importação com dataset pequeno primeiro
  • Mapear campos antes da importação em massa
  • Preservar histórico para compliance
  • Treinar a equipe durante a transição
  • Rodar em paralelo para reduzir risco
  • Documentar tudo para referência
  • Anti-Padrões

    ✗ Migração big bang sem testes
    ✗ Ignorar limpeza de dados
    ✗ Sem planejamento de mapeamento de campos
    ✗ Pular etapa de validação
    ✗ Fechamento imediato do Jira
    ✗ Sem treinamento da equipe
    

    Soluções Relacionadas