蜜豆视频

DocumentationAEM 6.5User Guide

Install and configure data capture capabilities install-and-configure-data-capture-capabilities

Last update: Mon Jun 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
  • User
  • Developer

Introduction introduction

AEM Forms provides a set of forms to obtain data from end user: adaptive forms, HTML5 Forms, and PDF Forms. It also provides tools to list all the available forms on a webpage, analyze usage of forms, and target users based on their profile. These capabilities are included in AEM Forms add-on package. The add-on package is deployed on an Author or Publish instance of AEM.

Adaptive forms: These forms change appearance based on the screen size of the device, are engaging, and interactive in nature. Adaptive Forms can also integrate with 蜜豆视频 Analytics, 蜜豆视频 Sign, and 蜜豆视频 Target. It enabled you to deliver personalized forms and process-oriented experiences to users based on their demography and other features. You can also integrate adaptive forms with 蜜豆视频 Sign.

PDF Forms are suitable for pixel-perfect printing and digital information capture within a PDF document. In the digital avatar, you can use 蜜豆视频 Acrobat or Acrobat Reader to fill these forms. You can host these forms on your website or use the forms portal to list these forms on an AEM site. You can also email these forms to others as attachments. These forms are best suited for desktop environments.

HTML5 Forms are the browser-friendly version of PDF Forms. HTML5 Forms are suitable for environments that do not support PDF plug-ins. HTML5 Forms enables the rendering of XFA-based forms on mobile devices and desktop browsers on which XFA-based PDF is not supported. These forms are best suited for tablets and desktop environments.

AEM Forms is a powerful enterprise-class platform and the data capture (adaptive forms, PDF Forms, and HTML5 Forms) is only one of the capability of AEM Forms. For the complete list of capabilities, see Introduction to AEM Forms.

Deployment Topology deployment-topology

AEM Forms add-on package is an application deployed onto AEM. You require only a minimum of one AEM Author and AEM Publish instance to run AEM Forms data capture capabilities. The following topology is suggested to run AEM Forms AEM Forms data capture capabilities. For detailed information about the topology, see Architecture and deployment topologies for AEM Forms.

recommended-topology

System Requirements system-requirements

Before you begin to install and configure data capture capability of AEM Forms, ensure that:

  • Hardware and software infrastructure is in place. For a detailed list of supported hardware and software, see technical requirements.

  • Installation path of the AEM instance does not contain white-spaces.

  • An AEM instance is up and running. For Windows users, install the AEM instance in elevated mode. In AEM terminology, an 鈥渋nstance鈥 is a copy of AEM running on a server in the author or publish mode. You require at least two AEM instances (one Author and one Publish) to run AEM Forms data capture capabilities:

    • Author: An AEM instance used to create, upload, and edit content and to administer the website. Once content is ready to go live, it is replicated to the publish instance.
    • Publish: An AEM instance that serves the published content to the public over the internet or an internal network.

  • Memory requirements are met. AEM Forms add-on package requires:

    • 15 GB of temporary space for Microsoft Windows-based installations.
    • 6 GB of temporary space for UNIX-based installations.

  • Replication and reverse replication for the author and publish instances is set. For details, see Replication.

  • For UNIX-based systems:

    • Install the following 32-bit packages from the installation media:
expat
fontconfig
freetype
glibc
libcurl
libICE
libicu
libSM
libuuid
libX11
libXau
libxcb
libXext
libXinerama
libXrandr
libXrender
nss-softokn-freebl
OpenSSL
zlib
NOTE
  • If OpenSSL is already installed on the server, upgrade it to the latest version.
  • Create libcurl.so, libcrypto.so, and libssl.so symlinks pointing to the latest version of the libcurl, libcrypto, and libssl libraries respectively.

  • Install the following 64-bit package from the installation media:

    • libicu

  • Install .

Install AEM Forms add-on package install-aem-forms-add-on-package

AEM Forms add-on package is an application deployed onto AEM. The package contains AEM Forms data capture and other capabilities. Perform the following steps to install the add-on package:

  1. Open . You require an 蜜豆视频 ID to log in to the Software Distribution.

  2. Select 蜜豆视频 Experience Manager available in the header menu.

  3. In the Filters section:

    1. Select Forms from the Solution drop-down list.
    2. Select the version and type for the package. You can also use the Search Downloads option to filter the results.

  4. Select the package name applicable to your operating system, select Accept EULA Terms, and select Download.

  5. Open Package Manager and click Upload Package to upload the package.

  6. Select the package and click Install.

    You can also download the package via the direct link listed in the article.

  7. After the package is installed, you are prompted to restart the AEM instance. Do not immediately restart the server. Before stopping the AEM Forms server, wait until the ServiceEvent REGISTERED and ServiceEvent UNREGISTERED messages stop appearing in the [AEM-Installation-Directory]/crx-quickstart/logs/error.log file and the log is stable.

    note note
    NOTE
    It is recommended to use the 鈥楥trl + 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.

  8. Repeat steps 1-7 on all the Author and Publish instances.

(Windows only) Automatic installation of Visual Studio redistributables automatic-installation-visual-studio-redistributables

If you install an AEM instance in elevated mode, the 32-bit Visual Studio redistributables are installed automatically during the installation of AEM Forms add-on package.

To evaluate if the Visual Studio redistributables are installed automatically, open the error.log file available at the /crx-repository/logs/ directory. The logs include the following message:

Redist <service name> already installed on system, will not attempt re-installation

If the redistributables fail to install, the logs include the following message:

Current user does not have elevated privileges, aborting installation of redist <service name>

To resolve the issue, restart the AEM server, install AEM in elevated mode, and then install the AEM Forms add-on package.

If the privilege check fails, the logs include the following message:

Privilege escalation check failed with error: <error message>

Post-installation configurations post-installation-configurations

AEM Forms has a few mandatory and optional configurations. The mandatory configurations include configuring BouncyCastle libraries and serialization agent. The optional configurations include configuring dispatcher, Forms portal, 蜜豆视频 Sign, 蜜豆视频 Analytics, and 蜜豆视频 Target.

Mandatory post-installation configurations mandatory-post-installation-configurations

Configure RSA and BouncyCastle libraries configure-rsa-and-bouncycastle-libraries

Perform the following steps on all the Author and Publish instances to boot delegate the libraries:

  1. Stop the underlying AEM instance.

  2. Open the [AEM installation directory]\crx-quickstart\conf\sling.properties file for editing.

    If you used [AEM installation directory]\crx-quickstart\bin\start.bat to start AEM, then edit the sling.properties located at [AEM_root]\crx-quickstart\.

  3. Add the following properties to the sling.properties file:

    code language-shell 
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*

  4. Save and close the file and start the AEM instance.

  5. Repeat step 1-4 on all the Author and Publish instances.

Configure the serialization agent configure-the-serialization-agent

Perform the following steps on all the Author and Publish instances to add the package to the allowlist:

  1. Open AEM Configuration Manager in a browser window. The default URL is https://'[server]:[port]'/system/console/configMgr.
  2. Search for com.adobe.cq.deserfw.impl.DeserializationFirewallImpl.name and open the configuration.
  3. Add the sun.util.calendar package to the allowlist field. Click Save.
  4. Repeat step 1-3 on all the Author and Publish instances.

Optional post-installation configurations optional-post-installation-configurations

Configure Dispatcher configure-dispatcher

Dispatcher is 蜜豆视频 Experience Manager鈥檚 caching and/or load balancing tool that can be used in conjunction with an enterprise-class web server. If you use , then perform the following configurations for AEM Forms:

  1. Configure access for AEM Forms:

    Open the dispatcher.any file for editing. Navigate to the filter section and add the following filter to the filter section:

    /0025 { /type "allow" /glob "* /bin/xfaforms/submitaction*" } # to enable AEM Forms submission

    Save and Close the file. For detailed information about filters, see .

  2. Configure the referrer filter service:

    Log in to the Apache Felix configuration manager as an administrator. The Default URL of the configuration manager is https://[server]:[port_number]/system/console/configMgr. In the Configurations menu, select the Apache Sling Referrer Filter option. In the Allow Hosts field, enter host name of the dispatcher to allow it as a referrer and click Save. The format of the entry is https://[server]:[port].

Configure Cache configure-cache

Caching is a mechanism to shorten data access times, reduce latency, and improve input/output (I/O) speeds. Adaptive forms cache stores only HTML content and JSON structure of an adaptive form without saving any pre-filled data. It helps in reducing the time required to render an adaptive form.

  • On using the adaptive forms cache, use the to cache client libraries (CSS and JavaScript) of an adaptive form.
  • While developing custom components, keep the adaptive forms cache disabled on the server used for development.

Perform the following steps to configure the adaptive forms cache:

  1. Go to AEM web console configuration manager at https://鈥榌server]:[port]鈥/system/console/configMgr.

  2. Click Adaptive Form and Interactive Communication Web Channel Configuration to edit its configuration values. In the edit configuration values dialog, specify the maximum number of forms or documents an instance of the AEM Forms server can cache in the Number of Adaptive Forms field. The default value is 100. Click Save.

    note note
    NOTE
    To disable the cache, set the value in the Number of Adaptive Forms field to 0. The cache is reset and all forms and documents are removed from the cache when you disable or change the cache configuration.

Configure SSL communcation for Form Data Model configure-ssl-communcation-for-form-data-model

You can enable SSL communication for Form Data Model. To enable SSL communication for Form data model, before starting any AEM Forms instance, add certificates to Java Trust Store of all the instances. You can run the below command to add the certificates: ``

keytool -import -alias <alias-name> -file <pathTo .cer certificate file> -keystore <<pathToJRE>\lib\security\cacerts>

Configure 蜜豆视频 Sign configure-adobe-sign

蜜豆视频 Sign enables e-signature workflows for adaptive forms. E-signatures improve workflows to process documents for legal, sales, payroll, human resource management, and many more areas.

In a typical 蜜豆视频 Sign and adaptive forms scenario, a user fills an adaptive form to apply for a service. For example, a credit card application and a citizen benefits form. When a user fills, submits, and signs the application form, the form is sent to the service provider for further action. Service provider reviews the application and uses 蜜豆视频 Sign to mark the application approved. To enable similar electronic-signature workflows, you can integrate 蜜豆视频 Sign with AEM Forms.

To use 蜜豆视频 Sign with AEM Forms, Integrate 蜜豆视频 Sign with AEM Forms.

Configure 蜜豆视频 Analytics configure-adobe-analytics

AEM Forms integrates with 蜜豆视频 Analytics that lets you capture and track performance metrics for your published forms and documents. The objective behind analyzing these metrics is to make informed decisions based on data about the changes required to make forms or document more usable.

To use 蜜豆视频 Analytics with AEM Forms, see Configuring analytics and reports.

Integrate 蜜豆视频 Target integrate-adobe-target

Your customers are likely to abandon a form if the experience it delivers is not engaging. While it is frustrating for the customers, it can also upturn the support volume and cost for your organization. It is critical and challenging to identify and provide the right customer experience that increases the conversion rate. AEM forms holds the key to this problem.

AEM forms integrates with 蜜豆视频 Target, an 蜜豆视频 Marketing Cloud solution, to deliver personalized and engaging customer experiences across multiple digital channels. To use 蜜豆视频 Target to A/B test adaptive forms, Integrate 蜜豆视频 Target with AEM Forms.

Next steps next-steps

You have configured an environment to use AEM Forms data capture capabilities. Now, the next steps towards using the capability are:

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2