Introduction

Dans un premier temps, nous vous détaillons les étapes de migration des profiles qui vous seront proposées afin d’en saisir pleinement les intentions.

Puis nous listons les informations et particularités de la migration qui permettrons de mieux saisir ce qui est nécessaire pour finaliser proprement votre migrations

Penser à bien changer les screens de la documentation dès qu’un élément dans le code le change. Même si une traduction est modifiée !

Etapes de migration

• Etape 1 : Lancer la migration
  Depuis VSCode, executer la commande (ctrl+shift+P) Divalto : Migrate current project
  

• Etape 2 : Confirmation
  Une confirmation sera demandée par l’extension. Répondez oui pour continuer vers la migration du projet
  

• Etape 3 : Vérification de l'éligibilité du projet
  Une console s’ouvre dans la zone que vous avez configuré. Elle vous indique que la migration peut commencer (si votre projet n’est pas éligible à la migration des profils, nous ne déclenchons pas le processus).
  C’est à cet endroit que vous pourrez avoir le détail de progression de migration.
  

• Etape 4 : Récupération des données du projet
  L’extension va récupérer les données du projets permettant de savoir si le projet est déjà migré et ce qu’il faut migrer. Un message s’affichera dans la console lorsque les data sont récupérées.
  

• Etape 5 : Exporter la configuration spécifique
  Un message conseillera ensuite d’exporter la configuration spécifique du projet avant de démarrer la migration pour s’assurer d’en garder une copie et de pouvoir l’appliquer au besoin.
  Si ce n’est pas fait, annulez l’opération et exportez votre configuration. Vous relancerez la migration à l'étape 1 ensuite.
  

• Etape 6 : Définir les éléments à migrer
  Cette étape peut ne pas se présenter à vous. Elle analyse les données de l'étape 4 et si besoin, vous demandera de valider ou indiquer vos choix concernant des noms de feature ou capacité, ainsi que leur valeur par défaut pour pouvoir remplir la table sw_data_mappingOverload(valider ce nom de table).
  Quelques points sont à détailler dans cette étape :

  • Dépendant du volume de spécifique détecté à migrer, nous avons décidé d’appliquer une limite de 10 éléments pour ne pas imposer de devoir répondre à trop de question.
    Cependant, nous alertons et permettons de l'éviter.
    

  • Suite au point précédent, s’il y a des éléments en attente de traitement, une succession de questions vous seront posées.
    Comme inscrit dans le point suivant, ce n’est pas grave si vous vous trompez lors de la saisi de la réponse car le récapitulatif sera consultable avant migration dans la table sw_data_mappingOverload(valider ce nom de table).
    Voici une exemple des deux types de question posée :

    • Questions posées lorsque nous trouvons une feature ou capacité à migrer
      Tout d'abord, nous demandons de confirmer le nom à utiliser pour une feature ou capacité
      
      Puis nous demandons de confirmer la valeur de la feature ou capacité
      
      Dans la console, le récapitulatif sera affiché
      

    • Question posée lorsque nous trouvons une feature ou capacité à migrer avec plusieurs valeurs possibles
      Tout d'abord, nous demandons de confirmer le nom à utiliser pour une feature ou capacité
      
      Puis nous demandons de confirmer une des valeurs de la feature ou capacité.
      Comme le montre la capture d'écran, il est aussi possible de choisir une valeur différente.
      Si les valeurs ne sont pas satisfaisantes, vous pourrez la modifier directement dans la table sw_data_mappingOverload(valider ce nom de table). avant d’appliquer la migration.
      
      Dans la console, le récapitulatif sera affiché
      

    • Dès que tous les éléments sont traités, nous les insérons en base. Patientez jusqu’au prochain message indiquant que l’opération s’est terminée.
      

  • Que vous fassiez une erreur, que vous indiquiez vos choix ou non, tous les éléments seront injectés dans la table sw_data_mappingOverload(valider ce nom de table).
    Cette table permettra de vérifier ce qui sera migré et le modifier.
    

• Etape 7 : Migrer votre projet
  Lorsque vous avez bien exporté votre configuration spécifique, que vous avez fait les choix liés aux éléments spécifiques de votre projet et que vous avez vérifié la table sw_data_migrationOverload(valider ce nom de table), vous êtes prêt à lancer la migration des données, ainsi que la configuration spécifique de votre projet.
  Concernant les données :

  • Un message vous alertera que la migration des données est sur le point de s’effectuer et s’assurera que la table sw_data_mappingOverload(valider ce nom de table) a bien été consultée et validée.
    Vous avez le choix de ne pas le faire de suite.
    

  • Puis, un message vous alertera que la migration de la configuration est sur le point de s’effectuer.
    Vous avez le choix de seulement générer un rapport à titre de consultation, soit de migrer et générer le rapport.
    

• Etape 8 : Migration de la configuration en cours
  (WIP) Migration en cours. Consultez la console pour avoir l’avancement.
  

• Etape 9 :
  (WIP) Lecture du rapport et vérifications finales.
  Pour comprendre comment lire le rapport, référez-vous au lien de bas de page.
  Exemple de rapport :
  

(WIP) Etapes de migration lorsque le projet est déjà migré

• Etape 1 :
  Depuis VSCode, executer la commande (ctrl+shift+P) Divalto : Migrate current project
  

• Etape 2 :
  Une confirmation sera demandé par l’extension. Répondez oui pour continuer vers la migration du projet
  

• Etape 3 :
  showAllreadyMigratedMessageAsync

• Etape 4 :
  askMigrateDataAgainAsync

• Etape 5 :
  askMigrateConfigurationAgainAsync

  • Etape 5.5 :
    Une console s’ouvre dans la zone que vous avez configuré. Elle vous indique que la migration peut commencer. C’est à cet endroit que vous pourrez avoir le détail de progression de migration.
    
    Dans le même temps, un message conseille d’exporter la configuration spécifique du projet avant de démarrer le migration pour s’assurer d’en garder une copie et de pouvoir l’appliquer au besoin.
    Si ce n’est pas fait, annulez l’opération et exportez votre configuration. Sinon, passez à l'étape 4.
    

• Etape 6 :
  Migration en cours

Configuration : Informations et particularités

Configuration

Données : Informations et particularités

Données