tab 1 - configuration

Configuration

The configuration tab contains settings for mapping product values, images, associations and attributes.

Attribute mappings

A → B mapping.
Here you can remap product values ​​from attribute a to attribute b. Before you can start exporting, a number of ‘mappings’ are necessary. Mapping for the fields ‘sku, name, akeneo_status, visibility, weight & tax_class_id’ are hereby required (these are not removable). If no mapping is provided for these field. The connector will use standards. Other reserved attribute codes are: quantity_and_stock_status,category_ids,tier_price,price_view,gift_message_available,type_id. These cannot be mapped.

Special A → B mappings

Different values for configurable and simple products:

The mapping configuration allows you to map two different Akeneo attributes to one Magento attribute. This way it is possibly to provide a different Magento value for configurable and simple products. You do this by adding a pipeline between the Akeneo attributes. Once a pipeline was added, the first attribute will be used for configurable products and the second one for the simples.

Magento attribute Akeneo attribute
visibility visibility_model|visibility_simple

Range attributes: Induxx has provided a new attribute type ‘range’. On this attribute three values will be stored. Min, max and increment. For this attribute it is possible to link these 3 values from one Akeneo attribute to three different Magento attributes. You do this by using a slash (\).

Magento attribute Akeneo attribute
max_sale_qty sales_range/max
min_sale_qty sales_range/min
qty_increments sales_range/increment
Reserved A → B mapping attributes

A few attribute codes are reserved for the connector. Because of this you cannot add these manually. Attribute(s) that are reserved:

  • sku
  • name
  • weight
  • visibility
  • tax_class_id
  • quantity_and_stock_status
  • category_ids
  • tier_price
  • price_view
  • gift_message_available
  • akeneo_status
A → B mapping stock item attributes

It is also possible to add mapping on the product stock item attributes. A list of these attributes can be found here:

  • qty
  • is_in_stock
  • is_qty_decimal
  • use_config_min_qty
  • min_qty
  • use_config_min_sale_qty
  • min_sale_qty
  • use_config_max_sale_qty
  • max_sale_qty
  • use_config_backorders
  • backorders
  • use_config_notify_stock_qty
  • notify_stock_qty
  • use_config_qty_increments
  • qty_increments
  • use_config_enable_qty_inc
  • enable_qty_increments
  • use_config_manage_stock
  • manage_stock
  • low_stock_date
  • is_decimal_divided
  • stock_status_changed_auto
Association mapping

Here you can map Akeneo association codes on the existing Magento association types. You can choose which associations to use for cross-sell, upsell and related products.

Other settings

Except these mappings, a few other important settings are required. These are:

  • A comma separated list of attribute codes you want to export to Magento. This list will be used for attribute and product value exporting. Don’t forget to add at least all the variant axe attributes here.
  • A comma separated list of image attribute codes. This list will be used to export images to the image gallery. You can decide on each family which image you want to use as the main image in Magento -> ‘family attribute used as image’.
Save configuration

Since the grid quick export jobs are not configurable through the Akeneo’s export user interface, the existence of these jobs will be checked when saving this configuration. If the quick export job magento_api_quick_product_export does not exist, it will be created. The same logic will be applied for the magento_api_quick_export and magento_csv_open_queue jobs.

Oro config which is currently not available in the UI
Section Name Description
magento_configuration asset_attribute Optional. An asset can contain several variant attributes. By setting up this config value, the connector knows which image variant must be exported.
magento_configuration asset_attributes Optional. An asset can have several attributes. By setting up this config value, the connector knows which attributes must be exported.
magento_configuration completeness_filter_active Default true. Only export products which are complete.
magento_configuration configurable_base_image_attribute Optional. Image attribute used as main image for configurable products.
magento_configuration convert_all_axe_attributes Optional. Create new Magento simple select “_axis” attribute for each Akeneo variant axe attribute. Even if these attributes are already select attributes.
magento_configuration curl_timout_seconds Optional. Set timout setting on your curls requests.
magento_configuration default_locale This value is used as the last fallback layer if no locale would be set on the ‘all’ storeview. This locale will be used as the Magento default locale and must be the same as the locale which is configured on the default storeview.
magento_configuration default_product_visibility Optional. Default product visibility.
magento_configuration disable_images Optional. Comma separated list of attribute codes. For these image attribute codes the image will be disabled in the gallery.
magento_configuration export_configurable_products Optional. If activated, no configurable products will get exported. Variant products will be simples
magento_configuration export_reference_image_paths Optional. Defalse false. If activated, we send the image paths instead of the file content for reference entity/data exports.
magento_configuration flip_options_for_attribute_codes Optional. Comma separated list of attribute codes. For these attribute codes the option code and labels will be switched.
magento_configuration image_resize This value is used in combination with Lamda and is the resolution to which you want to rescale (if you use this Lambda service).
magento_configuration inherit_image_positions Default false. When active the Magento image positions for existing images will be used. When false, Akeneo is leading.
magento_configuration inherit_model_images Default false. When active the product model images will be pushed on variant level as well. This can have a huge impact on performance. Each image will be duplicated per variant and has an own filename (default Magento behaviour). For example: 1 model with 5 images and 10 variants, will result in 55 images.
magento_configuration logging_enabled Default false. Enable if you want to activate export logging.
magento_configuration memory_limit Optional. In MB. For example: 2048 - increase the memory limit while processing image data.
magento_configuration meta_attributes Optional. Comma separated list of attribute codes. The product values of these attributes will be send in one meta attribute. If you want to add association data you need to add the association prefix. An example: association::SUBSTITUTION
magento_configuration meta_categories Optional. Comma separated list of root category codes. Only linked categories that are in the configured root categories will be exported in the meta attribute.
magento_configuration meta_updated Optional. When this value is true, akeneo_exported will be added in the meta attribute with a timestamp of when the product is send to Magento.
magento_configuration product_request_interval Optional. Can be used to set a delay on product export requests. Magento can have problems if you send too many requests in a short period of time.
magento_configuration reformat_image_name Default false. Will reformat the image name the same way as the old Pimgento does - {SKU}-{SKU}-{ATTRCODE}-{IMAGENAME}. If false, the new naming convention is used. This is the original image name extended with the first 4 characters of the hash.
magento_configuration root_category Magento’s root category id. Default 2. Use this database configuration setting if you want to use another Magento category as root startpoint.
magento_configuration separate_configurables_for_family_codes Optional. Comma separated list of family codes. For each family code in this list, configurable products are created from the sub models. Not the root models.
magento_configuration use_pimgento_family_mapping_fallback Default true.
magento_configuration update_image_mapping Default false. If activated, existing image mappings with no hash will get updated with a hash. For these mappings the images will not get exported again.
magento_configuration video_asset_attribute Optional. The asset attribute you want to use for linking videos.
magento_configuration default_category_by_channel_code Optional. Can be used to define the default category for a channel.
magento_configuration enable_default_product_visibility_for_all_storeviews Optional. This enables the default visibility for all storeview. Default set to true.