Debugging Mobile Forms

Last updated on Apr 27, 2021 | Also applies to Adobe LiveCycle

This document includes several troubleshooting scenarios. For each scenario, some steps are provided to troubleshoot the problem. Follow these steps and, if the problem persists, configure the Logger to get and review logs for errors/warnings. For more details about Mobile Forms logging, see Generating Logs for Mobile Forms.

Problem: When rendering the form, I see org.apache.sling.api.SlingException exception page

In the exception details, search for word caused by.

The probable reason is that one or more parameters in the URL are incorrect.

Check the following parameters:

Parameter	Description
template	The filename of the template
contentRoot	The path where template and associated resources reside
dataRef	Absolute path of the data file that is merged with the template. Note: Path defines the absolute path of the data file.
data	UTF-8 encoded data bytes that are merged with the template.

Problem: Unable to render a form (an error message is displayed)

Ensure that the specified parameters are correct. For detailed information on parameters, see Render Parameters.
Log in to CRX Package Manager(at http://<server>:<port>/lc/crx/packmgr/index.jsp) and check whether the following packages are correctly installed:
- adobe-lc-forms-content-pkg-<version>.zip
- adobe-lc-forms-runtime-pkg-<version>.zip
Log in to CQ Web Console (Felix Console) at http://<server>:<port>/lc/system/console/bundles.
Ensure that the status of the following bundles is "active":
- scala-lang.bundle [osgi] (com.adobe.livecyclescala-lang.bundle)
- Adobe XFA Forms Renderer(com.adobe.livecycle.adobe-lc-forms-core)
- Adobe XFA Forms LC Connector (com.adobe.livecycle.adobe-lc-forms-lc-connector)

Problem: Form renders without styles

In your browser, open Developer Tools. Ensure that profile.css is available.
If the profile.css file is not available, login to CRX DE at http://<server>:<port>/lc/crx/de.
In the folder hierarchy on the left, navigate to /etc/clientlibs/xfaforms/. Open css.txt files listed in the folders.
- profile
- runtime
- scrollnav
- toolbar
- xfalib

Verify that the files mentioned inside the css.txt are present in CRX DE lite.

#base=css
application.css
dialog.css
datepicker.css
scribble.css
listboxwidget.css

If the mentioned files are not available, install the adobe-lc-forms-runtime-pkg-<version>.zip package again.

Problem: Unexpected error encountered

In the form URL, add a query parameter debugClientLibs and set its value to true (For example: http://<server>:<port>/lc/content/xfaforms/profiles/test.html?contentRoot=<some path>&template=<name of xdp file>&log=1-a9-b9-c9&debugClientLibs=true)
In the desktop browser like chrome, go to Developer Tools -> Console.
Open the logs to identify the type of error. For detailed information on logs, see logs for Mobile Forms.
Go to Developer Tools -> Console. Use stack trace to locate the code which is causing the error. Debug the error to resolve the issue.

Note:

If it is scripting failure, check if the same problem occurs during the PDF rendition of the form as well. If yes, then there is a problem in the form scripting logic.

Problem: Unable to submit the form

Ensure that you have rights to access the LiveCycle server and you are connected to the server.
Check that the parameter submitUrl is correct.
Enable the client side logs as mentioned at Logs for the Mobile Forms using debug option as 1-a5-b5-c5. Then render the form and click submit. Open browser debug console and check if there is an error.
Locate the server logs as mentioned at Logs for the Mobile Forms. Check if there was any error in server logs during submission.

Problem: Localized error messages do not display

Render the form with additional query parameter debugClientLibs=true in the desktop browser, and then go to Developer Tools -> Resources and check for the file I18N.css.
If the file is not available, login into CRX DE at http://<server>:<port>/lc/crx/de.
In the folder hierarchy on the left, navigate to etc/clientlibs/xfaforms/I18N and ensure that the following files and folders exist:
- Namespace.js
- LogMessages.js
- en_US
- fr_FR
- ja
- de_DE
If any of the above files or folders do not exist, install the adobe-lc-forms-runtime-pkg-<version>.zip package again.
Navigate to the folder which has the same name as the name of the locale and check its content. The folder must contain the following files:
- I18N.js
- js.txt
Check the content of js.txt and make sure that it has the following entries.
```
../Namespace.js
I18N.js
../LogMessages.js
```

Problem: Image not showing up

Ensure that the image URL is correct.
Check if your browser supports this type of image.

In the exception details, search for word caused by.

The probable reason is that one or more parameters in the URL are incorrect.

Check the following parameters:

Step text

Parameter	Description
template	The filename of the template
contentRoot	The path where template and associated resources reside
dataRef	Absolute path of the data file that is merged with the template. Note: Path defines the absolute path of the data file.
data	UTF-8 encoded data bytes that are merged with the template.

In the desktop browser, go to Developer Tools -> Resources.

Check on the left side in Frames if that image displays.

Get help faster and easier

New user?