Migration de ressources et de documents AEM Forms

L’utilitaire de migration convertit la variable Ressources Forms adaptatives, configurations cloud, et Actifs de Correspondence Management du format utilisé dans les versions antérieures au format utilisé dans Adobe Experience Manager (AEM) 6.5 Forms. Lorsque vous exécutez l’utilitaire de migration, les éléments suivants sont migrés :

• Composants personnalisés pour les formulaires adaptatifs
• Formulaires adaptatifs et modèles de Correspondence Management
• Configurations cloud
• Correspondence Management et ressources de formulaires adaptatifs

Approche de la migration

Vous pouvez upgrade vers la dernière version d’AEM Forms 6.5 à partir d’AEM Forms 6.4, 6.3 ou 6.2, ou vers 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 actifs et les documents. Toutefois, avant de pouvoir utiliser les actifs et les documents, vous devez installer le Package de compatibilité AEMFD (comprend le package de compatibilité Correspondence Management)

Vous devez ensuite mettre à jour les ressources et les documents par exécution de l’utilitaire de migration.

S’il existe une installation dynamique

S’il s’agit d’une installation obsolète (nouvelle), vous devez installer les ressources et les documents avant de pouvoir les utiliser. Package de compatibilité AEMFD (inclut le package de compatibilité Correspondence Management).

Vous devez ensuite importer votre package de ressources (zip ou cmp) dans la nouvelle configuration, puis mettre à jour les ressources et les documents par exécution de l’utilitaire de migration. Adobe recommande de créer des actifs sur la nouvelle configuration uniquement après avoir exécuté l’utilitaire de migration.

En raison de rétrocompatibilité modifications, les emplacements de quelques dossiers dans le référentiel crx-repository sont modifiés. Exportez et importez manuellement les dépendances (bibliothèques et ressources personnalisées) de la configuration précédente vers un nouvel environnement.

Avant de procéder à la migration

Pour les ressources de Correspondence Management :

• Pour les ressources importées de la plateforme précédente, une propriété est ajoutée : fd:version=1.0.
• Depuis AEM 6.1 Forms, les commentaires ne sont pas disponibles hors champ. Les commentaires ajoutés précédemment sont disponibles dans les actifs mais ne sont pas automatiquement affichés sur l’interface. Personnalisez la propriété extendedProperties dans l’interface utilisateur d’AEM Forms pour rendre les commentaires visibles.
• Dans certaines versions précédentes, telles que LiveCycle ES4, le texte était modifié à l’aide de Flex RichTextEditor, mais depuis AEM Forms 6.1, l’éditeur de HTML est utilisé. En raison de ce rendu et de l’aspect des polices, les tailles et les marges des polices peuvent différer des versions précédentes de l’interface utilisateur de création. Toutefois, l’aspect des lettres est identique lors du rendu.
• Les listes dans les modules de texte sont améliorées et le rendu est désormais différent. Il peut y avoir des différences visuelles. Adobe vous recommande d’afficher et d’afficher les lettres dans lesquelles vous utilisez des listes dans des modules de texte.
• Les modules de contenu d’image étant convertis en ressources de gestion des actifs numériques, les mises en page et les fragments sont ajoutés aux formulaires au cours de la migration, la propriété Mis à jour par de ces modules devient admin.
• L’historique des versions des ressources n’est pas migré et n’est pas disponible après la migration. L’historique des versions suivant après la migration est conservé.
• L’état Prêt à publier est déprécié depuis AEM 6.1 Forms, de sorte que tous les actifs à l’état Prêt à publier passent à l’état Modifié.
• L’interface utilisateur étant mise à jour dans AEM Forms 6.3, les étapes d’exécution des personnalisations sont également différentes. Rétablissez la personnalisation si vous migrez depuis une version antérieure à 6.3.
• Les fragments de mise en page sont déplacés de /content/apps/cm/layouts/fragmentlayouts/1001 to /content/apps/cm/modules/fragmentlayouts. La référence au dictionnaire de données dans les ressources affiche le chemin du dictionnaire de données au lieu de son nom.
• Les espaces de tabulation utilisés pour l’alignement dans les modules de texte doivent être réajustés. Pour plus d’informations, voir Correspondence Management - Utilisation de l’interlettrage pour organiser le texte.
• Les configurations d’Asset Composer sont remplacées par celles de Correspondence Management.
• Les ressources sont déplacées dans des dossiers portant des noms tels que Texte existant et Liste existante.

Utilisation de l’utilitaire de migration

Exécution de l’utilitaire de migration

Exécutez l’utilitaire de migration avant de modifier les ressources ou de créer des ressources. Adobe recommande de ne pas exécuter l’utilitaire après avoir apporté des modifications ou créé des 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 est constamment mis à jour avec les informations de migration de Correspondence Management et de Forms adaptatif, telles que le déplacement des ressources.

1. Dans une session de navigateur, connectez-vous à votre instance d’auteur AEM en tant qu’administrateur.

2. 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 :

   • Migration des ressources d’AEM Forms
   • Migration de composants personnalisés de formulaires adaptatifs
   • Migration de modèles de formulaire adaptatif
   • Migration des configurations cloud AEM Forms

3. 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 :

     • Formulaires adaptatifs
     • Fragments de document
     • Thèmes
     • Lettres
     • Dictionnaires de données
   REMARQUE

   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 :

     • Composants personnalisés écrits pour Adaptive Forms
     • Superpositions de composants, le cas échéant.

   • 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 :

     • Les modèles de formulaire adaptatif créés sous /apps ou /conf à l’aide de l’éditeur de modèles AEM.

   • Migrer les services de configuration d’AEM Forms Cloud pour utiliser le nouveau paradigme de service cloud contextuel, qui inclut 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 vous ne disposez d’aucune personnalisation de services cloud qui dépend des chemins hérités (/etc), Adobe vous recommande d’exécuter l’utilitaire de migration après la mise à niveau vers la version 6.5 ; utilisez la configuration cloud Touch UI pour tout travail supplémentaire. 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 Services cloud AEM Forms, qui comprend les éléments suivants, appuyez sur Migration de la configuration cloud AEM Forms (la migration de la configuration cloud est indépendante du package de compatibilité AEMFD). Appuyez sur Migration des configurations du cloud AEM Forms, puis sur la page Migration de la configuration, appuyez sur . Démarrer la migration:

   • Services cloud du modèle de données de formulaire

     • Chemin d’accès source : /etc/cloudservices/fdm.
     • Chemin d’accès cible : /conf/global/settings/cloudconfigs/fdm.

   • Recaptcha

     • Chemin d’accès source : /etc/cloudservices/recaptcha.
     • Chemin d’accès cible : /conf/global/settings/cloudconfigs/recaptcha.

   • Adobe Sign

     • Chemin d’accès source : /etc/cloudservices/echosign.
     • Chemin d’accès cible : /conf/global/settings/cloudconfigs/echosign.

   • Services cloud typekit

     • Chemin d’accès source : /etc/cloudservices/typekit.
     • Chemin d’accès cible : /conf/global/settings/cloudconfigs/typekit.

   La fenêtre du navigateur affiche les éléments suivants pendant le processus de migration :

   • Lorsque les ressources sont mises à jour : les ressources sont correctement mises à jour.
   • Une fois la migration terminée : migration des ressources terminée.

   Lorsqu’il est exécuté, l’utilitaire de migration effectue les opérations suivantes :

   • Ajoute les balises aux actifs : ajoute la balise « Correspondence Management : actifs migrés » / « Formulaires adaptatifs : actifs migrés » aux actifs migrés, afin que les utilisateurs et utilisatrices puissent identifier les actifs migrés. Lorsque vous exécutez l’utilitaire de migration, toutes les ressources existantes dans le système sont marquées comme étant migrées.
   • Génération des balises : les catégories et les sous-catégories présentes dans le système précédent sont créées sous forme de balises et ces balises sont associées aux actifs appropriés de Correspondence Management dans AEM. Par exemple, une catégorie (Demandes) et une sous-catégorie (Demandes) d’un modèle de lettre sont générées sous la forme de balises.

4. Une fois l’utilitaire de migration en cours d’exécution, passez aux tâches de maintenance.

Migrer des règles à l’aide de l’éditeur de règles

Ces composants peuvent être migrés en les ouvrant dans l’éditeur de règles de l’éditeur de Forms adaptatif.

• 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 - Modèles de formulaires adaptatifs créés à l’aide de 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.

Tâches de maintenance après l’exécution de l’utilitaire de migration

Après avoir exécuté l’utilitaire de migration, effectuez les tâches de maintenance suivantes :

1. Assurez-vous que la version XFA des mises en page et des mises en page de fragments est 3.3 ou supé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 d’un XFA antérieur vers la dernière version, procédez comme suit :

   1. Téléchargez XFA sous la forme d’un fichier zip depuis l’interface utilisateur de Forms.
   2. Extrayez le fichier.
   3. Ouvrez le fichier XFA dans la dernière version de Designer et enregistrez-le. La version de XFA est mise à jour vers la dernière version.
   4. Téléchargez le fichier XFA dans l’interface utilisateur de Forms.

2. Publiez tous les actifs qui ont été publiés dans le système précédent avant la migration. L’utilitaire de migration ne met à jour les actifs que sur l’instance d’auteur. Pour mettre à jour les actifs sur les instances de publication, vous devez les publier.

3. 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 l’un de vos utilisateurs puisse charger des fichiers XDP et des Forms adaptatifs contenant des scripts ou utiliser un éditeur de code, vous devez les ajouter au groupe forms-power-users. De même, template-authors ne peut plus utiliser l’éditeur de code dans l’éditeur de règles. Pour que les utilisateurs puissent utiliser un éditeur de code, ajoutez-les au groupe af-template-script-authors . Pour obtenir des instructions sur l’ajout d’utilisateurs à des groupes, consultez Gestion des utilisateurs et groupes d’utilisateurs.