L’utilitaire de migration convertit les ressources des formulaires adaptatifs, les configurations du cloud, et les ressources de Correspondence Management du format utilisé dans les versions antérieures vers le format utilisé dans AEM 6.5 Forms. L’exécution de l’utilitaire de migration engendre la migration des éléments suivants :
En cas de mise à niveau dynamique, pour les ressources de Correspondence Management, vous pouvez exécuter la migration à chaque importation des actifs. Pour la migration de Correspondence Management, le package de compatibilité Forms doit être installé.
Vous pouvez effectuer une mise à niveau vers la dernière version d’AEM Forms 6.5 à partir d’AEM Forms 6.4, 6.3 ou 6.2, ou effectuer une nouvelle installation. Selon que vous avez mis à niveau votre installation précédente ou procédé à une nouvelle installation, vous devez effectuer l’une des opérations suivantes :
En cas de mise à niveau statique
Si vous avez effectué une mise à niveau statique, l’instance mise à niveau contient déjà les ressources et les documents. Toutefois, afin de pouvoir utiliser les ressources et les documents, vous devez installer le package de compatibilité AEMFD (comprenant le package de compatibilité Correspondence Management)
Vous devez ensuite les mettre à jour en exécutant l’utilitaire de migration.
En cas d’installation dynamique
S’il s’agit d’une nouvelle installation, afin de pouvoir utiliser les ressources et les documents, vous devez installer le pack de compatibilité AEMFD (y compris le pack de compatibilité Correspondence Management).
Ensuite, vous devez importer votre pack de ressources (zip ou cmp) sur la nouvelle installation, puis mettre à jour les ressources et les documents en exécutant l’utilitaire de migration. Adobe recommande de ne créer de nouvelles ressources sur la nouvelle installation qu’après avoir exécuté l’utilitaire de migration.
En raison de changements liés à la rétrocompatibilité, les emplacements de quelques dossiers dans crx-repository ont changé. Exportez et importez manuellement les dépendances (bibliothèques et ressources personnalisées) de la configuration précédente vers un nouvel environnement.
Pour les ressources de Correspondence Management :
Exécutez l’utilitaire de migration avant toute modification ou création de ressources. Nous vous recommandons de ne pas exécuter l’utilitaire après une modification ou création de ressources. Assurez-vous que l’interface utilisateur des ressources de Correspondence Management ou des formulaires adaptatifs n’est pas ouverte pendant que le processus de migration est en cours d’exécution.
Lorsque vous exécutez l’utilitaire de migration pour la première fois, un journal est créé avec le chemin et le nom suivants : \[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log
. Ce journal conserve les informations de migration mises à jour de Correspondence Management et des formulaires adaptatifs, telles que le déplacement des ressources.
Avant d’exécuter l’utilitaire de migration, assurez-vous d’avoir sauvegardé votre crx-repository.
Dans une session de navigateur, connectez-vous à l’instance d’auteur AEM en tant qu’administrateur.
Ouvrez l’URL suivante dans le navigateur :
https://[nom de l’hôte]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html
Le navigateur affiche quatre options :
Procédez comme suit pour effectuer la migration :
Pour migrer les ressources, appuyez sur Migration des ressources d’AEM Forms et dans l’écran suivant, appuyez sur Lancer la migration. Les éléments suivants sont migrés :
Pendant la migration des ressources, des messages d’avertissement tels que « Conflit détecté pour… » peuvent s’afficher. Ces messages indiquent que les règles de certains composants des formulaires adaptatifs n’ont pas pu être migrées. Par exemple, si le composant possède un événement qui contient à la fois des règles et des scripts, si les règles se produisent après un script, aucune des règles du composant n’est migrée. Vous pouvez migrer ces règles en ouvrant l’éditeur de règles dans la création de formulaires adaptatifs.
Pour migrer les composants personnalisés des formulaires adaptatifs, appuyez sur Migration des composants personnalisés des formulaires adaptatifs. Sur la page Migration des composants personnalisés, appuyez sur Démarrer la migration. Les éléments suivants sont migrés :
Pour migrer les modèles de formulaires adaptatifs, appuyez sur Migration des modèles de formulaires adaptatifs. Sur la page Migration des composants personnalisés, appuyez sur Démarrer la migration. Les éléments suivants sont migrés :
/apps
ou /conf
à l’aide de l’éditeur de modèles AEM.Migrez les services de configuration cloud d’AEM Forms pour exploiter le nouveau paradigme de service cloud contextuel comprenant l’interface utilisateur tactile (sous /conf
). Lorsque vous migrez les services de configuration cloud d’AEM Forms, les services cloud dans /etc
sont déplacés vers /conf
. Si aucune de vos personnalisations de services cloud ne dépendent de chemins d’accès existants (/etc
), il est recommandé d’exécuter l’utilitaire de migration juste après la mise à niveau vers la version 6.5 et d’utiliser l’interface utilisateur tactile de la configuration cloud pour tout travail ultérieur. Si vous disposez déjà de personnalisations de services cloud, continuez à utiliser l’interface utilisateur classique dans la configuration mise à niveau jusqu’à ce que les personnalisations soient mises à jour et concordent avec les chemins migrés (/conf
), puis exécutez l’utilitaire de migration.
Pour migrer les services cloud d’AEM Forms qui comprennent les services suivants, appuyez sur Migration des configurations cloud d’AEM Forms (la migration des configurations cloud est indépendante du pack de compatibilité AEMFD), appuyez sur Migration des configurations cloud d’AEM Forms puis, sur la page Migration des configurations, appuyez sur Démarrer la migration :
Services cloud du modèle de données de formulaire
/etc/cloudservices/fdm
./conf/global/settings/cloudconfigs/fdm
.Recaptcha
/etc/cloudservices/recaptcha
./conf/global/settings/cloudconfigs/recaptcha
.Adobe Sign
/etc/cloudservices/echosign
./conf/global/settings/cloudconfigs/echosign
.Services cloud typekit
/etc/cloudservices/typekit
./conf/global/settings/cloudconfigs/typekit
.La fenêtre du navigateur affiche les éléments suivants pendant le processus de migration :
Lorsqu’il est exécuté, l’utilitaire de migration effectue les opérations suivantes :
Une fois l’utilitaire de migration en cours d’exécution, passez aux tâches de maintenance.
Ces composants peuvent être migrés en les ouvrant dans l’éditeur de règles dans l’éditeur de formulaires adaptatifs.
Pour migrer les règles et les scripts (ceci n’est pas nécessaire si vous effectuez une mise à niveau à partir de la version 6.3) dans les composants personnalisés, appuyez sur Migration des composants personnalisés des formulaires adaptatifs. Dans l’écran suivant, appuyez sur Démarrer la migration. Les éléments suivants sont migrés :
Règles et scripts créés à l’aide de éditeur de règles (6.1 FP1 et versions ultérieures)
Scripts créés à l’aide de l’onglet Script dans l’interface utilisateur de la version 6.1 et versions antérieures
Pour migrer les modèles (ceci n’est pas nécessaire si vous effectuez une mise à niveau depuis la version 6.3 ou 6.4), appuyez sur Migration de modèles de formulaires adaptatifs. Dans l’écran suivant, appuyez sur Démarrer la migration. Les éléments suivants sont migrés :
Anciens modèles : les modèles de formulaires adaptatifs créés sous /apps en utilisant AEM 6.1 Forms ou une version antérieure. Ceci inclut les scripts qui ont été définis dans les composants du modèle.
Nouveaux modèles : les modèles de formulaires adaptatifs créés en utilisant l’éditeur de modèles sous /conf. Cela inclut la migration des règles et des scripts créés à l’aide de l’éditeur de règles.
Après avoir exécuté l’utilitaire de migration, effectuez les tâches de maintenance suivantes :
Assurez-vous que la version XFA des dispositions et des dispositions de fragments est 3.3 ou une version ultérieure. L’utilisation des dispositions et des dispositions de fragments d’une version plus ancienne peut provoquer des problèmes de rendu de la lettre. Pour mettre à jour une version de XFA plus ancienne vers la version la plus récente, suivez la procédure suivante :
Publiez tous les actifs qui ont été publiés dans le système précédent avant migration. L’utilitaire de migration met à jour les actifs uniquement dans l’instance d’auteur. Pour mettre à jour les actifs dans la ou les instances de publication, vous devez les publier.
Dans les versions 6.4 et 6.5 d’AEM Forms, certains des droits des groupes d’utilisateurs de formulaires sont modifiés. Si vous souhaitez que vos utilisateurs puissent charger des fichiers XDP et des formulaires adaptatifs contenant des scripts ou utiliser un éditeur de code, vous devez les ajouter au groupe forms-power-users. De même, le groupe template-authors ne peut plus utiliser l’éditeur de code dans l’éditeur de règles. Pour que les utilisateurs puissent utiliser l’éditeur de code, ajoutez-les au groupe af-template-script-writers. Pour obtenir des instructions sur l’ajout d’utilisateurs à des groupes, consultez Gestion des utilisateurs et groupes d’utilisateurs.