...
Une fois ces modifications effectuées, il est recommandé de redémarrer l’application en version 4.x afin de s’assurer que les modifications apportées n’ont pas affecté son bon fonctionnement.
Import des données
Suite à la vérification précédente, il suffit d’importer les données issues de l’export de la version 3.2 via la commande Ant suivante :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
ant data-import -Ddir="./V3-EXPORT/group_membership"
|
, avec –Ddir ayant pour valeur le chemin vers le répertoire « group_membership » contenant les données exportées depuis la version 3.2.
Import des « channel »
Afin de réaliser l’import des « channel », il est seulement nécessaire d'importer les fichiers exportés correspondants dans la version 4.x via la commande Ant :
| Bloc de code | ||
|---|---|---|
| ||
ant data-import -Ddir="./V3-EXPORT/channel"
|
, avec Ddir ayant pour valeur le chemin vers le répertoire contenant les « channel » exportés.
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 à 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 :
<channel-xxx> is not a portlet. It was likely an IChannel from a previous version of uPortal and will not be imported.
Ce message n’est cependant pas bloquant et les channel restant seront tout de même traités par la procédure d’import.
Import des « fragment-layout »
Identiquement aux « channel », la procédure d’import des « fragment-layout » est relativement basique. Celle-ci se fait via la commande Ant :
| Bloc de code | ||
|---|---|---|
| ||
ant data-import -Ddir="./V3-EXPORT/fragment-layout" |
, avec Ddir ayant pour valeur le chemin vers le répertoire contenant les « fragment-layout » exportés.
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 : Si des IChannel sont utilisés dans certains « fragment-layout » alors ces fichiers ne pourront être importés dans la version 4.x. Deux cas sont alors envisageables :
- 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 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 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.
Les « fragments-layout » corrigés peuvent alors être importés de façon unitaire avec la commande Ant :
| Bloc de code | ||
|---|---|---|
| ||
ant data-import -Dfile="./V3-EXPORT/fragment-layout/IChannel1.fragment-layout" |
, avec « IChannel1.fragment-layout » correspondant au fichier « fragment-layout » contenant un ou plusieurs IChannel et n’ayant donc pu être importée lors de la première tentative d’import.