Pages enfant
  • 05 - Migration de données uPortal 3.2 vers uPortal 4.0

Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Bloc de code
languagebash
linenumberstrue
ant data-import -Ddir="./V3-EXPORT/group_membership"

, avec –Ddir Ddir ayant pour valeur le chemin vers le répertoire « group_membership » contenant les données exportées depuis la version 3.2.

...

Si l'import s'est déroulé avec succès, un message « Build successful » devrait alors être affiché dans la console. Dans le cas échéant, un message « Build failed » sera alors affiché et les traces détaillant les différentes erreurs rencontrées seront alors visibles dans le répertoire « UPORTAL_ROOT/target/data-import-reports » du portail en version 4.x.

ATTENTION : Les channels correspondant correspondants à des IChannel de la version 3.x n'existent plus dans les versions 4.x. De ce fait, ceux-ci ne seront pas importés dans la nouvelle version et le message d'avertissement suivant sera affiché pour chacun d'eux dans la console durant la phase d'import :

...

Ce message n’est cependant pas bloquant et les channel restant restants seront tout de même traités par la procédure d’import.

...

Il se peut que durant la phase d'import des channel channels, certaines définitions de portlets ne puissent être importés importées à cause d'un problème de "Duplicate Key". Ceci signifie que les champs fname et name de la portlet à importer existent déjà dans la table de la base de données et ceci lève donc une exception suite à une contrainte d'unicité définie sur ces champs là. Une procédure manuelle a été cependant élaborée afin de palier à cette anomalie : elle consiste à réaliser une comparaison entre les deux fichiers causant l'anomalie (fichier exporté et fichier de la nouvelle version) pour en cibler les principales modifications :

...

  • Si ces IChannels ont été développés sous forme de nouvelles portlets alors il est nécessaire de modifier les fichiers « fragment-layout »associés layout » associés afin de remplacer les IChannel dans les balises <folder ID…> par les portlets associées.
  • Dans le cas contraire, si l’IChannel causant l’anomalie n’a pas été portée sous forme de portlet, il est alors nécessaire de :                                               
    • Supprimer le bloc <channel> correspondant au IChannel à intégrer dans le layout si et seulement si plusieurs channel channels sont définis dans ce même bloc <folder ID...>.
    • Supprimer la totalité du bloc <folder ID...> si le channel correspondant au IChannel est le seul intégré dans le bloc <folder ID...> englobant.

...

, avec « IChannel1.fragment-layout » correspondant au fichier « fragment-layout » contenant un ou plusieurs IChannel et n’ayant donc pu être importée importé lors de la première tentative d’import.

...