Importar datos a Orkestra

Podés traer tu trabajo existente desde Jira, Linear, Notion u Obsidian. Cada importer sigue el mismo patrón preview → ejecutar: subís el archivo, revisás lo que se va a crear, y recién ahí confirmás. 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 al Wiki.
  • Obsidian — vault completo → árbol de Wiki 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. Exportá desde la plataforma origen (cada guía cuenta el paso a paso).
  2. Preview: subí 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): podés renombrar estados de workflow, decidir si invitar a los usuarios faltantes, marcar qué estados cuentan como "completado".
  4. Ejecutar: confirmás. 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 demorás 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 páginas wiki y 1.000 filas por CSV.
  • Obsidian: hasta 2.000 páginas wiki, 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 querés 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). Las páginas wiki 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 querés deshacerlo: borrá el proyecto recién creado desde Ajustes → Proyectos. Para importers de Wiki (Notion/Obsidian), borrá las páginas creadas (todas comparten scope organización y quedan agrupadas en el árbol).
  • Si tenés 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 usás Asana, ClickUp, Monday, Airtable u otra herramienta que no está en la lista, escribinos 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.