Hoe je van Contentful migreert zonder je contentmodel te verliezen

Je Contentful-rekening is net over de duizend euro per maand gegaan en je begint naar alternatieven te kijken. ContentGrid ondersteunt dezelfde use cases voor ongeveer een vijfde van de prijs, maar de migratie voelt zwaar aan als je tientallen contenttypes en duizenden entries hebt. Dat hoeft niet zo te zijn. De meeste teams ronden de overstap binnen twee dagen af.

Exporteer je Contentful-contentmodel

Begin met het schema, niet met de entries. Gebruik de Contentful CLI om je space te exporteren:

• Voer contentful space export --space-id JOUW_SPACE_ID uit voor een JSON-dump van je contenttypes en entries.
• Open het exportbestand en noteer elk contenttype, de bijbehorende velden en de veldtypen (Symbol, RichText, Link, Array).
• Maak een lijst van referentievelden die het ene contenttype aan het andere koppelen — deze vereisen speciale behandeling.

Probeer entries niet te migreren voordat je schema in ContentGrid is bevestigd. Schemaverschillen veroorzaken onzichtbaar dataverlies.

Herstel het schema in ContentGrid

ContentGrid gebruikt een schemagedreven model vergelijkbaar met Contentful. Maak voor elk contenttype in je export een overeenkomend type aan in het ContentGrid-dashboard of via de API. De koppeling van veldtypen is rechttoe rechtaan:

• Contentful Symbol → ContentGrid Short Text
• Contentful RichText → ContentGrid Rich Text
• Contentful Link (Entry) → ContentGrid Reference
• Contentful Array of Links → ContentGrid Reference List
• Contentful Media → ContentGrid Asset

Zodra alle typen zijn gedefinieerd, gebruik je de ContentGrid TypeScript SDK om het schema programmatisch te valideren voordat je entries importeert.

Migreer entries met een script

Schrijf een klein Node.js-script dat de Contentful-export-JSON inleest en elke entry via de Management API naar ContentGrid stuurt. Houd het eenvoudig:

• Loop over elk contenttype in volgorde van afhankelijkheid — typen zonder referenties als eerste.
• Koppel Contentful entry-ID's aan ContentGrid entry-ID's en sla de mapping op in een lokaal JSON-bestand.
• Gebruik voor referentievelden de opgeslagen ID-map om links te herschrijven voordat je ze post.
• Upload assets apart via het ContentGrid asset-endpoint en werk de ID-map bij.

Voer het script eerst uit tegen een ContentGrid-ontwikkelomgeving. Omgevingen in ContentGrid werken als Git-branches — je krijgt een volledige kopie van het schema en kunt importeren zonder productie aan te raken.

Update je front-end API-aanroepen

Als je Next.js gebruikt, is je data-fetchinglaag waarschijnlijk geïsoleerd in een lib/contentful.ts-bestand. Vervang de Contentful SDK-aanroepen door ContentGrid SDK-aanroepen en houd de responsstructuur identiek. Je page-componenten hoeven niet te worden aangepast. Zodra de import is geverifieerd en je stagingomgeving er goed uitziet, wijs je de omgevingsvariabele naar productie en ben je klaar.

De migratie is grotendeels mechanisch werk. Het lastigste onderdeel is het in kaart brengen van geneste referentiestructuren, maar ook dat wordt eenvoudig zodra je de ID-map hebt. Teams die het schema eerst plannen en daarna de entry-migratiescripts schrijven, zijn sneller klaar en komen minder verrassingen tegen.