Importar desde Confluence

Es importante tener todos tus datos en un solo lugar. Aquí tienes un tutorial útil para importar tu espacio de Confluence a Notion. Dependiendo de tus necesidades, hay dos formas en las que puedes importar desde Confluence a Notion.

• Importador de archivos .zip: Se puede usar para importar solo una parte de tu espacio de trabajo. Solo puede importar espacios de trabajo más pequeños de hasta 5 GB (o 15 GB bajo solicitud).

• Importador de API: Solo puede importar todo el espacio de trabajo. Puede importar espacios de trabajo de hasta 30 GB. Conserva los comentarios y la asignación de usuarios.

Importaciones de múltiples espacios: Se pueden importar hasta 10 espacios de Confluence a la vez directamente a través de la interfaz. Cada espacio de Confluence seleccionado genera su propia página de registro e importa como una página privada de nivel superior independiente (en diferentes espacios de equipo de Notion según sea necesario). Esta función solo está disponible en los planes Business y Enterprise.

• Sitio de Confluence → organización de Notion

• Espacio de Confluence → espacio de trabajo de Notion

• Página de Confluence → página de Notion

• Macros → contenido aplanado o bloque de Notion más similar (por ejemplo, Expandir de Confluence → Desplegable de Notion)

• Importa hasta ~50k páginas o 30GB de tamaño. Las importaciones más grandes pueden fallar.

  • Consejo: Para espacios grandes, divide las exportaciones por subespacio o secciones y usa el importador ZIP. Si el tamaño del espacio de trabajo es >100 GB, contacta a tu administrador de cuenta.

• Una vez que comience la importación, puedes cerrar el navegador de forma segura. Te enviaremos un correo electrónico en cuanto finalice.

• Revisa el progreso de tu importación en Settings → Importar. Allí puedes ver el Estado de tu importación y las importaciones completadas.

Exporta tu espacio de Confluence a HTML

1. Desde el espacio de trabajo de Confluence, ve a Space Settings (configuración del espacio) en la barra lateral superior derecha.

2. Selecciona Content Tools en la barra de herramientas superior y, a continuación, Exportar. Si no ves alguna de estas opciones, es posible que necesites solicitar permiso de exportación a un administrador del espacio de trabajo.

3. Selecciona HTML en la lista de formatos.

4. Selecciona Custom Export (exportación personalizada) y desmarca la casilla Include comments (incluir comentarios).

5. Elige qué páginas quieres exportar. Ten en cuenta que las páginas que incluyan archivos adjuntos de gran tamaño pueden aumentar notablemente tanto el tamaño como la complejidad de la exportación.

6. Deja que el proceso de exportación finalice. En el caso de los espacios de trabajo grandes, esto puede tardar un poco.

7. Una vez completado, haz clic en Descargar para guardar la exportación en tu computadora. El archivo tendrá un nombre similar a Confluence-space-export-XXXXXX.html.zip.

Importar a Notion

1. Dirígete al espacio de trabajo de Notion al que quieres importar tu contenido de Confluence.

2. En la barra lateral, ve a Configuración → Importar → Importaciones de terceros → Confluence.

3. Accede al archivo .zip que se exportó desde Confluence y selecciónalo para cargarlo. No es necesario descomprimir el archivo; cárgalo completo.

4. Verás en el navegador un mensaje que indica que la carga del archivo está en curso y, a continuación, un mensaje de estado sobre el progreso de la importación.

5. Cuando la importación finalice, se te redirigirá al contenido recién importado.

Conectar Confluence y Notion

1. Ve a Configuración en tu barra lateral → Importar → Confluence.

2. Elige Importar mediante API.

3. Selecciona el tipo de instancia de Confluence: cloud o server. Para encontrar tu tipo de instancia, abre Confluence, haz clic en Help → ? junto a tu perfil → About Confluence. Notion solo es compatible con instancias cloud y server.

Autenticación con Confluence Cloud:

1. Ingresa tu correo electrónico y página de Confluence.

2. Crea un token de API desde tu cuenta de Atlassian e ingrésalo en el campo correspondiente. Obtén más información sobre la creación de tokens en Confluence.

3. Haz clic en Autenticar.

Autenticación con Confluence Server:

1. Busca y selecciona tu versión de Confluence aquí.

2. Ingresa tu correo electrónico y página de Confluence.

3. Si estás ejecutando la versión Confluence 7.9 o posterior, crea un Personal Access Token y pégalo. Si estás usando una versión anterior, ingresa tu nombre de usuario y contraseña de Confluence.

4. Haz clic en Autenticar.

Importar

1. Haz clic en Confluence en el menú Importar.

2. Supervisa el progreso de la importación. El proceso puede tardar varias horas en el caso de los espacios grandes.

   • Cuando veas Importando páginas…, puedes cerrar el navegador. Se te enviará un correo electrónico cuando la importación se haya completado.

3. Repite estos pasos si quieres importar más de un espacio de Confluence.

• Notion importa todo en un único espacio raíz/principal de la sección privada o en un espacio de equipo seleccionado por la persona que realiza la importación.

• Los usuarios deberían ordenar y configurar la arquitectura del espacio de trabajo antes de invitar a otras personas.

• Los permisos deben volver a aplicarse en Notion: planifica una revisión posterior a la importación para asignar los grupos y las restricciones de Confluence a los grupos, los espacios de equipo y los permisos a nivel de página de Notion.

• Si hay archivos o adjuntos en una tabla de Confluence, esta se convertirá en una base de datos de Notion; de lo contrario, pasará a ser una tabla simple.

• Los estilos de tablas, las macros y los complementos suelen verse afectados (por ejemplo, los pasos de la interfaz de usuario, los destacados y los pies de foto de las imágenes).

• La mayoría de las macros no son compatibles. Notion intenta asignar los datos al bloque de Notion más cercano.

• Los fallos transitorios debidos a la falta de fiabilidad de la API de Confluence pueden hacer que falle la importación en su conjunto o que fallen determinadas páginas. Es posible que debas volver a intentar toda la importación.

• Si tienes varios espacios, realiza las importaciones de forma secuencial (un solo espacio detrás de otro), a menos que utilices la importación de varios espacios (solo en los planes Business/Enterprise).

• Ten en cuenta que pueden producirse errores de importación con datos complejos de Confluence (por ejemplo, celdas combinadas o tablas dentro de tablas).

• Notion solo admite tokens de API con alcance de usuario (no tokens con alcance). Usa la opción de token de API personal al autenticarte.

• Los archivos adjuntos y los elementos multimedia a los que no se haga referencia en las páginas no se importarán.

• En ocasiones, la jerarquía no se conserva en su totalidad. Haz una importación de prueba para comprobarlo primero.

• Los bloques matemáticos de LaTeX no se importan correctamente

  • Por qué sucede esto: El formato de macro de bloque del plugin LaTeX de Confluence difiere del formato de matemáticas en línea. Notion admite macros LaTeX en línea, pero no la variante de macro de bloque.

  • Solución: convierte las macros de bloques de LaTeX en macros integradas en Confluence antes de volver a importarlas, o coloca el LaTeX en un bloque de código y conviértelo en un bloque de matemáticas manualmente después de la importación.

• No se puede importar contenido de Gliffy

  • Por qué ocurre esto: el importador de archivos de Notion no admite las imágenes de Gliffy.

  • Solución: modifica el HTML para reemplazar el bloque de Gliffy por un bloque de imágenes que haga referencia al archivo correcto antes de importarlo.

• La importación da error

  • Por qué ocurre esto: por espacios muy grandes, exportaciones con formato incorrecto, límites de tasa o tiempos de espera agotados.

  • Solución: importa un espacio a la vez, divide los espacios grandes en secciones, vuelve a exportar un archivo ZIP sin errores o usa el importador de API con ejecuciones limitadas.

• En la importación faltan imágenes o archivos adjuntos

  • Por qué ocurre esto: es posible que los recursos no estén incluidos en la exportación o que el token de la API no pueda acceder a ellos.

  • Solución: asegúrate de seleccionar la opción "Incluir archivos adjuntos" en la exportación, mantén intactas las rutas relativas en el archivo ZIP o vuelve a subir los recursos clave después de la importación.

• Las vistas previas de los enlaces de Jira no funcionan después de la importación

  • Por qué ocurre esto: las vistas previas de los enlaces de Jira solo funcionan si el usuario se autentica antes de iniciar la migración.

  • Solución: autentícate en Jira antes de ejecutar la migración.

• La jerarquía de archivos no se mantiene como se esperaba

  • Por qué ocurre esto: casos extremos en la estructura de exportación o anidamiento profundo.

  • Solución: primero, prueba con un subconjunto representativo. Reorganiza el contenido en Notion después de la importación.

• Se pierden las macros o el formato especial de Confluence:

  • Por qué ocurre esto: las macros o el contenido de la aplicación no son compatibles.

  • Para solucionar esto: Asigna a bloques nativos de Notion: Ampliar → Desplegable, Action items → elementos de acción. Simplifica tablas complejas o expórtalas a CSV e impórtalas a una base de datos de Notion.

• Los permisos de Confluence no se replican en Notion:

  • Por qué ocurre esto: es un resultado normal en las importaciones autogestionadas.

  • Solución: planifica y asigna permisos después de que el contenido se importe a Notion, utilizando grupos, espacios de equipo y permisos a nivel de página de Notion.