Importeren vanuit Confluence

Het is belangrijk om al je gegevens op één plek te hebben. Hier is een handige handleiding voor het importeren van je Confluence-space in Notion. Afhankelijk van je behoeften zijn er twee manieren om vanuit Confluence naar Notion te importeren.

• Zip-bestand-importeur: Kan worden gebruikt om slechts een deel van je werkruimte te importeren. Kan alleen kleinere werkruimtes van maximaal 5 GB (of 15 GB op aanvraag) importeren.

• API-importeur: Kan alleen de volledige werkruimte importeren. Kan werkruimtes van maximaal 30 GB importeren. Behoudt opmerkingen en gebruikerstoewijzing.

Import van meerdere spaces: Er kunnen maximaal 10 Confluence-spaces tegelijk direct via de UI worden geïmporteerd. Elke geselecteerde Confluence-space genereert een eigen log pagina en wordt geïmporteerd als een afzonderlijke privépagina op het hoogste niveau (indien nodig in verschillende Notion-teamspaces). Deze functie is alleen beschikbaar voor Business- en Enterprise-abonnementen.

• Confluence-site → Notion-organisatie

• Confluence-space → Notion-workspace

• Confluence-pagina → Notion-pagina

• Macro's → platte inhoud of het dichtstbijzijnde Notion-bloktype (bijv. Confluence Expand → Notion Toggle)

• Importeer tot ~50k pagina's of 30GB aan grootte. Grotere imports kunnen mislukken.

  • Tip: Splits voor grote spaces de exports op per sub-space of sectie en gebruik de ZIP-importer. Als de workspace groter is dan 100GB, neem dan contact op met je accountmanager.

• Zodra de import begint, kun je je browser veilig sluiten — we sturen je een e-mail wanneer deze voltooid is.

• Bekijk de voortgang van je import in Instellingen → Importeren. Daar kun je de status van je import en voltooide importen zien.

Exporteer je Confluence-space naar HTML

1. Ga vanuit je Confluence-workspace naar Space Settings in de zijbalk rechtsboven.

2. Selecteer Content Tools in de bovenste werkbalk en vervolgens Export. Als je een van deze opties niet ziet, moet je mogelijk toestemming vragen om te exporteren aan een workspace-beheerder.

3. Selecteer HTML uit de lijst met indelingen.

4. Selecteer Custom Export en vink het vakje Include comments uit.

5. Selecteer welke pagina's je wilt exporteren. Let op: pagina's met grote bijlagen kunnen de grootte en complexiteit van de export aanzienlijk vergroten.

6. Wacht tot de export klaar is met verwerken. Dit kan even duren bij grote workspaces.

7. Zodra de export voltooid is, klik je op Download om de export op je computer op te slaan. Het bestand krijgt een naam zoals Confluence-space-export-XXXXXX.html.zip.

Importeren naar Notion

1. Ga naar de Notion-workspace waarin je je Confluence-content wilt importeren.

2. Ga naar Instellingen in je zijbalk → Importeren → Third party imports → Confluence.

3. Navigeer naar het .zip-bestand dat uit Confluence is geëxporteerd en selecteer het om te uploaden. Je hoeft het bestand niet uit te pakken - upload het volledige archief.

4. Je ziet een \"Uploading...\"-bericht terwijl de browser je bestand uploadt, gevolgd door een statusbericht naarmate de import vordert.

5. Wanneer je import is voltooid, word je naar je zojuist geïmporteerde inhoud geleid.

Verbind Confluence en Notion

1. Ga naar Instellingen in je zijbalk → Importeren → Confluence.

2. Kies Import via API.

3. Selecteer je Confluence-instantietype: cloud of server. Om je instantietype te vinden, open je Confluence, klik je op Help → ? naast je profiel → About Confluence. Notion ondersteunt alleen cloud- en serverinstanties.

Authenticeren met Confluence Cloud

1. Voer je Confluence-e-mailadres en -site in.

2. Maak een API-token aan vanuit je Atlassian-account en voer deze in het veld in. Lees meer over het aanmaken van tokens in Confluence.

3. Klik op Authenticate.

Authenticeren met Confluence Server

1. Zoek en selecteer je Confluence versie.

2. Voer je Confluence-e-mailadres en -site in.

3. Als je Confluence 7.9 of later gebruikt, maak dan een Personal Access Token aan en plak deze. Als je een eerdere versie gebruikt, voer dan je Confluence-gebruikersnaam en -wachtwoord in.

4. Klik op Authenticate.

Importeren

1. Klik op Confluence in het menu import.

2. Volg de voortgang van je import — deze stap kan enkele uren duren voor grote spaces.

   • Zodra je Importing pages… ziet, kun je je browservenster veilig sluiten. We sturen je een e-mail zodra de import is voltooid.

3. Herhaal dit gedeelte als je meer dan één Confluence-space wilt importeren.

• Notion importeert alles naar een enkele root/bovenliggend item in het Privé-gedeelte, of naar een geselecteerde teamspace van de persoon die de import uitvoert.

• Van gebruikers wordt verwacht dat ze de workspace-architectuur opschonen en inrichten voordat ze anderen uitnodigen.

• Machtigingen moeten opnieuw worden toegepast in Notion — plan een controle na de import om Confluence-groepen en -beperkingen toe te wijzen aan Notion-groepen, Teamspaces en machtigingen op paginaniveau.

• Als er bestanden of bijlagen in een Confluence-tabel staan, wordt dit een Notion-database; anders wordt het een eenvoudige tabel.

• Tabelstijlen en macro's/plug-ins verslechteren vaak (bijv. ui-steps, markeringen, onderschriften).

• De meeste macro's worden niet ondersteund. Notion probeert gegevens toe te wijzen aan het dichtstbijzijnde Notion-blok.

• Tijdelijke mislukkingen door onbetrouwbaarheid van de Confluence API kunnen ertoe leiden dat de algehele import of bepaalde pagina's mislukt. Mogelijk moet je de volledige import opnieuw proberen.

• Voer voor meerdere spaces imports opeenvolgend uit (één space per keer), tenzij je import voor meerdere spaces gebruikt (alleen Business/Enterprise).

• Importmislukkingen kunnen optreden bij gecompliceerde Confluence-gegevens (bijv. samengevoegde cellen, tabellen in tabellen).

• Notion ondersteunt alleen API-tokens met gebruikersbereik (geen tokens met bereik). Gebruik de optie voor persoonlijke API-tokens bij het authenticeren.

• Bijlagen en media waarnaar niet op pagina's wordt verwezen, worden niet geïmporteerd.

• De hiërarchie wordt soms niet volledig behouden — valideer dit door eerst een pilot uit te voeren met Importeren.

• LaTeX Math-blokken worden onjuist geïmporteerd

  • Waarom dit gebeurt: De blokmacro-indeling van de Confluence LaTeX-plug-in verschilt van inline wiskunde. Notion ondersteunt inline LaTeX-macro's, maar niet de blokmacro-variant.

  • Oplossing: Converteer LaTeX-blokmacro's naar inline macro's in Confluence voordat je opnieuw importeert, of plaats de LaTeX in een codeblok en converteer deze handmatig naar een /berekening-blok na Importeren.

• Kan Gliffy-inhoud niet importeren

  • Waarom dit gebeurt: Notion ondersteunt geen Gliffy-afbeeldingen via de bestandsimporteur.

  • Oplossing: Wijzig de HTML om het Gliffy-blok te vervangen door een afbeeldingsblok dat naar het juiste bestand verwijst voordat u het importeert.

• Importeren mislukt

  • Waarom dit gebeurt: Zeer grote spaces, onjuist gevormde exports, snelheidslimieten of time-outs.

  • Oplossing: Importeer één space tegelijk, splits grote spaces in secties, exporteer opnieuw een schone ZIP of gebruik de API-importer met scoped runs.

• Importeren mist afbeeldingen of bijlagen

  • Waarom dit gebeurt: Assets zijn mogelijk niet gebundeld in de export of niet bereikbaar via het API-token.

  • Oplossing: Zorg dat \"Bijlagen opnemen\" is geselecteerd bij het exporteren, houd relatieve paden intact in de ZIP of upload belangrijke assets opnieuw na de import.

• Jira Voorbeeld van link zijn defect na Importeren

  • Waarom dit gebeurt: Jira Voorbeeld van link werken alleen als de gebruiker is geauthenticeerd voordat de migratie wordt gestart.

  • Oplossing: Authenticeer bij Jira voordat je de migratie uitvoert.

• Hiërarchie van bestanden wordt niet behouden zoals verwacht

  • Waarom dit gebeurt: Randgevallen in de exportstructuur of diepe nesting.

  • Oplossing: Test eerst met een representatieve subset; reorganiseer in Notion na Importeren.

• Confluence-macro's en/of speciale opmaak zijn verloren gegaan:

  • Waarom dit gebeurt: Niet-ondersteunde macro's of app-inhoud.

  • Oplossing: Wijs toe aan Notion-eigen blokken: Expand → Toggle, Actie-items → To-do. Vereenvoudig complexe tabellen of exporteer naar CSV en importeer in een Notion-database.

• Confluence-machtigingen worden niet gerepliceerd in Notion:

  • Waarom dit gebeurt: Dit is te verwachten bij self-serve importeren.

  • Oplossing: Plan en voer een machtigingstoewijzing uit nadat de content in Notion is geplaatst, met behulp van Notion-groepen, teamspaces en machtigingen op paginaniveau.