Creating Custom Form Mappings

Last update: April 17, 2024

CREATED FOR:

  • Developer

When you create a custom table in Adobe Campaign, you may want to build a form in AEM that maps to that custom table.

This document describes how to create custom form mappings. When you complete the steps in this document, you will be providing your users with an event page where they can sign up for an upcoming event. You then follow up with these users via Adobe Campaign.

Prerequisites

You need to have the following installed:

  • Adobe Experience Manager
  • Adobe Campaign Classic

See Integrating AEM with Adobe Campaign Classic for more information.

Creating Custom Form Mappings

To create custom form mappings, you need to follow these high-level steps, which are described in detail in the following sections:

  1. Create a custom table.
  2. Extend the seed table.
  3. Create a custom mapping.
  4. Create a delivery based on the custom mapping.
  5. Build the form in AEM, which will use the created delivery.
  6. Submit the form to test it.

Creating the Custom Table in Adobe Campaign

Start by creating a custom table in Adobe Campaign. In this example, we are using the following definition to create an event table:

<element autopk="true" label="Event" labelSingular="Event" name="event">
 <attribute label="Event Date" name="eventdate" type="date"/>
 <attribute label="Event Name" name="eventname" type="string"/>
 <attribute label="Email" name="email" type="string"/>
 <attribute label="Number of Seats" name="seats" type="long"/>
</element>

After you create the event table, run the Update database structure wizard to create the table.

Extending the Seed Table

In Adobe Campaign, select Add to create an extension of the Seed addresses (nms) table.

chlimage_1-194

Now, use the fields from the event table to extend the seed table:

<element label="Event" name="custom_cus_event">
 <attribute name="eventname" template="cus:event:event/@eventname"/>
 <attribute name="eventdate" template="cus:event:event/@eventdate"/>
 <attribute name="email" template="cus:event:event/@email"/>
 <attribute name="seats" template="cus:event:event/@seats"/>
 </element>

After this, run Update database wizard to apply the changes.

Creating Custom Target Mapping

In Administration/Campaign Managemen t, go to Target Mappings and add a new T arget Mapping.

NOTE
Make sure you use a meaningful name for Internal name.

chlimage_1-195

Creating a Custom Delivery Template

In this step, you are adding a delivery template that uses the created Target mapping.

In Resources/Templates, navigate to the Delivery Template and duplicate the existing AEM delivery. When you click To, select the create event Target mapping.

chlimage_1-196

Building the Form in AEM

In AEM, make sure you have configured a Cloud Service in Page Properties.

Then, in the Adobe Campaign tab, select the delivery that was created in Creating a Custom Delivery Template.

chlimage_1-197

When configuring the fields, make sure you specify unique element-names for the form-fields.

After the fields are configured, you need to manually change the mapping.

In CRXDE-lite, go the jcr:content (of the page) node and change the acMapping value to the internal name of the Target mapping.

chlimage_1-198

In the configuration of the form, make sure you check the checkbox to create if non existing

chlimage_1-199

Submitting the Form

You can now submit the form and validate on the Adobe Campaign side whether the values are saved.

chlimage_1-200

Troubleshooting

“Invalid type for value ‘02/02/2015’ from element ‘@eventdate’ (document of type ‘Event ([adb:event])’)”

When submitting the form, this error is logged in the error.log in AEM.

This is due to an invalid format for the date field. The workaround is to supply yyyy-mm-dd as the value.

Experience Manager


Elevate and Empower Teams with Agentic AI for Exceptional Experiences

Online | Strategy Keynote | General Audience

Elevate and empower your CX teams with AI that transforms creativity, personalization, and productivity. Discover how Adobe is...

Tue, Mar 18, 1:00 PM PDT (8:00 PM UTC)

Register

Rapid Feature Releases with AEM Cloud: Telegraph Media Group’s RDE Strategy

Online | Session | Intermediate

Hear how Telegraph Media Group, the award-winning publisher of The Daily Telegraph, The Sunday Telegraph, The Telegraph Magazine,...

Wed, Mar 19, 3:30 PM PDT (10:30 PM UTC)

Register

Connect with Experience League at Summit!

Get front-row access to top sessions, hands-on activities, and networking—wherever you are!

Learn more

Register now