Appearance

Migration des articles de Umbraco v6/v7 vers v13 (en cours) ​

Description ​

Ce document décrit le processus de migration des articles depuis Umbraco version 6 ou 7 (compatibles avec les starterkits v2 et v3) vers la version 13.

Processus de migration ​

1. Export des articles ​

Une requête SQL est utilisée afin d'exporter l'ensemble des articles dans un fichier JSON.

Important : s'assurer que les correspondances de champs (field mappings) sont correctes entre l'ancien schéma et le nouveau.

Export JSON complet depuis la base de données Umbraco ​

Étapes :

  1. Ouvrir SQL Server Management Studio (SSMS)
    Se connecter au serveur

  2. Clic droit sur la base de données
    Sélectionner :
    Tasks > Export Data...

  3. Source de données

    • Choisir : SQL Server Native Client
    • Renseigner les identifiants pour : vmsqla
      (Utiliser un login SQL)

  4. Destination

    • Choisir : Flat File Destination
    • Nom du fichier : définir un chemin tel que C:\export\articles.txt
    • Code page : sélectionner 1252 (ANSI - Latin I)

  5. Spécifier la table ou la requête

    • Choisir : Write a query to specify the data to transfer

  6. Coller la requête SQL
    Coller la requête personnalisée utilisant FOR JSON PATH.

  7. Finaliser l'assistant

    • Poursuivre les étapes restantes
    • Vérifier le mapping des colonnes si nécessaire
    • Finaliser et lancer l'export

  8. Résultat
    Un fichier .txt contenant le JSON exporté est généré.

2. Import des articles ​

Un contrôleur Umbraco parcourt le fichier JSON et recrée l'ensemble des articles avec leur contenu.

3. Export des médias ​

Les médias liés aux articles suivent le même workflow :

  • Export de la structure des médias en JSON via une requête SQL
  • Recréation des noeuds médias via un contrôleur

4. Recréation des noeuds médias ​

Le processus de recréation des médias est le suivant :

  1. Recréer les noeuds médias dans Umbraco
  2. Surcharger le chemin par défaut avec le chemin d'origine des médias afin de conserver le même nom de fichier
  3. Copier l'ancien dossier des médias vers la nouvelle installation

Cette approche garantit la cohérence des chemins de fichiers et des références.

Projets de référence ​

Des exemples d'implémentation complète sont disponibles dans les projets suivants :

  • apol-website
  • accm-content-headless

Dans le dossier /migrations, vous trouverez :

  • Les scripts SQL d'export
  • L'ensemble de la documentation et des requêtes liées à la migration

Les contrôleurs d'import se trouvent directement dans le code source des projets.

Contributors

The avatar of contributor named as Clément Favre Clément Favre

Changelog