Calago ETIM App for Akeneo
Description
This App adds functionality to load the ETIM Classification (last two major releases or dynamic release) into Akeneo PIM.
The App allows selection of the ETIM version, after which the user selects the ETIM Classes to be included in the Blueprint.
Upon synchronization of the Blueprint to Akeneo PIM, ETIM Classes are created as Families, ETIM Features as Attributes and ETIM Values as Attribute Options.
The ETIM Units can be aligned with the Akeneo Measurements using a reference table inside the App.
Upon re-sync from ETIM or the Blueprint, all ETIM-related entities in Akeneo PIM are updated to the Blueprint specification.
Note: If the ETIM-API doesn’t have labels, null values are not written to Akeneo PIM.
Release notes
Version 1.0
Initial public release.
Documentation
Introduction
This app is designed to be a connector between the ETIM API and Akeneo.
It is meant to create catalog structure in Akeneo according to one or more selected ETIM-classes from your ETIM subscription.
What this app can do
This app allows you to fetch ETIM-classes from the ETIM API.
After you've selected one or more classes you'll be able to push these classes to Akeneo.
This means that it will create catalog structure according to the selected classes.
ETIM entities are mapped to Akeneo entities according to the following table:
| ETIM | Akeneo | ||
|---|---|---|---|
| Class | ECxxxxxx | Family | ECxxxxxx |
| Feature | EFxxxxxx | Attribute | ECxxxxxx_EFxxxxxx |
| Feature Value | EVxxxxxx | Attribute Option | ECxxxxxx_EFxxxxxx_EVxxxxxx |
All features (attributes) will be placed in the attributegroup 'ETIM'.
ETIM has range features. These will be represented in Akeneo as table attributes.
In some cases the app will not be able to automatically match the ETIM-unit to an Akeneo Measurement Family and Measurement Unit.
You will find these on the Units page after you've pushed the selected classes to Akeneo.
Here you can manually map the unknown units to Akeneo Measurement Families.
After mapping is done, please push the selected classes again.
What this app can't do
In order to ensure data integrity, the Akeneo API does not allow for removal of catalog structure entities.
It is therefor not possible to remove ETIM-classes (families), ETIM-features (attributes) and/or ETIM-feature-values (attribute-options) through this app.
Any Akeneo entities you no longer need should be removed from Akeneo manually, using the Akeneo UI.
Settings
Before you can start working with this app, you'll need to provide some information in the Settings page.
Please provide your ETIM subscription details and set the required ETIM-endpoint, -version and -language.
After saving the settigns you'll be able to fetch all the ETIM-classes from the Classes page.
Currently only the etim-international.com and ketenstandaard.nl endpoints are supported.
Please contact us should you need an other ETIM-endpoint.
How it works
The basic way of working consists of the following steps:
- Make sure your Settings are correct.
- Go to Classes and make sure the class list is up-to-date. If needed, update the list by clicking on the Update list button.
- Select the desired classes by clicking on the corresponding row.
If you need to review the contents of the class, click on the Details button of the corresponding row. - Click on the Sync to Akeneo button to create the catalog structure.
- Review the Logs page for any issues. If needed, make sure all units are mapped on the Units page.
After resolving any issues, don't forget to click Sync to Akeneo on the Classes page again.
To fetch the latest version of all the selected classes:
- Go to the Classes page.
- Click on the Update selected button.
To review the the contents of a class:
- Go to the Classes page.
- Click on the Details button on the corresponding row.
This will also trigger fetching the latest details of the class.
To clear the logs table:
- Go to the Logs page.
- Click on the Clear Logs button.
Clearing the logs will be logged as a warning with the message Logs cleared.
This action can not be undone.