Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alumio.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Fetching Categories from Akeneo

  • In Alumio, go to “Integrations → Incoming → Akeneo - Fetch - Categories”.
  • To get all categories from the Akeneo system, use an Incoming “Akeneo - Fetch - Categories”.
Image
This incoming creates a task inside Alumio with data structured as Alumio base categories. There are some transformers inside this Incoming before processing the category.
  1. Akeneo - Prepare convert category - Labels - To localizations.
  2. Akeneo - Convert - Category - To Alumio Base.
  3. Akeneo - Filter - Category.
Akeneo - Prepare convert category - Labels - To localizations This transformer converts label data from Akeneo. 
{
  "labels": {
    "de_DE": "E-commerce",
    "en_GB": "E-commerce",
    "en_US": "E-commerce",
    "es_ES": "E-commerce",
    "fr_FR": "E-commerce",
    "it_IT": "E-commerce",
    "nl_NL": "E-commerce",
    "pt_PT": "E-commerce"
  }
}
Since the current data structure is incompatible with Magento 2, the transformer “Akeneo - Convert - Category - To Alumio Base” is used to convert it into a compatible format. 
{
  "localizations": [
    {
      "localeCode": "de_DE",
      "translation": "E-commerce"
    },
    {
      "localeCode": "en_GB",
      "translation": "E-commerce"
    },
    {
      "localeCode": "en_US",
      "translation": "E-commerce"
    },
    ....
  ]
}
Akeneo - Convert - Category - To Alumio Base. This transformer converts the entire category data into Alumio Base data. 
{
  "code": "master",
  "parent": null,
  "localizations": [
    {
      "localeCode": "de_DE",
      "translation": "E-commerce"
    },
    {
      "localeCode": "en_GB",
      "translation": "E-commerce"
    },
    {
      "localeCode": "en_US",
      "translation": "E-commerce"
    },
    {
      "localeCode": "es_ES",
      "translation": "E-commerce"
    },
    ...
  ]
}
Akeneo - Filter - Category
  • Use this transformer to filter previously created tasks into task categories to avoid duplication.
Image
  • To recreate a task, you should remove the entity from the storage “Akeneo - Filter - Categories”.

​
Sending Categories to Magento 2

The task that is created through Incoming “Akeneo - Fetch - Categories” should be processed further by the Route “Synchronize Categories - From Akeneo into Magento 2” and will be sent using this Outgoing. This Outgoing transforms Alumio Base Categories into Magento 2 categories and checks whether to create or update each category using data from the previous iteration of this Outgoing. Sending the Outgoing will be processed by the transformer:
  1. Magento 2 - Prepare convert - Category - Parent from Alumio Base Category.
  2. Magento 2 - Convert - Category - from Alumio Base Category.
  3. Magento 2 - Check and send - Category.
Magento 2 - Prepare convert - Category - Parent id from Alumio Base Category. This transformer checks the parent and maps it into the Magento 2 id. Magento 2 - Convert - Category - from Alumio Base Category. This transformer converts the Category from Alumio Base into Magento 2. Magento 2 - Check and send - Collection This transformer checks the current Magento 2 id from the previous iteration of this transformer to determine whether we need to create or update the category in the Magento 2 System. 
{
  "category": {
    "name": "Air Purifiers",
    "position": "1",
    "is_active": true,
    "include_in_menu": true,
    "parent_id": 1042
  }
}

​
Automatic Categories Synchronization Setup

  • Go to “Integrations → Schedulers → Akeneo - Fetch Categories”.
Image
  • Set a schedule expression and enable the configuration.
  • Go to “Integrations → Schedulers → Magento 2 - Send - Categories”.
    Image
  • Set a schedule expression and enable the configuration.