AEM 6.4 Forms Guide
Release Notes
- Release Notes
- New features summary
- Deprecated features
Getting Started
- Introduction to AEM Forms
- Introduction to authoring adaptive forms
- Introduction to Interactive Communications
- Introduction to managing forms
- Tutorial: Create your First Adaptive Form
- Tutorial: Create your First Interactive Communication
- AEM Forms Reference Collaterals
Install and configure AEM Forms
- Architecture and deployment topologies for AEM Forms
- Choosing a persistence type for an AEM Forms installation
- Install AEM Forms on OSGi
- Install AEM Forms on JEE
- Configure AEM Forms
Upgrade AEM Forms
- Available upgrade paths
- Upgrade AEM Forms on OSGi
- Upgrade AEM Forms on JEE
Manage AEM Forms
- AEM Forms on OSGi Groups and Privileges
- Create new folders to categorize forms
- Searching for forms and assets
- Manage form metadata
- Download an XFA or a PDF form template
- Deleting forms and related resources
- Getting XDP and PDF documents in AEM Forms
- Importing and exporting assets to AEM Forms
- Supporting new locales for adaptive forms localization
- Handling user data
- Hardening AEM Forms Environment
Form Data Model
- Introduction to AEM Forms Data Integration
- Configure data sources
- Microsoft Dynamics Odata configuration
- Create form data model
- Work with form data model
- Use form data model
Adaptive Forms - Basic Authoring
- Best practices for working with adaptive forms
- Creating an adaptive form
- Adaptive form fragments
- Configuring the Submit action
- Using CAPTCHA in adaptive forms
- Adaptive forms keywords
- Tables in adaptive forms
- Auto-save an adaptive form
- Configuring redirect page
- Creating accessible adaptive forms
- Creating forms with repeatable sections
- Embed an adaptive form or interactive communication in AEM sites page
- Embed adaptive form in external web page
- Inline styling of adaptive form components
- Introduction to multi-step form sequence
- Layout capabilities of adaptive forms
- Placeholder text in AEM Forms
- Previewing a form
- Reusing adaptive forms
- Separator component in adaptive forms
- Apply electronic signatures to a form using scribble signatures
- AEM Forms Keyboard Shortcuts
- Associating submission reviewers with a form
- Authoring in-context help for form fields
Adaptive Forms - Advanced Authoring
- Creating adaptive forms using JSON Schema
- Creating adaptive forms using XML Schema
- Using Adobe Sign in an adaptive form
- Creating and using themes
- Adaptive forms rule editor
- API to invoke form data model service from adaptive forms
- Asynchronous submission of adaptive forms
- Create an adaptive form using a set of adaptive forms
- Adaptive Form Templates
- Adaptive Form Expressions
- Generate Document of Record for adaptive forms
- Improve performance of large forms with lazy loading
- Prefill adaptive form fields
- Using SOM expressions in adaptive forms
- Adding information from user data to form submission metadata
- XFA support in XDP-based adaptive forms
- Changing Page Zero content in Designer
- Grant rule editor access to select user groups
- Using AEM translation workflow to localize adaptive forms and document of record
- Automate testing of adaptive forms
- Styling constructs for adaptive forms
- Synchronizing Adaptive Forms with XFA Form Templates
- Integrate Adobe Sign with AEM Forms
- Creating and managing reviews for assets in forms
- Standard validation error messages for adaptive forms
Interactive Communications
- Introduction to Interactive Communication authoring UI
- Create an Interactive Communication
- Using charts in Interactive Communications
- Texts in Interactive Communications
- Conditions in Interactive Communications
- Prepare and send Interactive Communication using the Agent UI
- Print channel and web channel
- Interactive Communications configuration properties
Workflows
- Forms-centric workflow on OSGi
- Forms-centric workflow on OSGi - Step Reference
- Dynamically select a user or group for AEM Forms-centric workflow steps
- Actions and capabilities of Form-centric AEM Workflows on OSGi and AEM Forms JEE workflows
- Initiate Document Services APIs from AEM Workflow
AEM Forms Workspace
- Introduction to AEM Forms workspace
- Working with AEM Forms workspace
- AEM Forms Workspace Architecture
- Features of AEM Forms workspace not available in Flex workspace
- Features of Flex workspace not available in AEM Forms workspace
- Backbone interaction
- Description of reusable components
- Document details for renderer
- Integrating AEM Forms workspace components in web applications
- New render and submit service
- Understanding the folder structure
- Integrating third-party applications in AEM Forms workspace
- AEM Forms workspace JSON object description
- Introduction to Customizing AEM form workspace
- Generic steps for AEM Forms workspace customization
- Changing the locale of AEM Forms workspace user interface
- Creating a new login screen
- Customizing error dialogs
- Customizing tabs for a task
- Customizing the task details page
- Customizing the listing of process instances
- Customizing Task Actions
- Displaying additional data in ToDo list
- Getting Task Variables in Summary URL
- Customize images used in route actions
- Minification of the JavaScript files
- Customize tracking tables
- Updating the link to the documentation
- Working with Formsets in AEM Forms workspace
- APIs used in AEM Forms workspace
- Initiating a new process with existing process data in AEM Forms workspace
- Hosting two AEM Forms workspace instances on one server
- Changing the color scheme of the interface
- Changing the font on the interface
- Changing the organization logo for branding
- Displaying information in the Task Summary pane
- Displaying the user avatar
- Getting started with AEM Forms workspace
- Managing tasks in an organizational hierarchy using Manager View
- Starting processes
- Tracking processes
- Single Sign On and timeout handlers
- Using an adaptive form in HTML Workspace
- Integrating AEM forms workspace with Microsoft Office SharePoint Server
- Working with To-do lists
- Troubleshooting guidelines for AEM Forms workspace
AEM Forms app
- Introduction to AEM Forms app
- Set up environment for AEM Forms app
- Set up the Xcode project and build the iOS app
- Building a secure AEM Forms app for iOS
- Set up the Visual Studio project and build the Windows app
- Set up the Android studio project and build the Android app
- Build the AEM Forms Android app
- Distribute AEM Forms app
- Gesture customization
- Branding Customization
- Theme Customization
- Logging in to AEM Forms app
- Home screen
- Synchronizing the app
- Working with a Form
- Working with Startpoints
- Opening a task
- Saving a task or form as a draft
- Using autosave in AEM Forms app
- Save forms as templates
- Adding attachments
- Working in the offline mode
- Updating general settings
- Troubleshoot AEM Forms app
HTML5 Forms
- Introduction to HTML5 forms
- Getting started with HTML5 forms
- Architecture of HTML5 forms
- Feature differentiation between HTML5 forms and PDF forms
- Frequently asked questions (FAQ) for HTML5 forms
- Designing form templates for HTML5 forms
- Best practices for HTML5 forms
- Designing accessible HTML5 forms
- Generate HTML5 preview of an XDP form
- Rendering form template for HTML5 forms
- Enabling attachments for an HTML5 form
- HTML5 forms service proxy
- Optimizing HTML5 forms
- Screen readers for HTML5 forms
- Creating a custom profile for HTML5 forms
- Right-to-left languages in HTML5 forms
- Integrating Form Bridge with custom portal for HTML5 forms
- Create custom appearances in HTML5 forms
- Changing default styles of HTML5 forms
- Picture clause support for HTML5 forms
- Create accessible complex tables in HTML5 forms
- Creating CSS styles for HTML5 forms
- Customizing error messages for HTML5 forms
- Saving an HTML5 form as a draft
- Enable logging for HTML5 forms
- Debugging HTML5 forms
- Scripting support for HTML5 forms
- Form set in AEM Forms
Letters and Correspondences
- Correspondence Management Overview
- Layout Design
- Data Dictionary
- Document Fragments
- Create Letter
- Create Correspondence
- Remote functions in Expression Builder
- Manage agent signature images
- Post processing of letters and interactive communications
- Add custom action to the Asset Listing view
- Add custom action/button in Create Correspondence UI
- Add custom properties to Correspondence Management assets
- Customize create correspondence UI
- Customize text editor
- Correspondence Management: Troubleshooting
- APIs to access letter instances
- Integrating Create Correspondence UI with your custom portal
- Custom special characters in Correspondence Management
- Custom watermark in letter PDF preview
- Configuring a Correspondence Management solution
- Inline condition and repeat in Interactive Communications and letters
- Document Fragments
- Correspondence Management Configuration Properties
Integrate AEM Forms with Experience Cloud solutions
- Create targeted experiences in AEM Forms
- Measure and improve effectiveness and conversion of forms
- Configuring analytics and reports
- View and understand AEM Forms analytics reports
- Create and manage A/B test for adaptive forms
Publish and process AEM Forms
- Introduction to publishing forms on a portal
- Sample for integrating drafts & submissions component with database
- Configuring storage services for drafts and submissions
- Manage Forms applications and tasks in AEM Inbox
- Watched folder in AEM Forms
- Drafts and submissions component
- Embedding link component in a page
- Publishing and unpublishing forms and documents
- Listing forms on a web page using APIs
- Accessing and filling published forms
- Sending a form submission acknowledgement via email
- Create or Configure a watched folder
- Use custom email templates in an Assign Task step
- Use metadata in an email notification
Forms Portal
- Customizing templates for forms portal components
- Enabling forms portal components
- Creating a forms portal page
- APIs to work with submitted forms on forms portal
- Custom storage for drafts and submissions component
Document Services
- Overview of AEM Document Services
- Forms Service
- Output Service
- ConvertPDF Service
- Barcoded Forms Service
- Using Assembler Service
- Use HSM to digitally sign or certify documents
- Using AEM Document Services Programmatically
- Using the sendToPrinter API
Document Security
- Document security offerings
- Enable AEM to search document security protected PDF documents
- Reader extending policy-protected PDF documents using Portable Protection Library
- Enable AEM to search document security protected PDF and Microsoft Office documents
- Protect a document on behalf of another user
Forms Designer
- Using Designer
- Designer Quick Start Tutorials
- Designer Samples
- Designer Scripting Basics
- Designer Scripting Reference
- Designer FormCalc Reference
- Using Scribble Signature in HTML5 forms
Customize AEM Forms
- Appearance framework for adaptive and HTML5 forms
- Creating a custom adaptive form template
- Creating custom layout components for adaptive forms
- Adding custom action on form lister items
- Customize layout and positioning of error messages of an adaptive form
- Creating a custom toolbar action
- Customizing form event tracking
- Create custom appearances for adaptive form fields
- Customizing Draft and Submission data services
- Dynamically populating drop-down lists
- Writing custom Submit action for adaptive forms
- Creating custom toolbar layout
- Displaying components based on the template used
- Creating custom adaptive form themes
Transaction Reports
- Transaction Reports Overview
- Viewing and Understanding Transaction Reports
- Transaction Reports Billable APIs
- Record a transaction for custom implementations
Administrator help for AEM Forms on JEE
- Get Started
  - General AEM Forms settings
  - Update the license type for the deployment
- Setting up and managing domains
  - Adding domains
  - Delete a domain
  - Configure account-locking settings
  - Editing and converting existing domains
  - Configuring authentication providers
  - Synchronizing directories
  - Configuring directories
- Configuring User Management
  - Change the order of evaluation for authentication
  - Configure the LDAP bind password
  - Configure AEM forms to prefetch domain information
  - Configuring certificate-based authentication
  - Configure SAML service provider settings
  - Enabling single sign-on in AEM forms
  - Configure User Management for an SSL-enabled LDAP server
  - Importing and exporting the configuration file
  - Configure advanced system attributes
  - Preventing CSRF attacks
- Setting up and organizing users
  - Adding and configuring users
  - Just-in-time user provisioning
  - Creating and configuring groups
  - Search for a user or group
  - Creating and configuring roles
- Connecting to a content management system
  - Configuring Connector for EMC Documentum
  - Configuring Connector for IBM FileNet
  - Configuring Connector for IBM Content Manager
  - Configuring Connector for Microsoft SharePoint
- Managing certificates and credentials
  - Adding and removing user name and password credentials
  - Managing certificate revocationlists
  - Basics of managing certificates and credentials
  - Managing certificates
  - Managing HSM credentials
  - Managing local credentials
- Importing and managing applications and archives
  - Change the number of items displayed on the Applications and Services pages
  - Import and manage archives
  - Import and manage applications
- Managing Services
  - Configure service settings
  - Starting and stopping services
- Managing Endpoints
  - Adding, enabling, modifying, or removing endpoints
  - Configuring email endpoints
  - Configuring Remoting endpoints
  - Configuring watched folder endpoints
  - Configuring Task Manager endpoints
  - Types of endpoints
- Configuring Acrobat Reader DC extensions
  - Certificate types used by Acrobat Reader DC extensions
  - Recognizing valid and expired certificates in PDF documents
  - Configuring Acrobat Reader DC extensions for data capture
  - Review credential use information
  - Configuring credentials for use with Acrobat Reader DC extensions
  - Review the usage rights of a PDF file
  - Enabling online commenting for Adobe Reader web browser plug-in
  - Setting timeout values for use with Acrobat Reader DC extensions
- Working with PDF Generator
  - Introduction to working with PDF Generator
  - Enabling multi-threaded file conversions
  - Configuring Adobe PDF settings
  - Configuring security settings
  - Configuring file type settings
  - Importing and exporting PDF Generator configuration files
  - Enable PDF/A support
  - Setting up a PDFG Network Printer (Windows only)
  - Configuring fallback fonts
  - Modifying the PDF Export conversion settings
  - Converting files using PDF Generator
- Configuring SSL
  - Overview of configuring SSL
  - Configuring SSL for JBoss Application Server
  - Configuring SSL on Windows Vista
  - Configuring SSL for WebLogic Server
  - Configuring SSL for WebSphere Application Server
- Working with document security
  - About document security
  - High-volume secure information delivery
  - Configuring client and server options
  - Managing invited and local user accounts
  - Controlling access to policy-protected documents
  - Monitoring events
  - Creating and managing policies
  - Using the document security webpages
  - Creating and managing policy sets
  - Registering as a User
- Configuring Forms
  - Basics of configuring forms
  - Setting internationalization options
  - Configuring caching for Forms
  - Specifying XCI configuration options
  - Configuring form output
  - Specifying fonts to embed
  - Configuring locations for Forms
  - Specifying security settings
  - Configuring validation messages
- Configuring Output
  - Overview of output service
  - Change the character set
  - Specify XCI configuration options
  - Configuring caching for Output
  - Specify file locations for Output
  - Make fonts available
  - Specify fonts to embed
  - Specify security settings
- Configuring forms workflow
  - About administration and process terminology
  - Managing Processes
  - Configuring Business Calendars
  - Overview of Forms workflow
  - Configuring Out of Office Settings
  - Searching for process instances
  - Configuring Server Settings
  - Working with stalled operations and branches
  - Configuring Shared Queues
  - Working with tasks
- Configuring Workspace
  - Overview of Workspace
  - Importing and exporting global settings
  - Setting the message of the day
  - Customizing search templates
  - Managing the categories displayed in Workspace
- Health Monitor
  - Overview of Health Monitor
  - Fine-tuning Health Monitor performance
  - View statistics related to Work Manager
  - View system information
  - Purge records from the Job Manager database
- Maintaining AEM forms
  - Log files
  - User Management
  - Monitoring AEM forms deployments
  - Work Manager and throttling
  - Running AEM forms in maintenance mode
- Maintaining the AEM forms Database
  - DB2 database: Running a process weekly
  - Oracle database maximum open cursors threshold
  - IBM DB2 database: Running commands for regular maintenance
  - Purging process data
  - Microsoft SQL Server database: Fine-tuning the configuration
  - Tips for minimizing database growth
- Maintaining the Application Server
  - Application server websites
  - Global document storage directory
  - Considerations when running AdministrationConsole
  - Starting and stopping WebLogic Server
  - Enhancing application server performance
  - Starting and stopping WebSphere Application Server
- AEM forms Backup and Recovery
  - Backing up and recovering the EMC Documentum repository
  - Enabling and disabling safe backup mode
  - Backing up the AEM forms data
  - Files to back up and recover
  - Backup and recovery strategy for AEM forms
  - PDF Generator backup limitations
  - Backup strategies for watched folders
  - Recovering the AEM forms data
  - Backup strategy for Connector for EMC Documentum users
  - Strategy for backup and restore in a clustered environment
- System information service
  - Set up the System information service
  - System information Service APIs
Process Reporting
- Introduction to Process Reporting
- Getting Started with Process Reporting
- How Process Reporting Works
- Pre-defined reports in Process Reporting
- Custom Reports in Process Reporting
- Ad-hoc Queries in Process Reporting
- Troubleshooting Process Reporting
Developer Reference
- Developer basics
- HTML Template Language
- AEM plug-in to debug adaptive forms
- AEM Forms Java API Reference
- AEM Forms on JEE Java API Reference
- Form Bridge APIs for HTML5 forms
- JavaScript Library API reference for Adaptive Forms
- Assembler Service and DDX Reference
- Workbench Help
- Programming with AEM Forms on JEE

Getting Task Variables in Summary URL

The summary page displays task-related information. This article describes how you can reuse task-related information in the summary page.

In this sample orchestration, an employee submits a leave application form. The application form then goes to the employee’s manager for approval.

Create a sample HTML renderer (html.esp) for resourseType Employees/PtoApplication.

The renderer assumes the following properties to be set on the node:

ename
empid
reason
duration

NOTE

This renderer is the summary page template.

The following sample code for this renderer is contained in:

apps/Employees/PtoApplication/html.esp

<html>
  <body>
    <table>
    <tbody>
    <tr>
        <td>
            <h3>Employee Name: <%= currentNode.ename %></h3>
            <h3>Employee ID: <%= currentNode.eid %></h3>
            <h3>Leave duration: <%= currentNode.duration %> days</h3>
            <h3>Reason: <%= currentNode.reason %></h3>
        </td>
    </tr>
    </tbody>
    </table>
  </body>
</html>

Modify the orchestration to extract the four properties from the submitted form data. After this create a node in CRX of type Employees/PtoApplication, with the properties populated.
1. Create a process create PTO summary and use this as a subprocess before the Assign Task operation in your orchestration.
2. Define employeeName, employeeID, ptoReason, totalDays, and nodeName as input variables in your new process. These variables will be passed as submitted form data.
  
  Also define an output variable **ptoNodePath **which will be used while setting the summary Url.
3. In the create PTO summary process, use the set value component to set the input details in a **nodeProperty **(nodeProps) map.
  
  The keys in this map should be the same as the keys defined in your HTML renderer in the previous step.
  
  Also, add a sling:resourceType key with value Employees/PtoApplication in the map.
4. Use the subprocess storeContent from the ContentRepositoryConnector service in the create PTO summary process. This subprocess creates a CRX node.
  
  It takes three input variables:
  - Folder Path: The path where the new CRX node is created. Set the path as /content.
  - Node name: Assign the input variable nodeName to this field. This is a unique node name string.
  - Node Type: Define the type as nt:unstructured. The output of this process is nodePath. The nodePath is the CRX path of the newly created node. The ndoePath would be the final output of the create PTO summary process.
5. Pass the submitted form data (employeeName, employeeID, ptoReason, and totalDays) as input to the new process create PTO summary. Take the output as ptoSummaryNodePath.
Define the summary Url as an XPath expression containing the server details along with ptoSummaryNodePath.

XPath: concat('https://[*server*]:[*port*]/lc',/process_data/@ptoSummaryNodePath,'.html').