Umbraco Integration: Mapping Setup

You'll need to set up mappings between your structure in Content Workflow and templates in Umbraco before you can import content.

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

To import content from Content Workflow, you'll need to set up mappings between Templates in Content Workflow and templates in Umbraco and their corresponding fields. Follow these steps to map your templates:

Click the Mappings button on the Content Workflow menu

The manage template mappings screen will appear.

Click Add Mappings button

Clicking on the "Add Mappings" button will bring up the Field Mappings dialog. The Field Mappings dialog lets the user specify which templates and fields should be mapped.

Specify mapping name

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

Set default location

Next, the default location field can be set (optional). This helps specify the default location (node) in Umbraco where imported Items will be stored. The field is also used on the multilocation import dialog to pre-fill the location pickers.

Select the Content Workflow project and template and the corresponding Umbraco template

Specify the Content Workflow project and Template you want to map and choose the corresponding Umbraco template.

Map Content Workflowt fields to Umbraco fields

Please note: The connector doesn't support the Umbraco Grid Editor.

Once you’ve completed the previous steps, all tabs and fields will be dynamically populated. The user can now map Content Workflow fields to Umbraco fields. The Content Editor can map the required fields by selecting an Umbraco field in the corresponding dropdown on the right-hand side of the screen.

Only fields that are possible to map are displayed in the dropdowns. For example, it is not possible to map a text field from Content Workflow to an image field in Umbraco.

Please note that the right-side dropdown displays all fields from the selected Umbraco template, along with fields from all base templates, which the current template inherits.

The plug-in supports many-to-one field mappings for text and guidelines field types. This means, that it is possible to map, for example, two Content Workflow fields into one Umbraco field. The content of such fields will be concatenated and placed in the Umbraco field.

Please check the mappings table that shows all the supported field mappings:

Content Workflow field type
Text
Umbraco field type
Textbox, Text Area, Rich text editor, Date Picker
Comment
Field content will be copied as it isis. Import Date format will be used to convert dates form text to date.

Content Workflow field type
Guidelines
Umbraco field type
Textbox, Text Area, Rich text editoreditor, Date Picker
Comment
Field content will be copied as it isis. Import Date format will be used to convert dates form text to date.

Content Workflow field type
Checkboxes
Umbraco field type
DropDown
Comment
Multiple List System will map selected items in the Content Workflow field to items specified in Umbraco field DataSource.

Content Workflow field type
Radio Buttons
Umbraco field type
Drop Down, Check Box List, Radio Button List, Dropdown list
Comment
Publishing Keys System will map selected items in the Content Workflow field to items specified in Umbraco field DataSource.

Content Workflow field type
Attachment
Umbraco field type
Legacy MediaPicker, MediaPicker
Comment
All attachments will be placed Media Library in the following node structure in Umbraco/GatherContent///IfUmbraco/GatherContent/If a field has a datasource set, all importing files will be uploaded to the location specified in datasource.If Attachment field is mapped to Umbraco Legacy MediaPicker field, only first image/file will be downloaded from Content Workflow and will be selected in Umbraco.In case of mapping Attachment field to Umbraco fields allowing multiple selection (MediaPicker), all attachments/files will be downloaded and will be selected in the corresponding field

Save Mappings Configuration

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

Did this answer your question?