Migrate from an AEM Forms (On-Premise and AMS environments) to AEM Forms as a Cloud Service Harden-your-AEM-Forms-as-a-Cloud-Service-environment

Version
Article link
AEM 6.5
Click here
AEM as a Cloud Service
This article

You can migrate or upgrade your Adaptive Forms, themes, templates, and cloud configurations from AEM 6.5 Forms on OSGi to AEM as a Cloud Service. Before migrating these assets, use the Migration Utility to convert the format used in the earlier versions to the format used in AEM as a Cloud Service.
Let’s get started with the migration journey to AEM as a Cloud Service | Adobe Experience Manager. When you run Migration Utility, the following assets are updated:

  • Custom components for Adaptive Forms
  • Adaptive Forms templates and themes
  • Cloud configurations
  • Code editor scripts are converted to reusable functions and applied to visual rules.

Considerations to migrate to Forms as a Cloud Service consideration

To migrate from AEM 6.5 Forms to AEM Cloud Service, it is important to take into account the following points:

  • The service helps migrate content from only AEM Forms on OSGi environments. Migrating content from AEM Forms on JEE to a Cloud Service environment is not supported.

  • (Only for versions previous to AEM 6.5 Forms) Adaptive Forms based on out-of-the-box templates and themes available in AEM 6.3 Forms or previous version are not supported on AEM Forms as a Cloud Service.

  • Adobe Experience Manager Forms as a Cloud Service brings some notable changes to existing features in comparison to Adobe Experience Manager 6.5 Forms (On-Premise and Adobe-Managed Service) environments. Before proceeding with migrating to the service, learn about these noteable changes and the feature level differences to decide to migrate based on features your organization requires.

Prerequisites prerequisites

To ensure a smooth transition from AEM Forms 6.5 to AEM as a Cloud Service environment, it is important to consider the following prerequisites:

  • Enable Forms - Digital Enrollment option on for your Forms Cloud Service program and run the pipeline.

    Dry Run Result

  • In a Cloud Service environment, the Migration Utility works in conjunction with the User Mapping Tool and Content Transfer Tool. The Migration Utility makes AEM Forms assets compatible with Cloud Service and the content transfer tool migrates the content from your AEM Forms environment to an AEM as a Cloud Service environment. Before using the Migration Utility, learn the process of moving to AEM as a Cloud Service. The process has two tools:

    • User Mapping Tool: The User Mapping Tool helps you map your users with corresponding Adobe IMS user accounts.
    • Content Transfer Tool: The Content Transfer Tool helps you prepare and transfer content from existing environment to a Cloud Service environment. It helps users to easily upgrade from AEM Forms to cloud environment.
  • Accounts with administrator privileges on AEM Forms as a Cloud Service and your local AEM Forms environment.

  • Download and install Best Practice Analyzer, Content Transfer Tool, and AEM Forms Migration Utility from Software Distribution Portal.

  • Run the Best Practices Analyzer tool and fix the reported issue. For the possible issues related to migrating from Adobe Experience Manager Forms to Adobe Experience Manager Forms as a Cloud Service, see AEM Pattern Detection for Forms as a Cloud Service.

Migrate AEM 6.5 Forms assets to AEM Cloud Service use-the-migration-utility

Perform the following steps to make your AEM Forms assets compatible with Cloud Service and transfer them to an AEM as a Cloud Service environment.

  1. Create a clone of your existing AEM Forms environment.

    note note
    NOTE
    When you migrate from 6.5 to cloud service, it is recommended to use the cloned environment to run the Content Transfer Tool and the Migration Utility. Content Transfer Tool and Migration Utility make some changes to the content and assets. So, do not run the Content Transfer Tool and the Migration Utility on a production environment.
  2. Log in to your cloned environment with administrative privileges.

  3. Run the User Mapping Tool to map your users with corresponding Adobe IMS user accounts. You require Adobe IMS user accounts to login to a AEM Forms as a Cloud Service instance.

  4. Download and install the Content Transfer Tool and AEM Forms as a Cloud Service Migration Utility from Software Distribution Portal on the cloned environment. You can use AEM Package Manager to install the tool and the utility.

  5. Navigate to Tools > Operations > Content Migration.

  6. Open the Prepare Forms for migration card. The browser displays five options:

    • AEM Forms Assets Migration
    • Adaptive Forms Custom Components Migration
    • Adaptive Forms Templates Migration
    • AEM Forms Cloud Configurations Migration
    • Code Editor Script Migration
  7. Use the option one-after another to make your AEM Forms assets compatible with AEM as a Cloud Service:

    1. Select AEM Forms Assets Migration, and in the next screen, select Start Migration. It makes Adaptive Forms and themes on your AEM Forms environment compatible with AEM as a Cloud Service .

    2. Select Adaptive Forms Custom Components Migration and in the Custom Components Migration page, select Start Migration. It makes any custom component developed for Adaptive Forms and component overlays on your AEM Forms environment compatible with AEM as a Cloud Service .

    3. Select Adaptive Forms Template Migration and in the Custom Components Migration page, select Start Migration. It makes Adaptive Form templates at /apps or /conf and created using AEM Template Editor compatible with AEM as a Cloud Service .

    4. Select AEM Forms Cloud Configurations Migration and then on the Configuration Migration page, select Start Migration. It updates and moves the following Cloud Services to a new location:

      • Form Data Model Cloud Service
      • Google reCAPTCHA Cloud Service
      • Adobe Sign Cloud Service
      • Adobe Fonts Cloud Service
    5. Select Code Editor Script Migration, specify a location to save reusable functions, and select **Start Migration.

    The Cloud Service does not support rule editor scripts. The Code editor script migration tool converts all rule scripts on your environment to reusable functions and applies the reusable functions to visual editor at appropriate location. These reusable functions are saved in the form of client libraries and help you keep existing functionality intact. The tool automatically applies the generated reusable functions to corresponding Adaptive Forms.

    AEM Form migration to Cloud Service, use the Package Manager to export the reusable functions (Client Libraries) to a package.

  8. Deploy the reusable functions (Client Libraries) package, custom code, components, configurations, custom locale-specific libraries to your AEM as a Cloud Service environment.

  9. Run the Content Transfer Tool. While specifying parameters on the Create Migration Set screen, specify the path of Adaptive Forms, themes, templates, Form Data Models, Cloud Services, Custom Components and other AEM Forms-specific assets to the Paths to be included option. It adds specified AEM Forms assets to migration set.

Paths of various AEM Forms-specific assets

When you migrate from AEM Forms 6.5 to the cloud service, you can locate the AEM Forms-specific assets at:

  • Adaptive Forms: You can find Adaptive forms at /content/dam/formsanddocuments/and /content/forms/af. For example, for an adaptive form titled WKND Registration add paths /content/dam/formsanddocuments/wknd-registration and /content/forms/af/wknd-registration.

  • Form Data Model: You can find all the Form Data Models at /content/dam/formsanddocuments-fdm. For example, /content/dam/formsanddocuments-fdm/ms-dynamics-fdm.

  • Client libraries: The default path of client libraries is /etc/clientlibs/fd/theme.

  • Adaptive Form templates: The default path of templates is /conf/<template folder>. For example, for a template titled basic add path /conf/ReferenceEditableTemplates/settings/wcm/templates/basic.

  • Adaptive Form themes and Client libraries: The default path of themes is /content/dam/formsanddocuments-themes/ and default path of client libraries is /etc/clientlibs/fd/theme. For example, for a template titled WKND Theme add path /content/dam/formsanddocuments-themes/wkndtheme and client libraries for the theme at /etc/clientlibs/reference-themes/wkndtheme-3-0. You can also have themes and client libraries at other custom paths.

  • Cloud Configurations: You can find Cloud Configurations at /conf/. For example, Form Data Model cloud configuration is at /conf/global/settings/cloudconfigs/fdm.

  • Workflow Model: You can find AEM Workflow Models at /conf/global/settings/workflow/models/. For example, for an workflow model titled WKND Registration add path /conf/global/settings/workflow/models/wknd-registration

You can add top level folder paths listed below or specific folder paths as described below. It enables you to migrate a certain asset and all the assets and forms at once, when you upgrade to cloud service from AEM forms 6.5.

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

When you migrate AEM Workflow models from AEM Forms 6.5 to Cloud Service, specify the following paths:

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

See next

Additional Information

The migration utility helps you to migrate Adaptive Forms based on foundation components. In addition, Forms as a Cloud Service supports Adaptive Forms Core Components. So, you can:

To learn more about AEM Forms as a Cloud Service, you can refer:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab