Importation Confluence

Centraliser toutes vos données est important. Ce tutoriel vous explique comment importer votre espace Confluence dans Notion. En fonction de vos besoins, il existe deux façons d’importer des données de Confluence vers Notion.

• Importateur de fichiers Zip : peut uniquement importer une partie de l’espace de travail. Jusqu’à 5 Go par espace de travail (ou 15 Go sur demande).

• Importateur d’API : peut uniquement importer l’intégralité de l’espace de travail. Jusqu’à 30 Go par espace de travail. Conserve les commentaires et la correspondance entre les utilisateurs et utilisatrices.

Importations multi-espaces : jusqu’à 10 espaces Confluence peuvent être importés à la fois, 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, selon les besoins). Cette fonctionnalité est disponible uniquement avec les forfaits Business et 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’à ~50 000 pages ou 30 Go. Les importations plus importantes peuvent échouer.

  • Astuce : Pour les espaces de grande taille, divisez les exportations par sous-espace ou par sections 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 importation dans Paramètres → Importer. Vous pouvez y consulter l’état de votre importation et 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 Outils de contenu dans la barre d’outils supérieure, puis Exporter. Si vous ne voyez aucune de ces options, vous devrez peut-être demander la permission pour exporter à l’administrateur de votre 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 de l’exportation. Le processus 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 portera un nom du type 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. Repérez le fichier ZIP exporté depuis Confluence et sélectionnez-le pour l’importer. Pas besoin de décompresser le fichier, vous pouvez importer l’archive telle quelle.

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 votre type d’instance Confluence : cloud ou server. Pour trouver votre type d’instance, ouvrez Confluence, cliquez sur Aide →? à côté de votre profil → À propos de 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 jeton d’accès personnel 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.

   • Dès que le message Importation des pages en cours… s’affiche, vous pouvez fermer la fenêtre de votre navigateur sans risque. 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 essaie d’associer les données au 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 réessayer l’importation dans son ensemble.

• 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 prend uniquement en charge les jetons API à portée utilisateur (et non les jetons à portée limité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 se produit : le format des macros en bloc du plugin LaTeX de Confluence diffère de celui des formules mathématiques intégrées. Notion prend en charge les macros LaTeX intégrés, mais pas la variante des macros en 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.

  • Solution : associez les blocs natifs Notion correspondants : Développer → Menu dépliant, Tâches à accomplir → Tâche. Simplifiez les tables complexes ou exportez-les au format CSV et importez-les 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.