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:
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 Configuration Service.
In the Adaptive Form Configuration Service 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.
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.
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.
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.
jcr:read privileges for the user group.
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.
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.
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.
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.
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.
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.