De Confluence à Polybase : guide pratique de migration
Passez de Confluence à Polybase avec un audit des documents, une conversion DOCX et des contrôles sur les liens, les droits d’accès et la structure des pages. Pilotez une migration maîtrisée.Sujet Gestion des connaissancesPublié le 8 septembre 2026Temps de lecture 5 minAuteur Polybase
Quitter Confluence est un projet de gestion des connaissances. Le travail est achevé lorsque chacun peut trouver un document de référence, savoir qui en est responsable et l’utiliser dans le projet où il compte. Un dossier de pages exportées n’est qu’un point de départ, pas un critère de réussite.
Ce guide décrit une migration maîtrisée de Confluence vers Polybase pour les équipes qui veulent rapprocher la documentation des conversations et des tâches. Polybase prend en charge l’import DOCX, l’édition partagée de documents et la recherche plein texte. La démarche ci-dessous porte sur des documents relus ; elle ne suppose ni un importeur natif d’espaces Confluence, ni la conservation automatique des macros, des droits d’accès et de l’historique des pages.
1. Faire l’inventaire des connaissances réellement utiles
Demandez à chaque équipe d’identifier ses documents d’exploitation essentiels : consignes d’accueil, spécifications produit, notes de passation client et procédures en vigueur. Pour chaque page, notez l’URL source, le responsable, le public visé, la dernière relecture et la destination prévue. Distinguez la personne qui a créé une page de celle qui répond aujourd’hui de son exactitude.
Attribuez l’une de ces quatre issues : déplacer, réviser, fusionner ou archiver. Deux procédures contradictoires doivent être tranchées avant le transfert ; sinon, le nouvel espace hérite des mêmes incertitudes. Commencez par un lot limité de documents très consultés, dont les responsables peuvent contrôler le résultat.
2. Choisir un export et tester le format des documents
Confluence Cloud propose, depuis le menu de la page, un export Word ou PDF page par page. Atlassian précise que l’export Word requiert Microsoft Word et que les modifications non publiées sont exclues. Vérifiez le contenu publié avant d’exporter et consultez la documentation de votre édition.
Pour obtenir un document Polybase modifiable, ouvrez l’export Word dans Microsoft Word et enregistrez un véritable fichier DOCX, puis testez-le avec l’import DOCX de Polybase. Renommer une extension n’est pas une conversion. Contrôlez les titres, les tableaux, les images et les liens sur un petit échantillon avant de traiter le reste. Conservez un export de référence distinct si votre politique de conservation l’exige.
Un PDF peut offrir une copie de lecture utile, mais ce n’est pas le même livrable qu’une page de base de connaissances modifiable. Déterminez quels documents demandent une collaboration continue et lesquels doivent seulement rester consultables. Pour les espaces volumineux, convenez de la méthode de conversion et de validation avant de lancer un transfert en masse.
3. Cartographier la structure des pages, les macros et les relations
Concevez la destination en partant de la façon dont les gens retrouvent l’information. Une équipe produit peut avoir besoin des spécifications à côté des discussions de projet ; une équipe d’exploitation, d’une bibliothèque de procédures où chaque document a un responsable clairement identifié. Conservez la hiérarchie utile en écartant les branches abandonnées et les pages d’accueil en double.
Le tableau ci-dessous est un plan de revue, non une liste de fonctions migrées automatiquement. Les rapports Jira intégrés, les macros dynamiques et les pages incluses méritent une attention particulière : le contenu visible peut n’être que l’instantané d’un élément qui se mettait auparavant à jour en direct.
| Élément source | Traitement prévu | Contrôle d’acceptation |
|---|---|---|
| Espace et arborescence des pages | Canaux, dossiers et documents de destination | Les lecteurs accèdent au bon document |
| Texte, titres et tableaux | Import DOCX relu | Le sens et la mise en page essentielle sont préservés |
| Macros et rapports intégrés | Recréer, remplacer ou conserver une référence datée | Les lecteurs savent si le contenu est actualisé en direct |
| Pièces jointes et liens internes | Déplacer les fichiers nécessaires et tenir une table de correspondance des URL | Les fichiers s’ouvrent et les liens mènent à la bonne destination |
| Commentaires et historique des versions | Référence distincte ou méthode de conservation convenue | L’historique des décisions requis reste accessible |
4. Reconstruire les droits d’accès avant d’inviter les lecteurs
Traitez le contenu exporté et les règles d’accès comme deux sujets distincts. Définissez le public visé dans le nouvel espace et testez des comptes de membre ordinaire, de membre restreint et d’invité lorsque ces rôles sont pertinents. Un contrôle réussi doit montrer à la fois qu’une personne autorisée peut lire la page et qu’une personne non autorisée ne le peut pas.
Ne vous fiez pas à des noms de groupes identiques d’une plateforme à l’autre. Notez quelles personnes ou équipes doivent avoir accès et vérifiez directement les réglages de destination. Soyez particulièrement attentif à une page enfant restreinte déplacée sous un dossier largement visible. Examinez les liens de partage de fichiers séparément de l’accès aux documents.
5. Réparer les liens et établir la nouvelle source de référence
Tenez un registre de correspondance entre URL sources et URL de destination. Servez-vous-en pour mettre à jour les liens des briefs de projet en cours, des listes d’accueil, des descriptions de tâches et des pages de référence très consultées. Lorsque vous maîtrisez l’ancienne page et pouvez en conserver l’accès, ajoutez un avis de déménagement clair. Ne promettez pas de redirections automatiques pour des URL contrôlées par une autre plateforme.
Fixez une fenêtre de modification finale pour chaque groupe de pages, relevez les changements intervenus après le premier export et demandez aux responsables des contenus de valider la destination. Passez l’ancienne version en lecture seule si votre configuration le permet. Indiquez aux lecteurs où déposer les corrections à venir, afin que deux versions concurrentes ne continuent pas d’évoluer.
Après le lancement, demandez à un collègue qui n’a pas participé à la migration de retrouver la procédure en vigueur, d’en identifier le responsable et d’en suivre les liens. Mesurez les recherches infructueuses, les liens cassés et les pages sans responsable. Passez ces exceptions en revue régulièrement jusqu’à ce que la bibliothèque serve ses lecteurs, plutôt que de retenir le seul nombre de documents comme mesure d’achèvement.
- Chaque document essentiel a un responsable et une date de revue convenue.
- Les titres, les tableaux et les fichiers liés ont été vérifiés sur des pages représentatives.
- Les contrôles d’accès incluent des personnes qui ne doivent pas voir les contenus restreints.
- Les liens entrants actifs pointent vers la nouvelle source ou vers un avis de déménagement clair.
- Les responsables des contenus valident la version finale et savent comment signaler un problème.
Questions fréquentes
Peut-on importer un espace Confluence dans Polybase en un clic ?
Ce guide ne décrit pas d’importeur d’espaces en un clic. Il s’appuie sur une conversion de documents relue et sur l’import DOCX. La hiérarchie des pages, les macros, les pièces jointes, les droits d’accès et les données historiques demandent une préparation et une validation distinctes.
Les macros Confluence et l’historique des pages resteront-ils modifiables ?
Ne présumez pas qu’un export de document conserve les macros dynamiques ou l’historique d’origine des révisions. Décidez quels éléments doivent être recréés et lesquels peuvent rester à titre de référence. Vérifiez la méthode retenue sur des contenus représentatifs.
Faut-il migrer Jira et Confluence en même temps ?
Ils peuvent partager un même plan de migration, surtout lorsque des tâches renvoient à des spécifications. Gardez des contrôles d’acceptation distincts pour les tâches et pour les documents, et tenez un seul registre d’URL afin de pouvoir réparer les relations même si les deux systèmes basculent à des moments différents.