Importar datos a Orkestra

Puedes traer tu trabajo existente desde Jira, Linear, Notion u Obsidian. Cada importer sigue el mismo patrón **preview → ejecutar**: subes el archivo, revisas lo que se va a crear, y recién ahí confirmas. Las escrituras son atómicas — si algo falla, no queda a medias.

Importers disponibles

  • Jira Cloud — issues, sprints, workflow states, comentarios y adjuntos (como links).
  • Linear — issues, cycles, workflow states, labels, prioridades y comentarios.
  • Notion — databases con columna Status se convierten en Proyectos; páginas sueltas van a Documentos.
  • Obsidian — vault completo → árbol de Documentos respetando carpetas y wikilinks.

¿Trello o un CSV genérico? También soportados desde la pantalla de Importar del frontend, aunque con menos cobertura de scope que los 4 de arriba.

Cómo funciona el flujo

  1. Exporta desde la plataforma origen (cada guía cuenta el paso a paso).
  2. Preview: sube el archivo en Orkestra. El backend parsea, valida y te muestra qué va a crear (proyecto, tareas, páginas, usuarios no mapeados, warnings).
  3. Mapeo manual (opcional): puedes renombrar estados de workflow, decidir si invitar a los usuarios faltantes, marcar qué estados cuentan como “completado”.
  4. Ejecutar: confirmas. Orkestra ejecuta todo en una transacción atómica (máx 60s). Si falla, no se crea nada.

El token de preview vive 15 minutos en Redis. Si te demoras más, hay que volver a subir el archivo. El token es de un solo uso y está atado a tu usuario.

Límites de tamaño

  • Imports JSON (Jira, Linear): hasta 10 MB, profundidad máxima 10 niveles.
  • Imports ZIP (Notion, Obsidian): hasta 50 MB.
  • Notion: hasta 2.000 documentos y 1.000 filas por CSV.
  • Obsidian: hasta 2.000 documentos, carpetas de hasta 10 niveles (las más profundas se aplanan a raíz).

Trazabilidad de IDs originales

Los 4 importers guardan el identificador original de cada entidad en custom fields del proyecto creado. Si mañana quieres cruzar datos con el sistema viejo, el link está ahí:

  • Jira → jira_id, jira_issue_type, jira_parent_key.
  • Linear → linear_id, linear_parent_id, linear_project_id.
  • Notion → notion_id por tarea.
  • Obsidian → no se guardan IDs externos (el vault no tiene IDs propios; los archivos se identifican por ruta).

Usuarios e invitaciones

Jira y Linear mapean usuarios por email. Si el email del assignee/autor existe en tu organización, se asigna automáticamente. Si no existe, lo vas a ver en la preview como usuario faltante con dos opciones:

  • Ignorar: el ítem se importa sin assignee y los comentarios agregan un prefijo [Importado desde Jira/Linear — originalmente por X].
  • Invitar: Orkestra crea una Invitación PENDING (scope organización, rol VIEWER) y envía el email de invitación después de que el import commitea.

Notion y Obsidian no mapean usuarios (sus exports no traen consistencia de identidad). Los documentos se crean con scope de organización y visibilidad pública.

Qué hacer si algo salió mal

  • La transacción tiene un timeout de 60 segundos. Si tu archivo es muy grande o tu DB tiene carga, puede caer a mitad. En ese caso Orkestra hace rollback completo — no queda un proyecto a medias.
  • Si el import ya commiteó y quieres deshacerlo: borra el proyecto recién creado desde Ajustes → Proyectos. Para importers de Documentos (Notion/Obsidian), borra las páginas creadas (todas comparten scope organización y quedan agrupadas en el árbol).
  • Si tienes dudas sobre qué queda fuera del scope de un importer, la guía específica lista todo lo que se ignora silenciosamente o se warnea.

¿Otra plataforma?

Si usas Asana, ClickUp, Monday, Airtable u otra herramienta que no está en la lista, escríbenos a soporte@orkestra.team con un export de muestra. Los 4 importers actuales se construyeron sobre el mismo patrón, así que sumar uno nuevo es principalmente mapear entidades — no una rearquitectura.