Migration vers AEM Forms as a Cloud Service

Vous pouvez migrer vos formulaires adaptatifs, thèmes, modèles et configurations de cloud d’ AEM 6.4 Forms on OSGi et AEM 6.5 Forms on OSGi vers AEM as a Cloud Service. Avant de migrer ces ressources, utilisez l’utilitaire de migration pour convertir le format utilisé dans les versions antérieures au format utilisé dans AEM as a Cloud Service. Lorsque vous exécutez l’utilitaire de migration, les ressources ci-dessous sont mises à jour :

  • Composants personnalisés pour les formulaires adaptatifs
  • Modèles et thèmes de formulaires adaptatifs
  • Configurations cloud
  • Les scripts de l’éditeur de code sont convertis en fonctions réutilisables et appliqués aux règles visuelles.

Considérations

  • Ce service ne permet de migrer du contenu d’AEM Forms que dans les environnements OSGi. La migration de contenu d’AEM Forms on JEE vers un environnement Cloud Service n’est pas prise en charge.

  • (Uniquement pour un environnement AEM 6.3 Forms ou d’une version antérieure mise à niveau vers AEM 6.4 Forms ou AEM 6.5 Forms) Les formulaires adaptatifs reposant sur des modèles et des thèmes prêts à l’emploi disponibles dans AEM 6.3 Forms ou une version antérieure ne sont pas pris en charge AEM Forms as a Cloud Service.

Prérequis

  • Dans un environnement Cloud Service, l’utilitaire de migration fonctionne conjointement avec l’outil de mappage utilisateur et l’outil de transfert de contenu. L’utilitaire de migration rend les ressources AEM Forms compatibles avec Cloud Service et l’outil de transfert de contenu migre le contenu de votre environnement AEM Forms vers un environnement AEM as a Cloud Service. Avant d’utiliser l’utilitaire de migration, découvrez comment passer à AEM en tant que Cloud Service. La procédure comporte deux phases :

    • Outil de mappage d’utilisateurs : l’outil de mappage d’utilisateurs permet de mapper vos utilisateurs aux comptes utilisateur Adobe IMS correspondants.
    • Outil de transfert de contenu : l’outil de transfert de contenu permet de préparer et de transférer du contenu d’un environnement existant vers un environnement Cloud Service.
  • Comptes disposant de droits d’administrateur sur AEM Forms as a Cloud Service et votre environnement local AEM Forms.

  • Téléchargez et installez Best Practice Analyzer, l’outil de transfert de contenu et l’utilitaire de migration d’AEM Forms à partir du portail de distribution logicielle.

  • Exécutez l’outil Best Practices Analyzer et corrigez le problème signalé.

Migration des ressources AEM Forms

Pour rendre vos ressources AEM Forms compatibles avec Cloud Service et les transférer vers un environnement AEM as a Cloud Service, procédez comme suit.

  1. Créez un clone de votre environnement AEM Forms existant.

    Utilisez toujours l’environnement cloné pour exécuter l’outil de transfert de contenu et l’utilitaire de migration. L’outil de transfert de contenu et l’utilitaire de migration apportent des modifications au contenu et aux ressources. Par conséquent, n’exécutez pas l’outil de transfert de contenu et l’utilitaire de migration dans un environnement de production.

  2. Connectez-vous à votre environnement cloné avec des droits d’administrateur.

  3. Exécutez l’outil de mappage d’utilisateurs pour mapper vos utilisateurs aux comptes utilisateur Adobe IMS correspondants. Vous avez besoin de comptes utilisateur Adobe IMS pour vous connecter à une instance AEM Forms as a Cloud Service.

  4. Téléchargez et installez l’outil Content Transfer Tool et l’utilitaire de migration AEM Forms as a Cloud Service à partir du portail de distribution logicielle dans l’environnement cloné. Vous pouvez utiliser AEM Package Manager pour installer l’outil et l’utilitaire.

  5. Accédez à Outils > Opérations > Migration du contenu.

  6. Ouvrez la carte Préparer Forms pour la migration. Le navigateur affiche cinq 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
    • Migration du script de l’éditeur de code
  7. Utilisez l’option une après l’autre pour rendre vos ressources AEM Forms compatibles avec AEM as a Cloud Service :

    1. Appuyez sur Migration de ressources AEM Forms et, dans l’écran suivant, appuyez sur Commencer la migration. Cela rend les formulaires adaptatifs et les thèmes dans votre environnement AEM Forms compatible avec AEM as a Cloud Service.

    2. Appuyez sur Migration des composants de formulaire adaptatif personnalisés et, dans la page Migration des composants personnalisés, appuyez sur Lancer la migration. Cela rend les composants personnalisés développés pour des formulaires adaptatifs et les superpositions de composants dans votre environnement AEM Forms compatibles avec AEM as a Cloud Service.

    3. Appuyez sur Migration de modèles de formulaire adaptatif et dans la page Migration des composants personnalisés, appuyez sur Lancer la migration. Cela rend les modèles de formulaire adaptatif dans /apps ou /conf et créés à l’aide de l’éditeur de modèles AEM compatibles avec AEM as a Cloud Service.

    4. Appuyez sur Migration des configurations cloud AEM Forms, puis dans la page Migration de la configuration, appuyez sur Commencer la migration. Il met à jour et déplace les Cloud Services suivants vers un nouvel emplacement :

      • Cloud Service de modèle de données de formulaire
      • Google reCAPTCHA Cloud Service
      • Adobe Sign Cloud Service
      • Adobe Fonts Cloud Service
    5. Appuyez sur Migration des scripts de l’éditeur de code, spécifiez un emplacement pour enregistrer les fonctions réutilisables, puis appuyez sur **Commencer la migration.

    Cloud Service ne prend pas en charge les scripts de l’éditeur de règles. L’outil Migration des scripts de l’éditeur de code convertit tous les scripts de règle de votre environnement en fonctions réutilisables et applique les fonctions réutilisables à l’éditeur visuel à l’emplacement approprié. Ces fonctions réutilisables sont enregistrées sous forme de bibliothèques clientes et vous aident à conserver les fonctionnalités existantes intactes. L’outil applique automatiquement les fonctions réutilisables générées aux formulaires adaptatifs correspondants.

    Utilisez le gestionnaire de modules pour exporter les fonctions réutilisables (bibliothèques clientes) vers un module.

  8. Déployez le module de fonctions réutilisables (bibliothèques clientes), le code personnalisé, les composants, les configurations, les bibliothèques personnalisées spécifiques aux paramètres régionaux dans votre environnement AEM as a Cloud Service.

  9. Exécutez l’outil de transfert de contenu. Lors de la spécification des paramètres dans l’écran Créer un jeu de migration, spécifiez le chemin d’accès aux formulaires adaptatif, thèmes, modèles, modèles de données de formulaire, Cloud Services, composants personnalisés et autres ressources spécifiques à AEM Forms sur l’option Chemins à inclure. Cela ajoute les ressources AEM Forms spécifiées au jeu de migration.

Chemins d’accès à différentes ressources spécifiques à AEM Forms

  • Formulaires adaptatifs : vous trouverez les formulaires adaptatifs sous /content/dam/formsanddocuments/ et /content/forms/af. Par exemple, pour un formulaire adaptatif appelé « Enregistrement WKND », ajoutez des chemins /content/dam/formsanddocuments/wknd-registration et /content/forms/af/wknd-registration.

  • Mode des données de formulaire : vous trouverez tous les modèles de données de formulaire sous /content/dam/formsanddocuments-fdm. Par exemple, /content/dam/formsanddocuments-fdm/ms-dynamics-fdm.

  • Bibliothèques clientes : le chemin d’accès par défaut aux bibliothèques clientes est /etc/clientlibs/fd/theme.

  • Modèles de formulaire adaptatif : le chemin d’accès par défaut aux modèles est /conf/<template folder>. Par exemple, pour un modèle appelé « chemin d’ajout de base » /conf/ReferenceEditableTemplates/settings/wcm/templates/basic.

  • Thèmes de formulaires adaptatifs et bibliothèques clientes : le chemin d’accès par défaut aux thèmes est /content/dam/formsanddocuments-themes/ et chemin d’accès par défaut aux bibliothèques clientes est /etc/clientlibs/fd/theme. Par exemple, pour un modèle appelé « Thème WKND », ajoutez le chemin d’accès /content/dam/formsanddocuments-themes/wkndtheme et les bibliothèques clientes pour le thème sous /etc/clientlibs/reference-themes/wkndtheme-3-0. Vous pouvez également utiliser des thèmes et des bibliothèques clientes sur d’autres chemins d’accès personnalisés.

  • Configurations du cloud : vous trouverez les configurations de cloud sous /conf/. Par exemple, la configuration du cloud de modèles de données de formulaire se trouve sous /conf/global/settings/cloudconfigs/fdm.

  • Modèle de processus : vous trouverez des modèles de processus AEM sous /conf/global/settings/workflow/models/. Par exemple, pour un modèle de processus appelé « Enregistrement WKND », ajoutez le chemin d’accès /conf/global/settings/workflow/models/wknd-registration.

Vous pouvez ajouter des chemins d’accès aux dossiers de niveau supérieur répertoriés ci-dessous ou des chemins d’accès aux dossiers spécifiques, comme indiqué ci-dessous. Cela permet de migrer simultanément certaines ressources et l’ensemble des ressources et des formulaires.

  • /content/dam/formsanddocuments-fdm
  • /content/dam/formsanddocuments/themes
  • /content/forms/af
  • /etc/clientlibs/fd/theme

Pour migrer des modèles de processus AEM, spécifiez les chemins d’accès suivants :

  • /conf/global/settings/workflow/models/
  • /conf/global/settings/workflow/launcher
  • /var/workflow/models

Sur cette page