Import and manage applications

Last update: January 3, 2025

CREATED FOR:

  • User
  • Developer

In AEM forms, an application is a container for storing assets that are required for implementing an AEM forms solution. Examples of assets are form designs, form fragments, images, processes, DDX files, form Guides, HTML pages, and SWF files. During the development phase of a project, Workbench users can deploy applications directly from the Applications view in Workbench. Once deployed, these applications appear in administration console, on the Applications tab on the Application Management page.

When an application is complete and ready for deployment to a production server, the Workbench user packages the application into a AEM forms application file (.lca). Then an administrator uses administration console to import and deploy the application file, using the Applications tab on the Application Management page.

You can also use the archives tab on the Application Management page to import LCAs that were created using workbench 8.x.

NOTE
There is a known issue that LCA files from a future release are not necessarily backward compatible. While it may be possible to view and import LCA files from a future release of AEM forms (for example, a preview release), doing so is not supported and may result in aberrant behavior.

Use the Applications tab to import and manage applications that were created in Workbench. Application administrators can also export the runtime configuration for an application. Exporting the runtime configuration eliminates the need to manually reconfigure settings in the production environment before starting deployed applications. The runtime configuration file contains:

  • service configuration settings
  • pool configuration settings
  • endpoint configuration settings
  • security profiles

Import an application or archive

NOTE
Ensure that the user has admin privileges to access the administrator console.

  1. In administration console, click Services > Applications and Services > Application Management.

  2. Click Import.

  3. Click Browse and select the .lca file to import and click Preview. The Preview Application page displays information about the application.

  4. (Optional) To see a list of the assets contained in the application, click View Assets.

  5. (Optional) To deploy the assets to the runtime, select Deploy Assets To Runtime When Import Is Complete. If you do not select this option, you can deploy the assets later.

  6. Click Import. The application appears on the Applications tab.

  7. Log into the CRX repository with administrator credentials.

  8. Navigate to content/dam/lcapplications

    NOTE
    The imported applications display in the lcapplications node.

  9. Click on one of the imported applications.

    The Properties tab on the right displays the properties of the selected CRX node.

    The syncState property indicates the state of synchronization of data between the AEM Forms Server and the CRX repository. As soon as the import process begins this state is set to 0 (zero). This state indicates the data is currently not synchronized. When the data is synchronized, the state is set to 1.

Deploy an application

You can deploy applications that you have imported, or that Workbench users imported from Workbench.

  1. In administration console, click Services > Applications and Services > Application Management.
  2. Select the checkbox next to the application that you want to deploy and click Deploy.
  3. Click OK in the confirmation dialog box that appears.

Undeploy an application

You can undeploy applications from the runtime.

  1. In administration console, click Services > Applications and Services > Application Management.
  2. Select the checkbox next to the application that you want to undeploy and click Undeploy.
  3. Click OK in the confirmation dialog box that appears.

Remove an application from the server

Undeploy the application before removing it from the server.

  1. In administration console, click Services > Applications and Services > Application Management.
  2. Select the checkbox next to the application that you want to remove and click Remove.
  3. Click OK in the confirmation dialog box that appears.

Import an application’s runtime configuration

If an application administrator exported the runtime configuration for an application, you can import it into the deployed application. You can import it using either the administration console or via scripted LCA deployment.

  1. In administration console, click Services > Applications and Services > Application Management.
  2. Click the name of the application.
  3. Click Import Runtime Config.
  4. Click Browse and select the XML file that contains the runtime configuration.
  5. Click Import.