Documentation AEM as a Cloud Service User Guide

Adaptive Form Submit Action

Last update: April 14, 2025

Applies to:
Experience Manager as a Cloud Service

CREATED FOR:

User
Developer

Version	Article link
AEM 6.5	Click here
AEM as a Cloud Service (Core Components)	Click here
AEM as a Cloud Service (Foundation Components)	This article

Applies to: ✔️ Adaptive Form Foundation Components. ❌ Adaptive Form Core Components. Adobe recommends using Core Components to add Adaptive Forms to an AEM Sites Page or to create standalone Adaptive Forms.

A Submit Action is triggered when a user clicks the Submit button on an Adaptive Form. Forms as a Cloud Service provides the following Submit Actions out of the box.

Submit to REST endpoint
Send email
Submit using Form Data Mode (FDM)l
Invoke an AEM Workflow
Submit to SharePoint
Submit to OneDrive
Submit to Azure Blob Storage
Submit to Power Automate
Submit to Workfront Fusion
Submit to Marketo Engage

You can also extend the default Submit Actions to create your own Submit Action.

You can configure a Submit Action in the Submission section of the Adaptive Form Container properties, in the sidebar.

Configure Submit Action

Submit to REST endpoint

Use the Submit to REST Endpoint action to post the submitted data to a rest URL. The URL can be of an internal (the server on which the form is rendered) or an external server.

To post data to an internal server, provide path of the resource. The data is posted the path of the resource. For example, /content/restEndPoint. For such post requests, the authentication information of the submit request is used.

To post data to an external server, provide a URL. The format of the URL is https://host:port/path_to_rest_end_point. Ensure that you configure the path to handle the POST request anonymously.

Mapping for field values passed as Thank You Page parameters

In the example above, user entered information in textbox is captured using parameter param1. Syntax to post data captured using param1 is:

String data=request.getParameter("param1");

Similarly, parameters that you use for posting XML data and attachments are dataXml and attachments.

For example, you use these two parameters in your script to parse data to a rest end point. You use the following syntax to store and parse the data:

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

In this example, data stores the XML data, and att stores attachment data.

The Submit to REST endpoint Submit Action submits the data filled in the form to a configured confirmation page as part of the HTTP GET request. You can add the name of the fields to request. The format of the request is:

{fieldName}={request parameter name}

As shown in the image below, param1 and param2 are passed as parameters with values copied from the textbox and numericbox fields for the next action.

Configuring Rest Endpoint Submit Action

You can also Enable POST request and provide a URL to post the request. To submit data to the AEM server hosting the form, use a relative path corresponding to the root path of the AEM server. For example, /content/forms/af/SampleForm.html. To submit data to any other server, use absolute path.

NOTE

To pass the fields as parameters in a REST URL, all the fields must have different element names, even if the fields are placed on different panels.

Send Email

You can use the Send Email Submit Action to send an email to one or more recipients on successful submission of the form. The email generated can contain form data in a predefined format. For example, in the following template, customer name, shipping address, name of the state, and zip code are retrieved from submitted form data.

```

Hi ${customer_Name},

The following is set as your deafult shipping address:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

Regards,
WKND

```

NOTE

All the form fields must have different element names, even if the fields are placed on different panels of an Adaptive Form.
AEM as a Cloud Service requires outbound mail to be encrypted. By default, outbound email is disabled. To activate it, submit a support ticket to Requesting Access.

You can also include attachments and a Document of Record (DoR) to the email. To enable Attach Document of Record option, configure the Adaptive Form to generate a Document of Record (DoR). You can enable the option to generate a Document of Record from Adaptive Form properties.

Submit using Form Data Model (FDM)

The Submit using Form Data Model Submit Action writes submitted Adaptive Form data for the specified data model object in a Form Data Model (FDM) to its data source. When configuring the Submit Action, you can choose a data model object whose submitted data you want to write back to its data source.

In addition, you can submit a form attachment using a Form Data Model (FDM) and a Document of Record (DoR) to the data source. For information about form data model (FDM), see AEM Forms Data Integration.

Invoke an AEM Workflow

The Invoke an AEM Workflow Submit Action associates an Adaptive Form with an AEM Workflow. When a form is submitted, the associated workflow starts automatically on the Author instance. You can save the data file, attachments, and Document of Record to the payload location of the workflow or to a variable. If the workflow is marked for external data storage and configured for an external data storage, then only the variable option is available. You can select from the list of variables available for the workflow model. If the workflow is marked for external data storage at a later stage and not at the time of workflow creation, then ensure that the required variable configurations are in place.

The Submit Action places the following at the payload location of the workflow, or the variable if the workflow is marked for external data storage:

Data file: It contains data submitted to the Adaptive Form. You can use the Data File Path option to specify the name of the file and path of file relative to the payload. For example, the /addresschange/data.xml path creates a folder named addresschange and places it relative to payload. You can also specify only data.xml to send only submitted data without creating a folder hierarchy. If the workflow is marked for external data storage, use the variable option and select the variable from the list of variables available for the workflow model.
Attachments: You can use the Attachment Path option to specify the folder name to store the attachments uploaded to the Adaptive Form. The folder is created relative to the payload. If the workflow is marked for external data storage, use the variable option and select the variable from the list of variables available for the workflow model.
Document of Record: It contains the Document of Record generated for the Adaptive Form. You can use the Document of Record Path option to specify the name of the Document of Record file and path of file relative to the payload. For example, the /addresschange/DoR.pdf path creates a folder named addresschange relative to the payload and places the DoR.pdf relative to payload. You can also specify only DoR.pdf to save only Document of Record without creating a folder hierarchy. If the workflow is marked for external data storage, use the variable option and select the variable from the list of variables available for the workflow model.

Before using the Invoke an AEM Workflow Submit Action configure the following for the AEM DS settings service configuration:

Processing Server URL: The Processing Server is the server where the Forms or AEM Workflow is triggered. This can be same as the URL of the AEM author instance or another server.
Processing Server User Name: Workflow user’s username
Processing Server Password: Workflow user’s password

Submit to SharePoint

The Submit to SharePoint Submit Action connects an Adaptive Form with a Microsoft® SharePoint Storage. You can submit the form data file, attachments, or Document of Record to the connected Microsoft® Sharepoint Storage.

Using Submit to SharePoint, you can:

Connect an Adaptive Form to SharePoint Document Library
Connect an Adaptive Form to SharePoint List

Connect an Adaptive Form to SharePoint Document Library

To use the Submit to SharePoint Document Library Submit Action in an Adaptive Form:

Create a SharePoint Document Library Configuration: It connects AEM Forms to your Microsoft® Sharepoint Storage.
Use the Submit to SharePoint submit action in an Adaptive Form: It connects your Adaptive Form to configured Microsoft® SharePoint.

Create a SharePoint Document Library configuration

To connect AEM Forms to your Microsoft® Sharepoint Document Library Storage:

Go to your AEM Forms Author instance > Tools > Cloud Services > Microsoft® SharePoint.
Once you select the Microsoft® SharePoint, you are redirected to SharePoint Browser.
Select a Configuration Container. The configuration is stored in the selected Configuration Container.
Click Create > SharePoint Document Library from the drop-down list. The SharePoint configuration wizard appears.
Specify the Title, Client ID, Client Secret and OAuth URL. For information on how to retrieve Client ID, Client Secret, Tenant ID for OAuth URL, see Microsoft® Documentation.
- You can retrieve the Client ID and Client Secret of your app from the Microsoft® Azure portal.
- In the Microsoft® Azure portal, add the Redirect URI as https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Replace [author-instance] with the URL of your Author instance.
- Add the API permissions offline_access and Sites.Manage.All to provide read/write permissions.
- Use OAuth URL: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Replace <tenant-id> with the tenant-id of your app from the Microsoft® Azure portal.
NOTE
The client secret field is mandatory or optional depends upon your Azure Active Directory application configuration. If your application is configured to use a client secret, it is mandatory to provide the client secret.
Click Connect. On a successful connection, the Connection Successful message appears.
Now, select SharePoint Site > Document Library > SharePoint Folder, to save the data.
NOTE
By default, forms-ootb-storage-adaptive-forms-submission is present at selected SharePoint Site.

Create a folder as forms-ootb-storage-adaptive-forms-submission, if not already present in the Documents library of the selected SharePoint Site by clicking Create Folder.

Now, you can use this SharePoint Sites configuration for the submit action in an Adaptive Form.

Use SharePoint Document Library Configuration in an Adaptive Form

You can use the created SharePoint Document Library configuration in an Adaptive Form, to save data or generated Document of Record in a SharePoint folder. Perform the following steps to use a SharePoint Document Library storage configuration in an Adaptive Form as:

Create an Adaptive Form.
NOTE
Select the same Configuration Container for an Adaptive Form, where you have created your SharePoint Document Library storage.

If no Configuration Container is selected, then the global Storage Configuration folders appear in the Submit Action properties window.
Select Submit Action as Submit to SharePoint.
Select the Storage Configuration, where you want to save your data.
Click Save to save the Submit settings.

When you submit the form, the data is saved in the specified Microsoft® Sharepoint Document Library Storage.
Folder structure to save data is /folder_name/form_name/year/month/date/submission_id/data.

NOTE

Attachments are also stored in the /folder_name/form_name/year/month/date/submission_id/data directory. However, if you select Save Attachments with Original Name, the attachments are stored in the folder using their original filenames.

Connect an Adaptive Form to Microsoft® SharePoint List

video poster

https://video.tv.adobe.com/v/3424820/connect-aem-adaptive-form-to-sharepointlist/?quality=12&learn=on

To use the Submit to SharePoint List Submit Action in an Adaptive Form:

Create a SharePoint List Configuration: It connects AEM Forms to your Microsoft® Sharepoint List Storage.
Use the Submit using Form Data Model (FDM) in an Adaptive Form: It connects your Adaptive Form to configured Microsoft® SharePoint.

Create a SharePoint List Configuration

To connect AEM Forms to your Microsoft® Sharepoint List:

Go to Tools > Cloud Services > Microsoft® SharePoint.
Select a Configuration Container. The configuration is stored in the selected Configuration Container.
Click Create > SharePoint List from the drop-down list. The SharePoint configuration wizard appears.
Specify the Title, Client ID, Client Secret and OAuth URL. For information on how to retrieve Client ID, Client Secret, Tenant ID for OAuth URL, see Microsoft® Documentation.
- You can retrieve the Client ID and Client Secret of your app from the Microsoft® Azure portal.
- In the Microsoft® Azure portal, add the Redirect URI as https://[author-instance]/libs/cq/sharepointlist/content/configurations/wizard.html. Replace [author-instance] with the URL of your Author instance.
- Add the API permissions offline_access and Sites.Manage.All in the Microsoft® Graph tab to provide read/write permissions. Add AllSites.Manage permission in the Sharepoint tab to interact remotely with SharePoint data.
- Use OAuth URL: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Replace <tenant-id> with the tenant-id of your app from the Microsoft® Azure portal.
  
  NOTE
  The client secret field is mandatory or optional depends upon your Azure Active Directory application configuration. If your application is configured to use a client secret, it is mandatory to provide the client secret.
Click Connect. On a successful connection, the Connection Successful message appears.
Select SharePoint Site and SharePoint List from the drop-down list.
Select Create to create the cloud configuration for the Microsoft® SharePointList.

Use the Submit using Form Data Model (FDM) in an Adaptive Form

You can use the created SharePoint List configuration in an Adaptive Form, to save data or generated Document of Record in a SharePoint List. Perform the following steps to use a SharePoint List storage configuration in an Adaptive Form as:

When you submit the form, the data is saved in the specified Microsoft® Sharepoint List Storage.

NOTE

In Microsoft® SharePoint List, the following column types are not supported:

image column
metadata column
person column
external data column

Submit to OneDrive

The Submit to OneDrive Submit Action connects an Adaptive Form with a Microsoft® OneDrive. You can submit the form data, file, attachments, or Document of Record to the connected Microsoft® OneDrive Storage. To use the Submit to OneDrive Submit Action in an Adaptive Form:

Create a OneDrive Configuration: It connects AEM Forms to your Microsoft® OneDrive Storage.
Use the Submit to OneDrive submit action in an Adaptive Form: It connects your Adaptive Form to
configured Microsoft® OneDrive.

Create a OneDrive Configuration

To connect AEM Forms to your Microsoft® OneDrive Storage:

Go to your AEM Forms Author instance > Tools > Cloud Services > Microsoft® OneDrive.
Once you select the Microsoft® OneDrive, you are redirected to OneDrive Browser.
Select a Configuration Container. The configuration is stored in the selected Configuration Container.
Click Create. The OneDrive configuration wizard appears.
Specify the Title, Client ID, Client Secret and OAuth URL. For information on how to retrieve Client ID, Client Secret, Tenant ID for OAuth URL, see Microsoft® Documentation.
- You can retrieve the Client ID and Client Secret of your app from the Microsoft® Azure portal.
- In the Microsoft® Azure portal, add the Redirect URI as https://[author-instance]/libs/cq/onedrive/content/configurations/wizard.html. Replace [author-instance] with the URL of your Author instance.
- Add the API permissions offline_access and Files.ReadWrite.All to provide read/write permissions.
- Use OAuth URL: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Replace <tenant-id> with the tenant-id of your app from the Microsoft® Azure portal.
NOTE
The client secret field is mandatory or optional depends upon your Azure Active Directory application configuration. If your application is configured to use a client secret, it is mandatory to provide the client secret.
Click Connect. On a successful connection, the Connection Successful message appears.
Now, select OneDrive Container > [OneDrive Folder] to save the data.
NOTE
By default, forms-ootb-storage-adaptive-forms-submission is present at OneDrive Container.

Create a folder as forms-ootb-storage-adaptive-forms-submission, if not already present by clicking Create Folder.

Now, you can use this OneDrive storage configuration for the submit action in an Adaptive Form.

Use OneDrive Configuration in an Adaptive Form

You can use the created OneDrive storage configuration in an Adaptive Form, to save data or generated Document of Record in a OneDrive folder. Perform the following steps to use OneDrive storage configuration in an Adaptive Form as:

Create an Adaptive Form.
NOTE
Select the same Configuration Container for an Adaptive Form, where you have created your OneDrive storage.

If no Configuration Container is selected, then the global Storage Configuration folders appear in the Submit Action properties window.
Select Submit Action as Submit to OneDrive.
Select the Storage Configuration, where you want to save your data.
Click Save to save the Submit settings.

When you submit the form, the data is saved in the specified Microsoft® OneDrive Storage.
Folder structure to save data is /folder_name/form_name/year/month/date/submission_id/data.

Submit to Azure Blob Storage

The Submit to Azure Blob Storage Submit Action connects an Adaptive Form with a Microsoft® Azure portal. You can submit the form data, file, attachments, or Document of Record to the connected Azure Storage containers. To use the Submit action for Azure Blob Storage:

Create an Azure Blob Storage Container: It connects AEM Forms to Azure Storage containers.
Use Azure Storage Configuration in an Adaptive Form: It connects your Adaptive Form to configured Azure Storage containers.

Create an Azure Blob Storage Container

To connect AEM Forms to your Azure Storage containers:

Go to your AEM Forms Author instance > Tools > Cloud Services > Azure Storage.
Once you select the Azure Storage, you are redirected to Azure Storage Browser.
Select a Configuration Container. The configuration is stored in the selected Configuration Container.
Click Create. The Create Azure Storage Configuration wizard appears.
Specify the Title, Azure Storage Account and Azure Access key.
- You can retrieve Azure Storage Account name and Azure Access key from the Storage Accounts in the Microsoft® Azure portal.
Click Save.

Now, you can use this Azure Storage container configuration for the submit action in an Adaptive Form.

Use Azure Storage Configuration in an Adaptive Form

You can use the created Azure Storage container configuration in an Adaptive Form, to save data or generated Document of Record in Azure Storage container. Perform the following steps to use Azure Storage container configuration in an Adaptive Form as:

Create an Adaptive Form.
NOTE
Select the same Configuration Container for an Adaptive Form, where you have created your OneDrive storage.

If no Configuration Container is selected, then the global Storage Configuration folders appear in the Submit Action properties window.
Select Submit Action as Submit to Azure Blob Storage.
Select the Storage Configuration, where you want to save your data.
Click Save to save the Submit settings.

When you submit the form, the data is saved in the specified Azure Storage container configuration.
Folder structure to save data is /configuration_container/form_name/year/month/date/submission_id/data.

To set values of a configuration, Generate OSGi Configurations using the AEM SDK, and deploy the configuration to your Cloud Service instance.

Submit to Power Automate

You can configure an Adaptive Form to run a Microsoft® Power Automate Cloud Flow on submission. The configured Adaptive Form sends captured data, attachments, and Document Of Record to Power Automate Cloud Flow for processing. It helps you build custom data capture experience while harnessing the power of Microsoft® Power Automate to build business logics around captured data and automate customer workflows. Here are a few examples of what you can do after integrating an Adaptive Form with Microsoft® Power Automate:

Use Adaptive Forms data in a Power Automate business processes
Use Power Automate to send captured data to more than 500 data sources or any publicly available API
Perform complex calculations on captured data
Save Adaptive Forms data to storage systems at a predefined schedule

Adaptive Forms editor provides the Invoke a Microsoft® Power Automate flow submit action to send adaptive forms data, attachments, and Document Of Record are sent to Power Automate Cloud Flow. To use the Submit action to send captured data to Microsoft® Power Automate, Connect your Forms as a Cloud Service instance with Microsoft® Power Automate

After a successful configuration, use the Invoke a Microsoft® Power Automate flow submit action to send data to a Power Automate Flow.

Submit to Workfront Fusion

You can configure an Adaptive Form to submit data to Workfront Fusion on submission. Workfront Fusion allows automation of processes so that user can concentrate on new tasks rather than repeating the same tasks again and again. It automates both simple and complex tasks, saving time and ensuring consistent process execution.

The Adaptive Forms editor provides the Invoke a WorkFront Fusion Scenario submit action to send Adaptive Forms data or attachments to a Workfront Fusion scenario. To use the submit action for sending captured data to a Workfront Fusion scenario, refer to Submit an Adaptive Form to Adobe Workfront Fusion.

Use synchronous or asynchronous submission

A Submit Action can use synchronous or asynchronous submission.

Synchronous submission: Traditionally, web forms are configured to submit synchronously. In a synchronous submission, when users submit a form, they are redirected to an acknowledgment page, a thank you page, or if there is submission failure, an error page. You can select the Use asynchronous submission option to redirect the users to a webpage or show a message on submission.

Configure Submit Action

Asynchronous submission: Modern web experiences like single page applications are gaining popularity where the web page remains static while client-server interaction happens in the background. You can now provide this experience with Adaptive Forms by configuring asynchronous submission.

Server-Side Revalidation in Adaptive Form

Typically, in any online data capture system, developers place someJavaScript validations on client side to enforce a few business rules. But in modern browsers, end users have way to bypass those validations and manually do submissions using various techniques, Such as Web Browser DevTools Console. Such techniques are also valid for Adaptive Forms. A forms developer can create various validation logics, but technically, end users can bypass those validation logics and submit invalid data to the server. Invalid data would break the business rules that a forms author has enforced.

The server-side revalidation feature provides the ability to also run the validations that an Adaptive Forms author has provided while designing an Adaptive Form on the server. It prevents any possible compromise of data submissions and business rules violations represented in terms of form validations.

What to validate on Server?

All out of the box (OOTB) field validations of an Adaptive Form that are rerun at the server are:

Required
Validation Picture Clause
Validation Expression

Enabling Server-side Validation

Use the Revalidate on server under Adaptive Form Container in the sidebar to enable or disable server-side validation for the current form.

Enabling Server-Side Validation

If end-user bypass those validations and submit the forms, the server again performs the validation. If the validation fails at server end, then the submit transaction is stopped. The user is presented with the original form again. The captured data and submitted data are presented to the user as an error.

NOTE

Server-side validation validates the form model. You are recommended to create a separate client library for validations and not mix it with other things like HTML styling and DOM manipulation in the same client library.

Supporting Custom functions in Validation Expressions

At times, if there are complex validation rules, the exact validation script reside in custom functions and author calls these custom functions from field validation expression. To make this custom function library known and available while performing server-side validations, the form author can configure the name of AEM client library under the Basic tab of Adaptive Form Container properties as shown below.

Supporting Custom functions in Validation Expressions

Author can configure customJavaScript library per Adaptive Form. In the library, only keep the reusable functions, which have dependency on jquery and underscore.js third-party libraries.

Error handling on Submit Action

As a part of AEM security and hardening guidelines, configure custom error pages such as 400.jsp, 404.jsp, and 500.jsp. These handlers are called, when on submitting a form 400, 404, or 500 errors appear. The handlers are also called when these error codes are triggered on the Publish node. You can also create JSP pages for other HTTP error codes.

When you prefill a form data model (FDM), or schema based Adaptive Form with XML or JSON data complaint to a schema that is data does not contain <afData>, <afBoundData>, and </afUnboundData> tags, then the data of unbounded fields of the Adaptive Form is lost. The schema can be an XML schema, JSON schema, or a Form Data Model (FDM). Unbounded fields are Adaptive Form fields without the bindref property.

recommendation-more-help