GitScrum / Docs
Todas las Mejores Prácticas

Migrar de Jira a GitScrum | Guía Completa

Migra datos de proyecto de Jira a GitScrum sin problemas. Exporta issues, sprints e historial manteniendo integridad de datos en GitScrum.

6 min de lectura

Migrar de Jira a GitScrum no significa perder el historial de tu proyecto. GitScrum proporciona capacidades de importación y estrategias de migración que ayudan a los equipos a hacer la transición sin problemas mientras preservan datos históricos valiosos, información de sprints y flujos de trabajo del equipo.

Resumen de Migración

FaseActividadesDuración
PlanificaciónAuditar datos, mapear campos, planificar cronograma1-2 días
ExportaciónExtraer datos de Jira1 día
ImportaciónCargar datos en GitScrum1-2 días
ValidaciónVerificar integridad de datos1 día
TransiciónOnboarding del equipo, ejecución paralela1 semana

Proceso de Exportación de Jira

EXPORTANDO DESDE JIRA
═════════════════════

PASO 1: AUDITAR TUS DATOS
─────────────────────────────────────
Antes de exportar, entiende qué tienes:

□ Conteo de issues por tipo
  ├── Stories
  ├── Bugs
  ├── Tasks
  ├── Épicas
  └── Sub-tareas

□ Campos personalizados en uso
  ├── Campos requeridos
  ├── Campos opcionales
  └── Campos calculados

□ Estados del workflow
  ├── Estados actuales
  ├── Transiciones
  └── Resoluciones

□ Datos históricos necesarios
  ├── Issues cerrados
  ├── Historial de sprints
  └── Time tracking

PASO 2: OPCIONES DE EXPORTACIÓN
─────────────────────────────────────
Jira → Exportar → Elegir formato:

Exportación CSV:
├── Simple, funciona para la mayoría de casos
├── Exportar todos los campos o seleccionados
├── Bueno para < 10,000 issues
└── Fácil de revisar y limpiar

Exportación JSON/XML:
├── Datos más completos
├── Incluye relaciones
├── Mejor para proyectos complejos
└── Requiere más procesamiento

Exportación API de Jira:
├── Más completo
├── Incluye todo el historial
├── Mejor para migraciones grandes
└── Requiere configuración técnica

Mapeo de Campos a GitScrum

MAPEO JIRA A 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

MAPEO DE ESTADOS:
─────────────────────────────────────
To Do              →  To Do
In Progress        →  In Progress
In Review          →  Code Review
Done               →  Done

CAMPOS PERSONALIZADOS:
─────────────────────────────────────
Documenta tus campos personalizados:
┌─────────────────────────────────────┐
│ Campo Jira       │ Campo GitScrum   │
├──────────────────┼──────────────────┤
│ Criterios Acept. │ Acceptance Crit. │
│ Team             │ Label: team-name │
│ Categoría        │ Label: category  │
│ Fecha Límite     │ Due Date         │
└──────────────────┴──────────────────┘

Importar a GitScrum

PROCESO DE IMPORTACIÓN GITSCRUM
═══════════════════════════════

PASO 1: PREPARAR DATOS
─────────────────────────────────────
Limpiar tu archivo de exportación:
□ Remover entradas duplicadas
□ Estandarizar valores de campos
□ Mapear cuentas de usuarios
□ Resolver enlaces rotos
□ Arreglar problemas de encoding

PASO 2: CREAR ESTRUCTURA DEL PROYECTO
─────────────────────────────────────
En GitScrum:
□ Crear proyecto(s)
□ Configurar labels
□ Crear sprints
□ Configurar workflows
□ Agregar miembros del equipo

PASO 3: IMPORTAR DATOS
─────────────────────────────────────
Importar en orden:
1. Épicas primero (items padre)
2. Stories y tasks
3. Subtasks al final
4. Comentarios y adjuntos
5. Asignaciones de sprint

PASO 4: VALIDAR
─────────────────────────────────────
Verificar importación:
□ Conteo de issues coincide
□ Relaciones preservadas
□ Adjuntos accesibles
□ Usuarios asignados correctamente
□ Datos de sprint precisos

Estrategias de Migración

OPCIONES DE ENFOQUE
═══════════════════

MIGRACIÓN COMPLETA:
─────────────────────────────────────
Todos los datos, historial completo

Mejor para:
├── Cambio completo de plataforma
├── Datos históricos importantes
├── Corte limpio necesario
└── Requisitos de compliance

Cronograma: 1-2 semanas

MIGRACIÓN SELECTIVA:
─────────────────────────────────────
Solo trabajo activo, archivar lo viejo

Mejor para:
├── Transición rápida
├── Inicio fresco deseado
├── Datos viejos raramente accedidos
└── Onboarding más rápido

Cronograma: 2-3 días

EJECUCIÓN PARALELA:
─────────────────────────────────────
Ambos sistemas temporalmente

Mejor para:
├── Mitigación de riesgos
├── Transición gradual
├── Tiempo de adaptación del equipo
└── Workflows complejos

Cronograma: 2-4 semanas overlap

ENFOQUE RECOMENDADO:
─────────────────────────────────────
1. Migrar trabajo activo (issues abiertos)
2. Importar historial reciente (90 días)
3. Archivar datos más viejos en Jira
4. Correr en paralelo por 1-2 semanas
5. Completar cutover

Checklist Post-Migración

DESPUÉS DE LA IMPORTACIÓN
═════════════════════════

VERIFICAR DATOS:
─────────────────────────────────────
□ Todos los issues importados
□ Relaciones correctas
□ Usuarios mapeados correctamente
□ Sprints precisos
□ Labels aplicados

ONBOARDING DEL EQUIPO:
─────────────────────────────────────
□ Sesiones de entrenamiento programadas
□ Guías de referencia rápida creadas
□ Canales de soporte establecidos
□ Power users identificados
□ FAQ documentado

CONFIGURACIÓN DE WORKFLOW:
─────────────────────────────────────
□ Boards de GitScrum configurados
□ Automatizaciones configuradas
□ Integraciones conectadas
  ├── Repositorio Git
  ├── Slack/Teams
  └── CI/CD
□ Notificaciones configuradas

DESCOMISIONAR JIRA:
─────────────────────────────────────
□ Exportar backup final
□ Notificar stakeholders
□ Actualizar documentación
□ Redireccionar enlaces
□ Archivar acceso

Mejores Prácticas

  • Planificar exhaustivamente antes de iniciar migración
  • Limpiar datos en origen antes de exportar
  • Probar importación con dataset pequeño primero
  • Mapear campos antes de importación masiva
  • Preservar historial para compliance
  • Entrenar al equipo durante la transición
  • Correr en paralelo para reducir riesgo
  • Documentar todo para referencia
  • Anti-Patrones

    ✗ Migración big bang sin pruebas
    ✗ Ignorar limpieza de datos
    ✗ Sin planificación de mapeo de campos
    ✗ Saltarse paso de validación
    ✗ Cierre inmediato de Jira
    ✗ Sin entrenamiento del equipo
    

    Soluciones Relacionadas