Content Mapper

What is Content Mapper?

Motation is the content form that exists between connectors. A source connector will transform repository content -> Motation. While a destination connector will transform Motation -> repository content.

Motation is an extension of JSON (JavaScript Object Notation). Motation builds upon the idea of structuring complex data.

Content mapper page is to manage all the content motation. Access to Content Mapper page by clicking on the edit button located in the Jobs page under Mapper

List of existing mappings

You can see the Current mappings with each endpoint after clicking the edit and selecting the endpoint with the mapping set, as shown in the picture above.

Adding mapping

Clicking on the Edit button on the main page will bring you to the motation form the create new motation.

First, you need to click on the Endpoint dropdown to select the associated endpoint of this motation.

Then you must fill all the origin and mapping detail so the motation can know which field they will do the mapping. Destination Content Type Destination Content Type is what we fill out with where the content is going so if the content type your syncing to in the destination has an ID of second-restaurant it would be filled with second-restaurant \

If the connector for the endpoint supports listing content types, a dropdown will open with a list of content types to choose from.

Then you can choose any dependencies by the optional fields section below (optional)

Then the dialog to add new optional field will be opened. Here you can add source unique Id and destination unique Id of the field you'd like to map over.

If the connector for the endpoints supports listing fields, the source and destination fields will be listed allowing you to quickly add the appropriate fields.

Then you can add optional properties to this by clicking the text box and writing some additional properties

The "Add Field" button will add a new field to the mapping and reset modal for to add a new field mapping.

The "Save Changes" button will add a new field to the mapping and close the modal window.

You can add multiple fields in a motation, they will be shown in a table.

NOTES:

  • Important: Be aware that mapping a field-id to an already existing field-id will not replace the field. You will end with duplicated field ids.

  • It is recommended to always add the Field Type property and set it to the expected Motation Field Type. Otherwise, the Field Type property will default to "String". Motation Field types can be found in the [https://motivlabs.gitbook.io/impulse-dev-manual/motation/content-motation#motation-fields](Dev Manual). The [https://labs.motivops.io/](connector matrix) can be used to find the appropriate Motation Field type between endpoints.

Here when you click on the delete mapping button after selecting the endpoint the mapper is saved to.

After finished all the configuration, please click on the Save Mapper button to save the motation.

Last updated