Parameter
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:
|
|
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. |
|
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 textParameter
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.
Adobe MAX
The Creativity Conference
Oct 14–16 Miami Beach and online
Adobe MAX
The Creativity Conference
Oct 14–16 Miami Beach and online