Troubleshoot AEM Forms app

Last update: May 24, 2024

Topics:
Adaptive Forms

CREATED FOR:

User
Developer

This article describes the error messages that might be displayed while building AEM Forms app and the steps to resolve them.

The sections in this article include:

Attachment loss for iOS users

AEM Forms app for iOS configured to sync with AEM Forms on OSGi supports only field-level attachments. All the attachments must have unique names. If multiple attachments have identical name, only one attachment is kept and all other with identical name are lost. Perform the following steps to prevent users on iOS devices from experiencing data loss:

On the connected server, navigate to Adobe Experience Manager > Tools > Operations > Web Console.
Find and click Adaptive Form and Interactive Communication Web Channel Configuration.
In the Adaptive Form and Interactive Communication Web Channel Configuration dialog, enable Make File Names Unique.

If Make File Names Unique setting is disabled, users experience data loss if they try to submit adaptive forms with multiple attachments.
Click Save.

HTML5 form drafts submitted by workspace users are not visible on the portal

For HTML5 forms enabled in AEM Forms app with Save as Draft HTML Render Profile, the saved drafts are not visible to workspace users. To view saved drafts of HTML5 forms submitted by workspace users on the portal, perform the following steps:

Open CRXDE and login with administrator credentials.

URL: https://<server>:<port>/lc/crx/de/index.jsp
In the root path of the CRXDE, in the Access Control List under Access Control, click +.
In the Add New Entry dialog, click the group search button in the Principal field.
In the Name field of the Select Principal dialog, type PERM_WORKSPACE_USER and click Search.
Select PERM_WORKSPACE_USER group in the Select Principal dialog and click OK.
In the Add New Entry dialog, PERM_WORKSPACE_USER group is selected in the Principal field.

Enable jcr:read privileges for the user group.
Click OK.

HTML5 forms (not cached) fail to load in AEM Forms app

When AEM Forms app is connected to an older version of AEM Forms server, non-cached HTML5 forms fail to load in AEM Forms app.

Perform the following steps to resolve the issue:

In author instance, navigate to Adobe Experience Manager > Tools > Configure Workspace App Offline Service > Configure Now.
In Workspace App Offline Service page, click Manual Resource Cache.

URL: https://<server>:<port>/libs/fd/workspace-offline/content/config.html
In the Manual Resource Cache tab, click the + button to add a CRX path.
In the Add a New Resource field, type: /etc.clientlibs/fd/xfaforms/I18N/en_US.js and click Add.
Click Save.

AEM Forms do not sync on Windows

In the AEM Forms App on Windows, a form does not sync with the connected server if path of the form or any of its resources contains greater than or equal to 256 characters.

Modify the path of the form and its resources to reduce the number of characters to fewer than 256 characters.

Unsupported version of Gradle

Error Message: The project is using an unsupported version of Gradle.

The error message is displayed when you build AEM Forms app in Android Studio. The issue occurs due to unsupported version of Gradle supported on the system.

Resolution: Click Fix Gradle wrapper and re-import project to resolve the issue.

gradle_unsupported_version

Gradle and Android Gradle plug-in compatibility issues

Error Message: The versions of the Android Gradle plugin and Gradle are not compatible.

The error message is displayed when you select Build APK option from the Build menu on the Android Studio user interface.

gradle_plugin_compatibility

Resolution: Open Gradle Scripts > gradle-wrapper.properties file and edit the distributionUrl property.

For example, the Android Studio console recommends downgrading the Gradle version to 3.5. Edit the version in distributionUrl of gradle-wrapper.properties file.

Select Build > Build APK again to resolve the error and generate the .apk file.

gradle_wrapper_properties