by George Dzuricsko
Monday, December 21, 2020
When you work on product data in the PIM, you probably have some concerns likeā¦
What happens if I make a mistake?
What happens if the manufacturer changes its mind?
How can I find out who changed this piece of product data?
Rest easy, my reader.
Akeneo has both a history and restore option that helps you understand what changed and when as well as how to undo it.
Version history tracks the changes on various entities in Akeneo to show the history of changes to a product. This is incredibly valuable documentation for product changes that will help you preserve previous versions if you need.
Below is a view of a demo product on the version history. You can quickly see the number of versions, the author, what changed and when.
Want to roll back a change? Click restore. Voila.
Feels like magic, but what happens in the back end? And what limitations come with this approach?
As of version 4.0, Akeneo stores previous versions of supported entities in the pim_versioning_version
table in the database with the following fields:
Id
Author: (username of the user who made the change)
resourceName: (Entity, in this case Product) But the full list is below:
resourceId: (id of the record in the relevant Entity db)
Snapshot: array of current values
Changeset: array of only changed values
Context: additional information on job/process that caused the change
Version: current number of revision to specific item
Logged_at: Timestamp of change
Pending: Answer Pending based on tech team
Akeneo stores Changeset and Snapshot as normalized PHP arrays in the database, which allows for easier PHP array comparisons. A drawback to this is additional processing to export data using JSON or some other data type from these columns requires converting it back to PHP and then to whatever type you need.
There are some important limitations to version history.
Akeneo Cloud editions have a default version history length of 90 days. After that, a console command pim:versioning:purge --more-than-days 90 --no-interaction --force
runs via cron job. You can change that on Flexibility, but not on Serenity. 90 days should be plenty, but it's something to consider when evaluating your PIM requirements. Be sure to discuss this in the early stages of evaluating the appropriate version of Akeneo.
On a very large PIM implementation, the size of the version history table can very quickly take over most of your free space if you disable the version history table or do not properly plan for the size of your PIM server.
There is no natively supported export of audits for versioning, so you are limited to the individual entity view page. In other words, you can only view the history of a single product and cannot search with filters of a modified attribute. There are some possible customizations here that we can help you estimate and explore, but only if you are on the Flexibility platform.
The above list helps for any of these entities but excludes a few with some important implications. Reference Entities and Assets are not supported, meaning changes to those records will not have a rollback feature, user audit record, or any of the other version history features. For example, if you change which reference entity a product attribute is assigned, it will be viewable in the interface:
But if you change the label on the reference entity:
There is no way to show that change on the reference entity record or on the products that have that entity assigned. Assets behave in a similar way, where changes to the individual asset do not register a version history but will affect how assets are viewed downstream.
Have any additional questions? Feel free to reach out to us!
Sitation Earns Gold Akeneo Partnership, Expands PIM Delivery Capability
by Steve Engelbrecht
Steps to a Successful Akeneo Implementation: Part 1 - What are your goals for PIM?
by George Dzuricsko
A Deep Dive into Akeneo's Product Version History
by George Dzuricsko
An Akeneo Primer: Workflows 101 - How To Work the Workflows
by Brad Johnson
Help! My Products Are Suddenly Missing in Akeneo
by Matt Helm
Cheat Sheet: 9 Steps to a Successful Akeneo Implementation
by Sitation
Why You Should Adopt Akeneo's Built-in Tools Rather Than Forcing Functionality Into Akeneo
by Matt Helm
Akene-Oh No: Common Pitfalls to Avoid When Using the Akeneo PIM
by Matt Helm
Why Better Taxonomy Is a Delight to Merchants and Consumers Alike
by Autumn Demonet
5 Fundamentals to Master Product Experience Management
by Catherine Marquand
Akeneo: Requiring an SSL Connection with MySQL
by Don Bales
Akeneo: The Missing MTA Documentation
by Don Bales
Keys to a Great Akeneo Discovery
by George Dzuricsko
Sitation Earns Silver Partner Badge with Akeneo PIM
by Steve Engelbrecht
Ecommerce Veteran Sitation Finds New Opportunities Despite Pandemic
by Elizabeth Moore (GrepBeat)
B2B E-Commerce: Where should I start?
by Steve Engelbrecht
Akeneo 4.0 Features We Are Most Excited About
by George Dzuricsko
Sitation Announces Partnership with Akeneo
by Sitation Team
Work From Home Productivity Tips
by Steve Engelbrecht
Ecommerce Trends for Digital Transformation in 2020
by Megan Fitzpatrick
A Distributor's Guide to Sourcing Product Content
by Craig Lewis
An Efficient Taxonomy Can Benefit Your SEO
by Megan Fitzpatrick