Troubleshooting guidelines for AEM Forms workspace

Last update: May 24, 2024

CREATED FOR:

  • Admin
  • User
  • Developer

This article discusses how to debug AEM Forms workspace by enabling logging and by using debugger in a browser. It also explains some common issues that you can encounter when using AEM Forms workspace and their workarounds.

Unable to install AEM Forms workspace package

Ater installing the patch, open the AEM Forms workspace. If you encounter the No Resource Found error, open the CRX Package Manager, and reinstalling the adobe-lc-workspace-pkg-<version>.zip package.

While installling the package, if you encounter an error javax.jcr.nodetype.ConstraintViolationException: OakConstraint0025: Authorizable property rep:authorizableId may not be removed, perform the following steps:

  1. Log in to CRXDE Lite. The default url is https://[localhost]:'port'/lc/crx/de/index.jsp

  2. Delete the following node:

    /home/groups/P/PERM_WORKSPACE_USER

  3. Go to the Package Manager. The default URL is https://[localhost]:'port'/lc/crx/packmgr/index.jsp.

  4. Search and install the adobe-lc-workspace-pkg-[version].zip package.

  5. Restart the application server.

NOTE
It is recommended to use the ‘Ctrl + C’ command to restart the SDK. Restarting the AEM SDK using alternative methods, for example, stopping Java processes, may lead to inconsistencies in the AEM development environment.

AEM Forms workspace logging

You can generate logs at various levels to enable optimal troubleshooting of errors. For example, in a complex application, logging at the component level helps in debugging and troubleshooting specific components.

In AEM Forms workspace:

  • To get the logging information about a specific component file, append /log/<ComponentFile>/<LogLevel> in the URL, and press Enter. All logging information for the component file at the specified log level is printed on the console.

  • To get logging information of all component files, append /log/all/trace in the URL, and press Enter.

  • Log format: <Component file> <Date>:<Time>: <Log Level> : <Log Message>

NOTE
By default log level of all components is set to INFO.
  • The log level set by user is maintained only for that browser session. When the user refreshes the page, the log level is set to its initial value for all components.

List of component files in AEM Forms workspace

allcategoryModelprocessinstanceModeltasklistModel
appnavigationModelprocessInstanceViewtasklistView
appnavigationViewprocessnamelistModeltaskModel
categorylistModelprocessnamelistViewtaskView
categorylistViewprocessnameModelteamqueuesView
categoryModelprocessnameViewtodoView
categoryViewsearchtemplatedetailsViewtrackingView
favoritecategoryModelsharequeueModeluisettingsModel
filterlistViewsharequeueViewuisettingsView
filterViewstartpointlistModeluserinfoModel
outofofficeModelstartpointlistViewuserinfoView
outofofficeViewstartpointModelusersearchModel
preferencesViewstartpointViewusersearchView
processinstancehistoryViewstartProcessViewwserrorModel
processinstancelistModelstartprocessViewwserrorView
processinstancelistViewtaskdetailsViewwsmessageView

Log levels available in AEM Forms workspace

  • FATAL
  • ERROR
  • WARN
  • INFO
  • DEBUG
  • TRACE
  • OFF

Debugging information for browsers

Scripts and styles can be debugged in different browsers.

FAQs

  1. PDF form is not getting rendered or submitted in Google Chrome.

    1. Install the Adobe® Reader® plug-in.
    2. In Chrome, open chrome://plugins, to view available plug-ins.
    3. Disable the Chrome PDF Viewer plug-in, and enable the Adobe Reader plug-in.

  2. SWF form or Guide is not rendering in Google Chrome.

    1. In Chrome, open chrome://plugins, to view available plug-ins.
    2. See details for Adobe Flash® Player plug-in.
    3. Disable PepperFlash under Adobe Flash Player plug-in.

  3. I have customized AEM Forms workspace but I am unable to see the changes.

    Clear your browser’s cache, and then access AEM Forms workspace.

  4. What needs to be done by the user to enable the form to be rendered in HTML when opened in desktop?

    Select the HTML radio button for default profile in the assign task step while using Workbench.

  5. Attachment does not show up when clicked.

    To view attachments, enable popups in your browser.

  6. A user is logged in to a forms application. If the user tries to log in to workspace, it may not load, if the user does not have workspace permissions.

    Logout from the other forms application, and then log in to workspace.

  7. HTML forms, using Process Properties in their design, when rendered in AEM Forms workspace, display Submit button inside the form.

    When designing forms, when you use Process Properties, it adds a Submit button inside the form. When rendered as a PDF in AEM Forms workspace, the Submit button is not visible to the end user. However, when rendering as an HTML form in AEM Forms workspace, the Submit button is visible to the end user. Clicking on this Submit button inside the form does not initiate any action. Clicking on the Submit button at the bottom of the AEM Forms workspace, outside the form, completes the task.

Experience Manager


Espressos & Experience Manager: AEM Forms

Espressos & Experience Manager

Thursday, Mar 6, 7:00 PM UTC

Join Adobe's AEM product team as they highlight AEM Forms' latest innovations, including: the new Gen AI Assistant, Unified Composition with AEM Sites, and new ways to deploy forms through conversations.

Register

Connect with Experience League at Summit!

Get front-row access to top sessions, hands-on activities, and networking—wherever you are!

Learn more

Register now