Skip to main content

Properties: Selection values

Do you have properties of the type Selection or Multi-selection? The unique thing about these two property types is that they have individual values that are available for selection. Such selection values can be created manually or they can be imported.

This page explains the matching and mapping fields that you can use while importing selection values. This page serves purely as a reference and it assumes that you already have a basic understanding of the import tool.

Requirements

Make sure you’ve already created properties of the type Selection or Multi-selection. This can either be done manually or via import. Afterwards, you can import the selection values as described on this page.

In other words, it’s not possible to create the properties and their selection values together in one import. This needs to be done in two separate imports.

1. Matching fields

Table 1 explains the fields that are available for matching selection values. During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 1. Matching fields for selection values
Matching field Explanation

Selection ID

Which column of your CSV file lists the selection value IDs? Choose this column here. This option is useful if you want to update existing selection values.

Background info: Every new selection value automatically receives an ID, which can not be changed. The ID is used to uniquely identify the selection value. Because the ID is unique, it’s a good way to check whether the imported data record already exists in plentymarkets.

Selection name

Which column of your CSV file contains the selection value’s name? Choose this column here. Then select the name’s language from the second drop-down list. This option is useful if you want to create new selection values.

Additional settings: This option can only be used together with the matching field Property ID or Property name.
Why? It’s possible to save the same selection name for multiple properties. The selection name alone isn’t a unique identifier. Therefore, use the selection name together with the property ID or the property name.

Property ID

Did you choose Selection name as the matching field? If so, then you’ll also need to use Property ID or Property name.

Background info: It’s possible to save the same selection name for multiple properties. The selection name alone isn’t a unique identifier. Therefore, use the selection name together with the property ID or the property name.

Which column of your CSV file lists the property IDs? Choose this column here.

Property name

Did you choose Selection name as the matching field? If so, then you’ll also need to use Property ID or Property name.

Background info: It’s possible to save the same selection name for multiple properties. The selection name alone isn’t a unique identifier. Therefore, use the selection name together with the property ID or the property name.

Which column of your CSV file contains the property name? Choose this column here. Then select the property name’s language from the second drop-down list.

2. Mapping fields

This chapter explains the fields that are available for mapping selection values. Use these fields to specify which column of your file corresponds to which data field in your system.

Basic procedure:

  1. In your CSV file: Enter a valid import value into a column.

  2. In plentymarkets: Assign this column to the appropriate mapping field.

  3. After the import: Check the result in the back end.

No mapping field? Default value applies!

If you don’t include a certain piece of information in your CSV file, i.e. if you don’t use a certain mapping field, then your selection value will be given the default value.

2.1. Selection values

2.1.1. Property ID

This field is relevant if you want to create new selection values and you did not already select the property ID as the matching field. This field tells plentymarkets which property the values are being created for.

Enter the property ID into the CSV file. You can find the property IDs in the menu Setup » Settings » Properties » Configuration.

Default value: No default value

Permitted import values: Numeric (internal ID)


2.1.2. Position

Which selection value should be displayed first, second, third, etc? Enter a position number in the CSV file.

Default value: No default value

Permitted import values: Numeric

You can find the result of the import in the back end menu: Setup » Settings » Properties » Configuration » [Open property] » Values


2.1.3. Name

Required field for creating new selection values

Enter the name of the selection value into the CSV file. Write the text in your plentymarkets system’s default language. Additionally, use the field Name of selection values / Name if you want to save the name in other languages too.

Default value: No default value

Permitted import values: Alpha-numeric

You can find the result of the import in the back end menu: Setup » Settings » Properties » Configuration » [Open property] » Values


2.1.4. Delete value

Do you want to delete the selection value?

Default value: 0

Permitted import values in CSV file Result in the back end

0

Selection value will not be deleted.

1

Selection value will be deleted.

You can find the result of the import in the back end menu: Setup » Settings » Properties » Configuration » [Open property] » Values


2.2. Name of selection values

2.2.1. ID

This field is relevant if you want to delete the name of a selection value. This field tells plentymarkets which selection value the names are being deleted for.

Enter the selection value ID into the CSV file. You can find the selection value IDs in the menu Setup » Settings » Properties » Configuration » [Open property] » Values.

Default value: No default value

Permitted import values: Numeric (internal ID)

Additional settings: Use this field together with the field Name of selection values / Delete name.


2.2.2. Name

Enter the name of the selection value into the CSV file.

In contrast to the field Selection values / Name, you can use this field to save the names in multiple languages. Add the field once per language.

Default value: No default value

Permitted import values: Alpha-numeric

Also use the drop-down list to select the language.

You can find the result of the import in the back end menu: Setup » Settings » Properties » Configuration » [Open property] » Values


2.2.3. Description

Enter a description of the selection value into the CSV file. If you want to save the description in multiple languages, then add the field once per language.

Default value: No default value

Permitted import values: Alpha-numeric

Also use the drop-down list to select the language.

You can find the result of the import in the back end menu: Setup » Settings » Properties » Configuration » [Open property] » Values


2.2.4. Delete name

Do you want to delete the name of a selection value? Enter your answer into the CSV file.

Default value: 0

Permitted import values in CSV file Result in the back end

0

Selection value will not be deleted.

1

Selection value will be deleted.

Also use the drop-down list to select the language.

Additional settings: Use this field together with the field Name of selection values / ID.

To top