Importar desde Confluence

Es importante tener la información en un solo lugar. Por ese motivo, te presentamos un tutorial muy útil para importar tu espacio de Confluence a Notion. Según tus necesidades, hay dos formas de 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 pequeños, de hasta 5 GB (o 15 GB previa solicitud).

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

Importaciones de varios espacios: Se pueden importar hasta 10 espacios de Confluence a la vez directamente a través de la interfaz de usuario. Cada espacio de Confluence seleccionado genera su propia página de registro y se importa como una página privada principal e 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)

• Funciona bien hasta llegar aproximadamente a las 50 000 páginas o a los 30 GB de tamaño. Es posible que haya fallos en las importaciones grandes.

  • Consejo: en el caso de espacios grandes, divide las importaciones por subespacios o secciones y usa el importador de ZIP. Si el tamaño del espacio de trabajo es superior a 100 GB, contacta al administrador de tu cuenta.

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

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 (herramientas de contenido) en la barra de herramientas superior y, a continuación, Export (exportar). Si no ves alguna de estas opciones, es posible que necesites solicitar permiso para exportar al 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. Selecciona las páginas que quieres exportar. Ten en cuenta que las páginas que contienen archivos adjuntos grandes pueden aumentar considerablemente tanto el tamaño como la complejidad de la exportación.

6. Espera a que finalice el proceso de exportación. Este proceso puede tardar algún tiempo en el caso de espacios de trabajo grandes.

7. Una vez que haya terminado, haz clic en Descargar para guardarla en tu computadora. El archivo tendrá un nombre similar al siguiente: 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. Ve a Configuración en tu barra lateral → Importar → Confluence.

3. Ve al archivo .zip exportado desde Confluence y selecciónalo para subirlo. No es necesario que descomprimas el archivo, puedes subirlo entero.

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 tu tipo de instancia de Confluence: nube o servidor. Para encontrar el tipo de instancia, abre Confluence y haz clic en Ayuda →? junto a tu perfil → Acerca de Confluence. Notion solo admite instancias en la nube y del servidor.

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 utilizando Confluence 7.9 o posterior, crea un Personal Access Token (token de acceso personal) y pégalo. Si usas una versión anterior, ingresa tu nombre de usuario y tu 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.

   • Una vez que veas Importando páginas…, puedes cerrar la ventana del navegador de forma segura. 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 similar.

• 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 tengas que volver a iniciar 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 es compatible con los tokens de API con alcance de usuario (no con los 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é ocurre esto: el formato de las macros de bloque del complemento LaTeX de Confluence difiere del de las matemáticas integradas. Notion admite las macros LaTeX integradas, 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.

  • Solución: asigna bloques nativos de Notion: Expandir → Desplegable, Elementos de acción → Tarea pendiente. Simplifica las tablas complejas, o expórtalas a CSV e impórtalas en 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.