Commerce Akeneo

Akeneo is a Product Information Management application designed to simplify your product management processes.
The main purpose of a PIM is to be a central repository of all product data of a company.

Commerce Akeneo performs a one-way sync through the "Services" module allowing you to automatically create/update both productss ref and products display (if needed) into Drupal Commerce, from previously created products in Akeneo PIM.

To achieve a such operation, the Drupal Connector for Akeneo must be setup on Akeneo side to push products directly to Services. Linked together, connectors will do the job.

See below the howto procedure.

Requirements

Major modules required follows:

• Commerce
• Services
• Taxonomy Machine Name
• Units Akeneo
• Drupal Connector for Akeneo (under hard development)

Howto

Install

• Enable all Commerce Akeneo modules,
• Copy or enable exposed service named "Akeneo" (/admin/structure/services),
• Create a content-type (node) with a "commerce_product_reference" field,
• Go to admin setting page (/admin/config/services/akeneo) to set all prefix, akeneo settings and all product field elements.

Warning

Running the "drush akeneo-family" command or running the corresponding batch via "Queue UI" will create/update product type fields.

It is adviced to run this command in staging environment and migrate updates thanks to features.

Use

The first step is to run all export job from Akeneo.
Once done, all data are pushed to Drupal and stored in Drupal queues.

Import product repository

# Import taxonomy terms
drush mi --group=commerce_akeneo_option
# Import catalog categories
drush mi --group=commerce_akeneo_category

Those commands will create destination vocabularies and fill them with their terms.

Create product types

# Create or Update product types / fields
drush akeneo-family --remove-leases
drush akeneo-family

Akeneo families corresponds to Commerce Product Types. This command will create destination commerce product types, add both fields and field groups.
Once created, field instances are no more modified which let you the possibility to customize it as you wish.

Import products

# Import product references (not display)
drush mi --group=commerce_akeneo_product

The product scripts will import all product references and feed queues with all data to allow you to create product displays according to your internal needs.

Import products display

# Import product display
drush mi --group=commerce_akeneo_product_display

Hooks are available to alter migrate mecanism. Feel free to use them.

Development Roadmap

Done

• service exposed to import families
• service exposed to import attribute options (taxonomy) into queues
• service exposed to import catalog categories (taxonomy) into queues
• service exposed to import products into queues
• migrate script to import attribute options (include translation support)
• migrate script to import catalog categories (include translation support / parents)
• migrate script to import products - need tests on translations
• download media file during product migration script
• import families into queue instead of handling it directly
• create fields to store categories and product associations
• create batch to sync families
• create drush command to import family queues
• import product associations into queues
• create migrate script to import product associations - work in progress
• update migrate script for products to store catalog categories
• import product display (products but not groups)

Scheduled

• expose table settings to "features" module
• create drush command to clear queues