“Attribute mapping” tab

In the second step, the attribute mapping is set up. Here you specify which attributes respectively which attribute values are exported.

2. For example, in order to select the mapping type “Attribute” from the menu in the “Mapping” card.
3. Click on the button. Following appears a new entry in the table of the “Mapping” card. Furthermore, the appropriate input fields and drop-down menus appear in the “Mapping configuration” card.

4. From the “iPIM value” menu, select the attribute.
5. Via the “1st Target column configuration” menu, specify how the first column header of the export file is set up:
   • Constant: When selecting this setting, you can enter a column header of your choice in the input field “1st Target column”.
   • Attribute ID: The ID of the selected attribute is used as the column header.
   • Description: The name of the selected attribute is used as the column header.
6. Optional: Via the “2nd Target column configuration” menu, specify how the second column header of the export file is set up as described above.
   
   

   For the 'iPIM-XML' export format, a 2nd target column must not be defined.
   
   
   

7. Optional: Enter multilingual short descriptions to describe the attribute mapping in short terms:
   1. Click on the button in the “Description” field to call up the corresponding dialog box.
   2. Enter the short descriptions for the individual languages in the respective input fields.
   3. Click on the ACCEPT button to accept your your input. Following this, the dialog box closes and the short description for the currently selected UI language is shown in the “Description” field.
8. Optional: Enter a template key in the corresponding input field. Click here for further information about templates.
9. Optional: Select the desired option from the “Total” menu, whereas this setting is only relevant for number type attributes on the item level:
   • YES: Number attribute values on the item level are added up. In the export file, the total is shown on the product level.
   • NO: Number attribute values on the item level aren’t included in the export file.
10. Add further mapping entries as described above.

• In order to save your attribute mapping, click on the SAVE button. If the process was successful, a corresponding message will appear. The attribute mapping is now set up.
• In order to cancel the process, click on the RESET button.

The possible respectively required mapping parameters depend on the selected mapping type.

• In order to export digital assets, add of mapping of the type “digial asset”.
• First introduced in version 5.5.3: If an existing mapping is selected, the new mapping is added below the selected mapping. Otherwise, the new mapping is added at the bottom of the list.

• Using the property ipim.core.datafeed.export.separator.multiplevalue you can specify which delimiter separates the individual values of a list of values.
• First introduced in version 5.6.4: Using the property datafeed.export.delimiter.multiplevalue you can specify how many values of a list of multiple values attribute a included in a datafeed export at max.

Modify the configuration of mappings

In order to modify the configuration of a particular mapping, proceed as follows:

1. In the table of the “Mapping” card, click on the respective mapping entry to select it. Then the current settings of the mapping are loaded into the input fields and menus of the “Mapping configuration” card.
2. Make the desired changes to the settings of the mapping entry.

• In order to save your changes, click on the SAVE button.
  A success message is shown.
• In order to dismiss your changes, click on the RESET button.

Move mappings

Move mappings via drag and drop

You can move a mapping entry within the sequence of mapping entries via drag & drop. To do so, proceed as follows:

1. In the table row of the respective mapping entry, click on the button and hold the mouse button down.
2. Drag the mapping entry to the desired position and release the mouse button.

• In order to save your changes, click on the SAVE button.
  A success message is shown.
• In order to dismiss your changes, click on the RESET button.

Move mappings using the mouseover buttons

You can move a mapping entry within the sequence of mapping entries using different mouseover buttons. To do so, proceed as follows:

1. Move the mouse cursor over the mapping you want to remove. Then appears a bar containing several buttons.
2. Click on the appropriate button:
   • In order to move the mapping upwards by one step, click on the button.
   • In order to move the mapping downwards by one step, click on the button.
   • In order to move the mapping to the top, click on the button.
   • In order to move the mapping to the bottom, click on the button.

• In order to save your changes, click on the SAVE button.
  A success message is shown.
• In order to dismiss your changes, click on the RESET button.

Remove mappings

In order to remove a mapping, proceed as follows:

1. Move the mouse cursor over the mapping you want to remove. Then appears a bar containing several buttons.
2. Click on the button. Then appears the button.
3. Click on the button to confirm the removal of the mapping.

FAQ

What is the purpose of the “Attribute mapping” tab?

In this tab, users can set up the attribute mappings. Here you specify which attributes respectively which attribute values are exported.

What do the possible respectively required mapping parameters depend on?

The possible respectively required mapping parameters depend on the selected mapping type.

What do I need to do in order to export digital assets?

In order to export digital assets, you need to add a mapping of the type “digital asset”.

Where is a newly added mapping placed in the list?

First introduced in version 5.5.3, if an existing mapping is selected, a newly added mapping is added below the selected mapping. If no mapping is selected, the new mapping is added at the bottom of the list.

What is the purpose of the “Total” option and when is it relevant?

The “Total” menu is used to specify whether number attribute values on the item level are added up during the export. This setting is only relevant for number type attributes on the item level.

How can I specify which delimiter separates the individual values of a list of values during the export?

Using the property ipim.core.datafeed.export.separator.multiplevalue you can specify which delimiter separates the individual values of a list of values.

Can I limit how many values of a list of multiple values are output at most?

Yes, first introduced in version 5.6.4, using the property datafeed.export.delimiter.multiplevalue you can specify how many values of a list of multiple values attribute are included in a datafeed export at max.

Are changes to the order of mappings applied automatically?

No, whether you move a mapping via drag and drop or using the mouseover buttons, you additionally need to click on the SAVE button in order to save your changes.

Do I additionally need to save the removal of a mapping?

Yes, in order to save your changes, you additionally need to click on the SAVE button.