Troubleshooting guidelines for AEM Forms workspace

CAUTION

AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

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 CRX DE 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.

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

allcategoryModel

processinstanceModel

tasklistModel

appnavigationModel

processInstanceView

tasklistView

appnavigationView

processnamelistModel

taskModel

categorylistModel

processnamelistView

taskView

categorylistView

processnameModel

teamqueuesView

categoryModel

processnameView

todoView

categoryView

searchtemplatedetailsView

trackingView

favoritecategoryModel

sharequeueModel

uisettingsModel

filterlistView

sharequeueView

uisettingsView

filterView

startpointlistModel

userinfoModel

outofofficeModel

startpointlistView

userinfoView

outofofficeView

startpointModel

usersearchModel

preferencesView

startpointView

usersearchView

processinstancehistoryView

startProcessView

wserrorModel

processinstancelistModel

startprocessView

wserrorView

processinstancelistView

taskdetailsView

wsmessageView

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.

Business.Adobe.com resources

Docs links
Content Insights Automated Onboarding Asset Collections Personalized Communications Dynamic Media Content Management System

On this page