Importation Confluence

Il est important de centraliser toutes vos données. Voici un tutoriel utile pour importer votre espace Confluence dans Notion. Selon vos besoins, il existe deux méthodes pour importer des données depuis Confluence vers Notion.

• Importateur de fichiers ZIP : Peut être utilisé pour n’importer qu’une partie de votre espace de travail. Ne peut importer que des espaces de travail plus petits, jusqu’à 5 Go (ou 15 Go sur demande).

• Importateur API : Ne peut importer que l’intégralité de l’espace de travail. Peut importer des espaces de travail allant jusqu’à 30 Go. Conserve les commentaires et le mappage des utilisateurs.

Importations multi-espaces : Jusqu’à 10 espaces Confluence peuvent être importés simultanément directement via l’interface utilisateur. Chaque espace Confluence sélectionné génère sa propre page de journal et est importé en tant que page privée de premier niveau distincte (dans différents espaces d’équipe Notion si nécessaire). Cette fonctionnalité n’est disponible que pour les forfaits Business et Forfait Enterprise.

• Site Confluence → Organisation Notion

• Espace Confluence → Espace de travail Notion

• Page Confluence → Page Notion

• Macros → contenu aplati ou type de bloc Notion le plus proche (par exemple, Développer sur Confluence → Menu dépliant sur Notion)

• Importez jusqu’à ~50k pages ou 30GB. Les importations plus volumineuses peuvent échouer.

  • Conseil : Pour les grands espaces, divisez les exportations par sous-espace ou par section et utilisez l’importateur ZIP. Si la taille de l’espace de travail est supérieure à 100 Go, contactez votre gestionnaire de compte.

• Une fois l’importation lancée, vous pouvez fermer votre navigateur sans risque : nous vous enverrons un e-mail une fois l’opération terminée.

• Suivez la progression de votre opération d’importation dans Settings → Import. Vous pourrez y consulter l’état de cette opération et suivre les importations terminées.

Exportez votre espace Confluence au format HTML

1. Dans votre espace de travail Confluence, allez dans Paramètres de l’espace dans la barre latérale en haut à droite.

2. Sélectionnez Content Tools dans la barre d’outils supérieure, puis Export dans la barre d’outils en dessous. Si vous ne voyez aucune de ces options, vous devrez peut-être demander l’autorisation d’exporter à un administrateur de l’espace de travail.

3. Sélectionnez HTML dans la liste des formats.

4. Sélectionnez Exportation personnalisée et décochez la case Inclure les commentaires.

5. Sélectionnez les pages que vous souhaitez exporter. Notez que les pages contenant des pièces jointes volumineuses peuvent augmenter considérablement la taille et la complexité de l’exportation.

6. Attendez la fin du processus d’exportation. Cela peut prendre un certain temps pour les espaces de travail de grande taille.

7. Une fois l’opération terminée, cliquez sur Télécharger pour enregistrer l’exportation sur votre ordinateur. Le fichier sera intitulé quelque chose comme Confluence-space-export-XXXXXX.html.zip.

Importer dans Notion

1. Accédez à l’espace de travail Notion dans lequel vous souhaitez importer votre contenu Confluence.

2. Dans la barre latérale, cliquez sur Paramètres → Importer → Importations tierces → Confluence.

3. Retrouvez le fichier .zip exporté depuis Confluence et sélectionnez-le pour l’importer. Vous n’avez pas besoin de décompresser le fichier ; importez l’archive entière.

4. Vous devriez voir un message « Chargement… » pendant que le navigateur charge votre fichier, puis un autre message indiquant l’état de l’importation.

5. Une fois l’importation terminée, vous serez redirigé·e vers votre nouveau contenu.

Connectez Confluence et Notion

1. Dans la barre latérale, cliquez sur Paramètres → Importer → Confluence.

2. Choisissez Importer à partir de l’API.

3. Sélectionnez le type de votre instance Confluence : cloud ou server. Pour trouver le type de votre instance, ouvrez Confluence, cliquez sur Help → ? à côté de votre profil → About Confluence. Notion ne prend en charge que les instances cloud et server.

Pour s’authentifier avec une instance Confluence Cloud :

1. Saisissez l’adresse e-mail et le site que vous utilisez pour Confluence.

2. Créez un jeton API depuis votre compte Atlassian et saisissez-le dans ce champ. En savoir plus sur la création de jetons dans Confluence →.

3. Cliquez sur Authentifier.

Pour s’authentifier avec une instance Confluence Server :

1. Recherchez votre version de Confluence ici.

2. Saisissez l’adresse e-mail et le site que vous utilisez pour Confluence.

3. Si vous utilisez Confluence 7.9 ou une version ultérieure, créez un Personal Access Token et collez-le. Si vous utilisez une version antérieure, saisissez votre nom d’utilisateur et votre mot de passe Confluence.

4. Cliquez sur Authentifier.

Importation

1. Dans le menu Importer, cliquez sur Confluence.

2. Suivez la progression de l’importation ; cette opération peut prendre plusieurs heures pour les espaces de grande taille.

   • Lorsque le message Importing pages… s’affiche, vous pouvez fermer la fenêtre de votre navigateur en toute sécurité. Nous vous enverrons un e-mail une fois l’importation terminée.

3. Pour importer d’autres espaces Confluence, répétez cette procédure.

• Notion importe tout dans un seul espace racine/parent de la section privée, ou dans l’espace d’équipe sélectionné par la personne qui effectue l’importation.

• Il est recommandé de nettoyer et de configurer l’architecture de l’espace de travail avant d’inviter d’autres personnes.

• Les autorisations doivent être réattribuées dans Notion : prévoyez une étape après l’importation pour associer les groupes et les restrictions Confluence aux groupes Notion, aux espaces d’équipe et aux autorisations au niveau des pages.

• Si une table Confluence contient des fichiers ou des pièces jointes, il deviendra une base de données Notion ; dans le cas contraire, il deviendra un tableau simple.

• Les styles de table et les macros/plug-ins sont souvent dégradés (par exemple, les ui-steps, les encadrés, les légendes d’images).

• La plupart des macros ne sont pas prises en charge. Notion tente de mapper les données vers le bloc Notion le plus proche.

• Des échecs temporaires dus au manque de fiabilité de l’API Confluence peuvent entraîner l’échec de l’importation globale ou de certaines pages. Vous devrez peut-être relancer l’importation complète.

• Pour plusieurs espaces, exécutez les importations de manière séquentielle (un espace à la fois), sauf si vous utilisez l’importation multi-espaces (forfaits Business/Enterprise uniquement).

• Des échecs d’importation peuvent survenir avec des données Confluence complexes (par exemple, des cellules fusionnées, des tables à l’intérieur de tables).

• Notion ne prend en charge que les jetons d’API à portée utilisateur (et non les jetons à portée). Utilisez l’option de jeton d’API personnel lors de l’authentification.

• Les pièces jointes et les médias qui ne sont pas référencés sur les pages ne seront pas importés.

• La hiérarchie n’est parfois pas entièrement préservée : validez-la en effectuant une importation pilote.

• Les blocs mathématiques LaTeX ne s’importent pas correctement

  • Pourquoi cela arrive : Le format de macro de bloc du plugin LaTeX de Confluence diffère de celui des mathématiques en ligne. Notion prend en charge les macros LaTeX intégrées, mais pas la variante de macro de bloc.

  • Solution : convertissez les macros LaTeX en bloc en macros LaTeX intégrés dans Confluence avant de procéder à la réimportation, ou placez le LaTeX dans un bloc de code et convertissez-le manuellement en bloc mathématique après l’importation.

• Impossible d’importer du contenu Gliffy

  • Pourquoi cela se produit : Notion ne prend pas en charge les images Gliffy via l’importateur de fichiers.

  • Solution : avant d’importer, modifiez le code HTML afin de remplacer le bloc Gliffy par un bloc image faisant référence au fichier approprié.

• L’importation échoue

  • Pourquoi cela se produit : espaces de très grande taille, exportations mal formées, limites de débit ou délais d’attente dépassés.

  • Solution : importez un espace à la fois, divisez les grands espaces en sections, réexportez un fichier ZIP propre ou utilisez l’importateur d’API avec des exécutions limitées.

• Des images ou pièces jointes sont manquantes après l’importation

  • Pourquoi cela se produit : les ressources peuvent ne pas être incluses dans l’exportation ou ne pas être accessibles via le jeton API.

  • Solution : assurez-vous que l’option « Inclure les pièces jointes » est sélectionnée lors de l’exportation, conservez les chemins relatifs intacts dans le fichier ZIP ou téléchargez à nouveau les ressources clés après l’importation.

• Les aperçus de liens Jira ne fonctionnent plus après l’importation

  • Pourquoi cela se produit : les aperçus de liens Jira ne fonctionnent que si l’utilisateur ou l’utilisatrice est authentifié·e avant de lancer la migration.

  • Solution : authentifiez-vous sur Jira avant d’effectuer la migration.

• La hiérarchie des fichiers n’est pas conservée comme prévu

  • Pourquoi cela se produit : cas particuliers dans la structure d’exportation ou imbrication profonde.

  • Solution : effectuez d’abord un test avec un sous-ensemble représentatif ; réorganisez dans Notion après l’importation.

• Les macros Confluence et/ou la mise en forme spéciale sont perdues :

  • Pourquoi cela se produit : macros ou contenu d’application non pris en charge.

  • Pour corriger : Mappez vers des blocs natifs Notion : Agrandir → Menu dépliant, Tâches à accomplir → To-do. Simplifiez les tableaux complexes ou exportez-les au format CSV pour les importer dans une base de données Notion.

• Les autorisations Confluence ne sont pas reproduites dans Notion :

  • Pourquoi cela se produit : ceci est normal pour les importations en libre-service.

  • Solution : prévoyez et effectuez une attribution des autorisations après l’importation du contenu dans Notion, en utilisant les groupes Notion, les espaces d’équipe et les autorisations au niveau des pages.