SmartDoc Technologies Logo

AEM Forms Training

The world's leading AEM Forms training source

AEM Forms Known Issues

Last Updated: 10-9-2019

Overview

This page documents the AEM Forms Known Issues that may affect your work. The known issues documented here are related to one or more of the topics detailed in our AEM Forms Training Cloud courseware.

In some cases, these issues are documented bugs that occur in a specific version of AEM or the Adobe AEM Forms add-on package. In other cases, these issues are updates that Adobe has made to AEM Forms that may affect how your older forms work in newer versions.

AEM Forms Known Issues

In each issue listed below, the software version is documented so you can determine if the issue affects your AEM Forms system. When possible, we have also included the Adobe Bug Number and a suggested workaround. If it is a corrected bug, we have listed the version of the AEM Forms add-on package that contains the correction. The AEM Forms releases page details all of the AEM Forms add-on packages that have been released. Each description includes the corresponding AEM version and other useful information. The AEM maintenance releases roadmap shows upcoming AEM maintenance releases.

Older Form Fragments Missing in AEM Forms 6.5

Beginning in AEM 6.5, form fragments now have an explicit type of affragment. When this property does not exist, you cannot see the form fragments in an AEM 6.5 adaptive form. Since older form fragments do not have this property, you can no longer see them. If you are using AEM 6.5 and you can’t find your form fragments, this may be your issue.

Older Form Fragments are missing in AEM Forms 6.5

You can either re-create your form fragments in AEM 6.5 or simply add this new property to your older form fragments with CRXDE. Once this property is added, your older form fragments magically appear in AEM Forms 6.5.

Viewing older form fragments in AEM 6.5 adaptive forms.
  1. Open CRXDE | Lite.
  2. Locate this node
    /content/dam/formsanddocuments/-your folder and form-/jcr:content
  3. Add a String property named type with a Value of affragment.
  4. Click Add.
  5. Click Save All.
Adding a property in CRX so adaptive forms can use older form fragments.

AEM Forms Workflow Adobe Sign Document is Buggy

The out-of-the-box AEM Forms Workflow Sign Document step has multiple bugs. When you invoke the service, the following exception is raised.

Caused by: com.adobe.granite.workflow.WorkflowException: Exception in Adobe Sign Service

The AEM Forms Sign Document step is not working in 6.5

However, although this exception is raised, the component does kick off an Adobe Sign workflow. The trouble is, it kicks off too many Adobe Sign workflows. In my testing, the Sign Document component consistently kicked off 11 Adobe Sign workflows.

The AEM Forms Sign Document step kicks off 11 workflows

Bug Number #CQ-4278136, AEM Forms 6.5 does NOT submit to a Workbench workflow

It is no longer possible to submit an adaptive form to a Workbench workflow.

Previously, adaptive forms supported a Submit Action of Invoke a Forms Workflow. This action enabled us to submit forms to Workbench workflows. This still works on AEM Forms on JEE (see the blue outline below). However, this does not work on AEM Forms on OSGi (see the red circle below). When you select this option on AEM Forms on OSGi, the Process Name drop-down no longer appears.

The AEM Forms Verify component is not working in 6.5

Start using AEM's OSGi workflow (Recommended)

If you are using AEM Forms 6.5 or greater, consider switching to the Forms Workflow on AEM Forms on OSGi. Previously, the best workflow tools and capabilities were on the AEM Forms on JEE platform. AEM Forms on JEE has the Workbench tool (shown here) and many out-of-the-box AEM Forms workflow steps.

Adobe AEM Forms workflow with Workbench

However, as of version 6.5, Adobe has matched the workflow capabilities in the Forms Workflow features of AEM Forms on OSGi. As shown here, the very same workflow can easily be created on OSGi.

Adobe AEM Forms OSGi workflow with workflow models

Want to learn more about AEM Forms Workflow? Simply request our Best Practices for AEM Forms Workflow. This white paper details our key learnings and proven methods for converting traditional Workbench workflows on JEE to new and updated AEM Forms on OSGi workflows.

The Verify Component does NOT WORK in 6.5.1.0

This issue has been solved in AEM-Forms-6.5.2.0-WIN-6.0.106.zip

The Verify Component produces an erroneous error in AEM Forms 6.5.1.0 and the AEM Forms add-on package that came out on July 2nd, 2019. I have seen this error message with auto-generated Documents of Record and with XDP-based adaptive forms.

The AEM Forms Verify component is not working in 6.5

The Number of Columns Property is Missing in 6.5

The Number of Columns property is missing in AEM Forms 6.5 and the AEM Forms add-on package that came out on July 2nd, 2019. Although you can fix it by changing the sling:resourceType property of your panel, it is a better idea to start using AEM’s Layout mode for your adaptive forms. Both techniques are detailed here.

The Number of Columns property is missing in 6.5

Start using AEM's Layout mode (Recommended)

If you are using AEM Forms 6.5 or greater, consider using AEM's Layout mode for your multi-column layouts. If you have used Layout mode in AEM Sites, you will already be familiar with Layout mode in AEM Forms. Simply switch from Edit mode to Layout mode and follow the same layoutting techniques that we use in AEM Sites. These steps are covered in detail in our AEM Forms Developer Student Manual.

Layout mode in AEM Forms.

Change the sling:resourceType property of your panel (Not Recommended)

  1. Open CRXDE | Lite.
  2. Search for your form's panel.
    Note: The illustration below shows a search for the "Foia Application" panel. This is only an example. This is an Adobe example form and it does not have the bug problem.
  3. Select the result that points to your panel.
    Note: The illustration below shows a result that points to the "Foia Application" panel. Here is the complete path for this example node: /content/forms/af/we-gov/foia-request-form/jcr:content/guideContainer/rootPanel/items/1475752223586
  4. Select the layout node of your panel.
  5. If the sling:resourceType property of your layout node is "fd/af/layouts/gridFluidLayout2", change it to "fd/af/layouts/gridFluidLayout".
  6. Click Save All.
  7. Go back to AEM Forms and you will see the Number of Columns property on your panel.
Searching in CRXDE|Lite

Bug Number #CQ-4264461, AEM Forms 6.4 on Macintosh

You cannot create child panels in an adaptive form if you are running your AEM Forms server on a Macintosh. If you try to create a child panel of the guideRootPanel, you will see the Name property highlight in red and you will not be able to complete the panel.

Unable to add child panels in adaptive forms on the Macintosh

Unable to create Child Panel (Windows Users)

Just like the Macintosh bug documented above, some Windows users are also not able to create child panels in an adaptive form. When trying to create a child panel of the guideRootPanel, they will see the Name property highlight in red and they will not be able to complete the panel.

Unable to add child panels in adaptive forms on the Macintosh

Create Child Panels nodes in CRXDE Lite

  1. Open the Develop mode of CRXDE Lite.
  2. Locate your adaptive form's rootPanel.
  3. Expand the items node.
  4. Copy and paste as many child panel nodes as you need.
Create child panel nodes in CRXDE Lite
  1. Enter the name of your panel in the jcr:title property.
  2. Click Save All.
  3. Go back to AEM Forms and Refresh.
  4. You can now work on your new child panels.

Bug Number #CQ-4252244

Web Service calls in AEM Forms OSGi 6.4 are blocked. This does not affect AEM Forms JEE 6.4. It also does not affect AEM Forms OSGI 6.3 or AEM Forms JEE 6.3.

Correspondence Management not in AEM 6.4

By default, the Adobe Correspondence Management tools are missing in AEM 6.4. Previously, these tools were part of the AEM Forms add-on package. If you are a user of Adobe Correspondence Management, this absence can be somewhat disconcerting. This screenshot shows the available tools after the AEM Forms add-on package is installed. Notice that Letters and Data Dictionaries are missing.

Adobe Correspondence Management in not in AEM 6.4

Adobe released Interactive Communications in AEM 6.4, and this tool also creates customer communications. One of the advantages of Interactive Communications is the web channel support. However, even though both products use Document Fragments, Interactive Communications is different than Adobe Correspondence Management.

If you are using AEM 6.4 and want to use Adobe Correspondence Management, you need to install the AEM Forms Compatibility Package. This package will install Letters and Data Dictionaries.

Install the AEM Forms Compatibility Package

You can download the AEM Forms Compatibility Package (AEM-FORMS-6.4.2.0-COMPAT-1.1.8.zip) from Package Share.

AEM Forms Designer Preview PDF Tab Disabled

Sometimes, AEM Forms Designer does not show the Preview PDF tab. It may be grayed-out or otherwise disabled. This has been a problem that has frustrated Designer form authors for years. The traditional approach has been to reinstall Designer and Acrobat or Reader. I read that it may have something to do with the Adobe PDF Reader ActiveX control not being properly installed. Lately, I have seen this approach work very well for my students who are experiencing this problem. Let me know if it helps you. jp@smartdoctech.com

Adobe AEM Forms Designer Preview PDF tab grayed out or disabled
  1. Close your XDP in Designer.
  2. Open Internet Explorer.
  3. Click Tools (the Gear icon in top right) and select Manage add-ons.
  4. Select All add-ons in the Show drop down.
  5. Show all add-ons screenshot.
  6. Find the Adobe PDF Reader add-on and select it.
  7. The Adobe PDF Reader ActiveX control.
  8. Click Disable.
  9. Click Enable.
  10. Open your XDP in Designer. Your Preview PDF tab should now be active.

AEM Forms and Adobe Sign Integration

If you are integrating Adobe AEM adaptive forms with Adobe Sign, you must create your Adobe Sign configuration in the global folder. If you create your Adobe Sign configuration in any other configuration folder, the AEM Forms interface will not display it as a valid option for your adaptive form.

Steps to Recreate: Follow these steps in an adaptive form.
  1. Open the adaptive form in Edit mode.
  2. Select the Form Container and click Configure (the Wrench icon).
  3. Collapse the Basic panel and expand the Electronic Signature panel.
  4. Click the Adobe Sign Cloud Server drop-down list. Notice that it only shows these 3 Adobe Sign cloud configurations.
  5. The Adobe PDF Reader ActiveX control.
Suggested Work-Around: Create your Adobe Sign configuration in the global folder. Follow these steps.
  1. Navigate to Tools – Cloud Services – Adobe Sign.
  2. Select the global configuration container. Notice the exact same Adobe Sign configurations that were displayed in the adaptive form interface.
  3. Create Adobe Sign configurations in the global folder.
  4. Click Create in the upper-right to create your Adobe Sign configuration.

Let me know if this helps you or if you are experiencing any other AEM Forms issues or bugs. jp@smartdoctech.com