Akeneo Connector for Magento 2 overview

#Connector overview

Akeneo Connector for Magento 2 is a module for Magento 2. The connector is therefore installed on Magento 2 side and communicates with Akeneo PIM via its API.

The connector is an unidirectional system: it imports PIM data to Magento 2. No Magento data is sent back to the PIM.

Overview

The PIM is considered as the master tool for product data, it should not be handled in Magento 2.

#Process overview

Akeneo Connector for Magento 2 is composed by 7 main jobs (7 main processes):

  1. Category
  2. Family
  3. Attribute
  4. Option
  5. Product Model
  6. Family Variant
  7. Product

Each job can be triggered manually or automatically on its own.

Each job is responsible for importing PIM architecture and data into Magento 2. The jobs order above should be observed to build your catalog properly. You could skip steps, but please be careful if you do. For example, if you want to import attribute options and you have created new attributes in your PIM, you will first need to import attributes or it will result in an error. Please check your data before importing it!

Technical information: Akeneo Connector for Magento 2 inserts all PIM data into a temporary table. Then, data is manipulated (mapping,...) within this temporary table in SQL. Finally, the modified content is directly inserted into SQL in Magento 2 tables.

Even if raw SQL insertion is not the way you usually import data into a system, it is still faster than anything else, especially with the volume of data within a full Akeneo catalog. This results in a significant time saving for your imports.

As Akeneo Connector for Magento 2 is using SQL insertion, it will not trigger any of the events related to the entities imported. For example, plugins or observers located at product save will not be triggered during the import process.

You will find below the technical details for each process:

#Category import process

  1. Create a temporary table
  2. Insert data into the temporary table
  3. Match the PIM code with the entity
  4. Create a URL key
  5. Create a position
  6. Create some category entities
  7. Set a value for the attribute
  8. Count of child categories
  9. Update URL keys
  10. Drop the temporary table
  11. Clean the cache

#Family import process

  1. Create temporary table
  2. Insert data into the temporary table
  3. Match the PIM code with the entity
  4. Create some families
  5. Create family attribute relations
  6. Init default groups
  7. Drop the temporary table
  8. Clean the cache

#Attribute import process

  1. Create a temporary table
  2. Insert data into the temporary table
  3. Match the PIM code with the entity
  4. Match attribute types
  5. Match the family
  6. Add some attributes
  7. Drop the temporary table
  8. Clean the cache

#Option import process

  1. Create temporary table
  2. Insert data into the temporary table
  3. Match the PIM code with the entity
  4. Insert options
  5. Insert options label
  6. Drop the temporary table
  7. Clean the cache

#Product Model import process

  1. Create a temporary table
  2. Insert data into the temporary table
  3. Remove columns from product model table
  4. Add new columns to product model table
  5. Insert product models data into product model table

#Family Variant import process

  1. Create a temporary table
  2. Insert data into the temporary table
  3. Update axis column in the product model table
  4. Update product model data from variants data
  5. Clean the cache

#Product import process

  1. Create a temporary table
  2. Insert data into the temporary table
  3. Add product required data
  4. Create configurable products
  5. Match the PIM code with the entity
  6. Update the family
  7. Update column values for options
  8. Create product entities
  9. Set values to attributes
  10. Update configurable products relation
  11. Set products to websites
  12. Set products to categories
  13. Init stock
  14. Update related, up-sell and cross-sell products
  15. Set a URL rewrite
  16. Import media files
  17. Import asset files
  18. Drop the temporary table
  19. Clean the media folder
  20. Clean the cache