Plateforme de gestion de l’expérience produit

Print extension for Akeneo PIM

Use your Akeneo PIM product data to create catalogs

Arsia Product Data Publishing is a web platform (available in cloud or on-premise) allowing Communication and Marketing departments to easily create product catalogs, price lists, leaflets, product sheets, brochures, magazines, advertisement, …

Thanks to our Akeneo PIM connector, Arsia Product Data Publishing automatically synchronizes all data (attributes, images, attribute options, families, categories, channels…) with your Akeneo PIM instance (based on Akeneo REST API) so you can use all your product data directly into documents with a nice and professional quality layout.

Arsia offers a multiplicity of creative possibilities thanks to Adobe Indesign Server©. Arsia includes an image library (DAM) and page setting functions that are easy to use with no prior DTP experience, helping you to produce very high quality and attractive documents.

Directly within your web browser, Arsia Product Data Publishing offers the following built-in functionalities:

  • Drag-and-drop of your Akeneo product data into catalog pages,
  • Automatic layout and rendering,
  • Integrated template management,
  • Advanced layout composition (styles, lists, tables…),
  • Layout adjustment (move and resize of areas, image crop, auto-adjustments),
  • Data enrichment (related information, pictos, automatic calculus…),
  • Automatic updates from Akeneo to all related publications,
  • Proofreading,
  • Validation workflow, 
  • Native InDesign file management,
  • Multiple PDF exports
  • Digital publication web application

Arsia Product Data Publishing includes a module named “data manager”. It is a dynamic database that allows to store locally all the product information from Akeneo PIM (attributes, attribute options, attribute groups, locales, channels, categories, families, family variants, currencies, measure families…). You just need to provide in Arsia configuration file the credentials to connect to your Akeneo PIM instance by its REST API

Arsia provides a “structure” synchronization feature that you can run each time you need (first initialization, new attribute, activation of a currency…) to synchronize the data structure between Akeneo PIM and the “Data Manager”.

Arsia also provides a background process that runs permanently to manage the synchronization of product data. It calls your Akeneo PIM instance every 30 seconds (manageable frequency from 10 seconds to 24 hours) to get updated product information (request by update date): all updated data is copied back to the “data manager” (categories and all product attributes including images). Arsia relies on Akeneo PIM unique identifiers for each element: if the element does not exist in Arsia it is created on the fly otherwise it is updated.

All product information in Arsia is locked in read-only mode for the users to ensure Akeneo PIM as unique reference data source.

All the copied data are directly usable in Arsia with the same navigation process as in Akeneo PIM (category selection, attribute filters). Users select products and push them into templates by drag and drop (InDesign files directly managed in Arsia user interface using Adobe InDesign Server technology). Arsia also provides specific features to produce automatic layout for Akeneo product attributes: dynamic joining with predefined texts before and after, InDesign style applications, table rendering

Arsia keeps a link between the data and created documents: any update on product information within Akeneo PIM is synchronized in Arsia “data manager” which updates on the fly all the documents that contains that product information.

Synchronization processes are monitored in Arsia: a complete report of each synchronization is created and stored. 

To install Arsia Product Data Publishing extension, first you need a running instance of Akeneo PIM (2.2.x or 2.3.x) and a running instance of Arsia Product Data Publishing . There is nothing to install in your Akeneo PIM instance, extension relies only on standard features (the REST API).

In Akeneo PIM, you must create an API account

Go to System > API connections and click on the “Create” button in top right corner

Provide a label to your connection (eg: “Arsia Production Data Publishing connection”)

Copy the generated Client ID and secret generated by Akeneo that appears after validating

As an option, you can also create a dedicated user account in Akeneo PIM administration. Arsia Product Data Publishing will connect to Akeneo PIM using this user account.

In Arsia Product Data Publishing, edit the configuration file config.php (or ask support team if you use a cloud instance) in “conf” folder. Add the following lines replacing values on the right part between simple quotes:

$g_amConfig['enablePimSyncAkeneo'] = true; $g_amConfig['akeneo_root_url'] = 'http://www.your-akeneo-instance-url.com/'; $g_amConfig['akeneo_client_id'] = 'generated_client_id'; $g_amConfig['akeneo_secret'] = 'generated_secret'; $g_amConfig['akeneo_login'] = 'user_login'; $g_amConfig['akeneo_password'] = 'user_password’; $g_amConfig['akeneo_channel_for_generic'] = 'ecommerce';

It is a key-value array defined in PHP. Each key corresponds to a specific information:

  • enablePimSyncAkeneo: Activates Akeneo extension within Arsia Product Data Publishing
  • akeneo_root_url: Root url of your Akeneo instance
  • akeneo_client_id: “Client ID” copied from Akeneo API connection interface
  • akeneo_secret: “Secret” copied from Akeneo API connection interface
  • akeneo_login: Akeneo user login
  • akeneo_password: Akeneo user password
  • akeneo_channel_for_generic: Akeneo channel that is used as default within Arsia Product Data Publishing if no export channel is specified

These two configurations can also be added in option: 

$g_amConfig['akeneo_cron_sync_data_sleep_time'] = 30; $g_amConfig['akeneo_cron_sync_data_overlap_delta_time'] = 3;
  • akeneo_cron_sync_data_sleep_time: Time in seconds that the data synchronization process will wait between two calls to Akeneo API to retrieve updated information. If not defined, the default value is 30 seconds.
  • akeneo_cron_sync_data_overlap_delta_time: Time delta overlap in seconds to manage potential time difference between Akeneo server and Arsia Product Data Publishing server. If not defined, the default value is 3 seconds.

Once configuration is ready and saved, you have to run a first structure synchronization in Arsia Product Data Publishing

Go to “Data Manager” module > “Database structure” > “Akeneo synchronization”

Check that indicated Akeneo Server url is ok

Click on “Next” button to run a first synchro

A report will be displayed: background data synchronization task will start automatically and perform a full product data synchronization. Depending on the number of products and the bandwidth between the two servers, this first initialization may take several minutes to complete.

Once first full synchronization is done, a frequent call is done automatically (frequency defined the configuration information) from Arsia to Akeneo PIM to check for updates.

In Arsia “data manager”, you can check that information is complete and up-to-date.

This extension relies only on Akeneo PIM standard features, no specific documentation is needed to use it.

Concerning Arsia Product Data Publising, a complete user documentation is offered to each licensed users.
It is available in HTML and PDF format.

A specific training is recommended to get the best from the numerous features of Arsia Product Data Publishing.

Discover Arsia Product Data Publishing,
Ask for a demo!