To export content from AEM to GatherContent, the content editor needs to setup export mappings between Pages in AEM and Templates in GatherContent 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.

Navigate to Export Mappings section

The Manage Export Import Mappings screen will appear.

Click "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.

Set Starting Point for Templates Search

Next, the “Starting point for templates search” field can be set (optional). Select content path which will be the starting point for the template pages search. System will lookup all pages under this path, which have same AEM template as a page selected in “AEM Template Page (*)” field for component properties matching. This can be used if you have AEM field with slightly different property names on different pages you can map all those properties to one GatherContent 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, 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 GatherContent Project and Mapping Type

Next, the GatherContent 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 GatherContent 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 GatherContent 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 GatherContent to a text property in AEM. The item name can be mapped to any string property. GatherContent page name is default to AEM page title and cannot be remapped due to GatherContent API restrictions. 

In case a property with the same name will be found on different pages, 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:

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

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

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

GatherContent 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'

'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 to move 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 GatherContent.

Did this answer your question?