AEM Integration: Export Mapping Setup

Map your content from AEM to Content Workflow

Bruno Wilson avatar
Written by Bruno Wilson
Updated over a week ago

To export content from AEM to Content Workflow, the content editor needs to set up export mappings between Pages in AEM and Templates in Content Workflow and their corresponding fields. You will use your pages in AEM as templates for export mapping. Please make sure that the page component properties are initialised with any values to be available for mapping. Follow these steps to map your templates.

The Manage Export-Import Mappings screen will appear.

Click the "Add New Mapping" button

Clicking on the "Add new mapping" button will open the mapping form. The mapping form allows the user to specify which templates and fields should be mapped.

Specify Mapping Name

First, users should specify a name for the export mapping. The mapping name will be used to distinguish mappings on export dialogs.

Set AEM Template Page path

Next, the AEM template path should be defined. It will be used as a base model for field mappings. This will determine what AEM Page component properties will be used for mapping.

Next, the “Starting point for templates search” field can be set (optional). The selected content path will be the starting point for the template page search. The system will look up all pages under this path, which have the same AEM template as a page selected in the “AEM Template Page (*)” field for component properties matching. This can be used if you have an AEM field with slightly different property names on different pages you can map all those properties to one Content Workflow field and during export value from the first matched property will be used. In case a property with the same name will be found on different pages, the value of the property will be shown from the first page found.

Default path /content will be used if empty.

NOTE: In most cases, you can select one template page in both fields: “AEM Template Page (*) and “Starting point for templates search”.

Specify Content Workflow Project and Mapping Type

Next, the Content Workflow Project and Mapping Type needs to be specified to enable source item mapping type Template or Custom Structure. AEM integration Export functionality doesn’t support mapping to Entries Parent due to Content Workflow API restrictions.

Set Source Type Item

After Mapping Type is specified then the associated with this type Item can be selected to start mapping your field. For example, if you selected Template Mapping type then only Templates will be shown in this dropdown. Custom Structure and Entries Parent items will be hidden.

Start mapping your fields

Once you have completed the previous steps, all tabs and fields will be dynamically populated. The user can now map Content Workflow fields to AEM properties. The Content editor can map the required fields by selecting an AEM property in the corresponding dropdown. Only properties that are possible to map are displayed in the dropdowns. For example, it is not possible to map a Multiple-choice or Checkboxes field from Content Workflow to a text property in AEM. The item name can be mapped to any string property. Content Workflow page name is defaulted to the AEM page title and cannot be remapped due to Content Workflow API restrictions. 

In case a property with the same name is found on different pages, the value of the property will be shown from the first page found.

Please check the mappings table that shows all the supported by field mappings for Export functionality:

Content Workflow field type
Text
AEM property type
String property
Comment
Field content will be copied as it is

Content Workflow field type
Guidelines
AEM property type
String property
Comment
Field content will be copied as it is

Content Workflow field type
Checkboxes
AEM property type
"Radio Group" or "Checkbox Group" components from "Form" component group out of the box

Content Workflow field type
Radio Buttons
AEM property type
"Radio Group" or "Checkbox Group" components from "Form" component group out of the box

Save Mappings Configuration

After all mapping criteria are set, click the "Save mapping" button. The saved mappings can be edited, copied or deleted at any point.

Edit Mappings - 'Move to'

The 'Move to' option appears on each tab of mapping configuration and allows moving the field mappings between tabs. This is very useful if you would like to create a new mapping by copying it. Further editing of copied mapping will allow moving the mapping between the tabs so the mapping will be copied to another tab if the properties are identical.

Now that you've completed your mappings, you can now export content from AEM to Content Workflow.

Did this answer your question?