What's new in Serenity EE & GE?
Discover our features per version

Heads up! This is the documentation for our Akeneo Serenity Enterprise and Growth editions. Serenity clients benefit from exclusive access to our latest PIM features. If you're interested in other versions, click on the drop down menu on the top right corner or check out everything you need to know about your version.

Tailored export - customize your product information exports

Available in our Entreprise Edition & Growth Edition

#Overview

This feature consists in an export profile, available only for our Enterprise Edition or Growth Edition users. It helps you to export your product information in flat files, with your own structure.
For instance, let's assume your retailers or distributors need the same product information from you, but they want different structures:

  • Retailer A wants an export with columns named: "Identifier", "Product Name", "Description", and "Weight (Ounces)".
  • Retailer B wants an export with columns named: "Name in French", "Name in English", "Description 1", "ID", and "Weight (Kilograms)".

Without Tailored Export, you have to export your product information thanks to a regular product export profile, and manually modify your spreadsheet to reorder the columns, change their name, convert the measurements, for as many retailers and distributors that need it.
Thanks to Tailored Export, prepare the work from Akeneo PIM creating a Tailored Export profile per your retailer's or distributor's requirements and use it as often as necessary. You no longer need to manually edit your flat files when you need to share product information.

To learn more about Tailored Export and how to use this feature, please watch our training Tailored Exports Foundations.

#Create a tailored product export profile

To create a tailored product export:

  1. Go to Exports
  2. Click on Create export profile
  3. Type a unique export code and a label, then select the job Tailored product export or Tailored product model export. You can select either CSV or XLSX for each job. Create a new product export profile
  4. Save your new export profile

#Edit a tailored product export profile

Once you've created your tailored export profile, or if you want to edit an existing one:

  1. Go to Exports
  2. Click on the tailored export profile you want to edit
  3. Click on Edit located in the top right corner of the screen

#Discover the different tabs of this profile

A tailored export profile is similar to a regular product and product export profile. The main difference is that you have a tab to configure the structure of your flat file.

Here are the tabs you can use:

  • Properties: To define the label of your export profile.
  • Permissions: To set permissions to allow specific user groups to execute or edit your export profile (Enterprise Edition only).
  • Global settings: To define several settings: the maximum number of lines per file, if you want to export the media (this will generate a file archive when exporting), the field delimiter (CSV format only) and the field enclosure character (CSV format only).
  • Product selection: To use the provided filters to decide which products will be exported (read how to define your product selection).
  • Export structure: To build your export structure (read how to define your export structure).
  • History: To display the modifications by any user on your export profile.

To export the media, your export structure must include at least one source using an attribute like Image, File or Asset collection.

If the attribute as main media used in your asset family has a value per locale and/or per channel, all of its media files will be exported.

#Define your product selection

In the Product selection tab, you can select the products which will be exported. Filters are available to help you to refine your product selection. You can filter on family, category, status, completeness, data quality or even insert a list of identifiers. You can also add new attributes to use them to filter your products.

Select multiple category trees

If no categories are selected, all products will be exported, including all unclassified products.

#Define your export structure

In the Export structure tab, you can build the structure of your file. You need to create the columns of your file, name them & link them to your PIM attributes, system properties or association types in order for your export profile to be launched.

To do this, please follow the steps below:

  1. Add a first column by clicking on Add first column. Add first column

    If you want to add columns in bulk from an Excel file, you can copy all the columns header in your spreadsheet and paste them in the last column created, so that it creates automatically all your columns in your export. Add columns in bulk

  2. Once your first column has been added, you can define the column name in the text field that just appeared. Name your columns
  3. Then, you need to add a source for each column, which means selecting an attribute, a system property or an association type. To do this, please select the column you want, then, in the right panel, click on Add source and select any item from the list.

    System properties are not set by default. Select only the system properties you need. You can choose: "Enabled", "Category", "Family", "Family variant", "Groups", "Parent" and your association types.

  4. Once you've added a source, different options are available depending on the attribute you selected. Most of the time, if your attribute has a value per locale or per channel, you may have to select from which channel and/or from which locale you want the data to be exported. But for some attributes, more options are available. For instance, you can choose between exporting the code or the label of the attribute option, and which separator (comma, semi-colon, pipe) you want, when applicable. Add a source
  5. Once you're done, click on Save in the top right corner.
  6. To launch your export profile, in the breadcrumb, click on the name of your export profile, then click on Export. Breadcrumb

Limitations have been set for each Tailored Export profile:

  • Column headers must be unique.
  • You can add up to 1,000 columns.
  • You can add up to 4 sources in a single column.
  • You can add up to 10 text separators within a concatenation operation.
  • Text fields are limited to 255 characters.

#Discover operations

You can use operations to share the most meaningful values for your stakeholders by adapting your PIM values in different ways when exporting them.

To learn more about operations, please watch our training Tailored Exports Operations.

Depending on the sources you define, here are the different types of operations you can add:

#Yes/No replacement

Replace the default values with your own value (only available for the "Yes/No" attribute or the "Enabled" system property). Yes/No replacement

#Replacement

Replace the values by your own (only available for simple select, multi select, reference entities single link or multiple link attributes). Replacement

#Use default value when empty

Define a default value when the source value is empty. Use default value when empty

#Conversion

Convert measurement units within the same measurement family (only available for measurement attributes used as a source). Conversion

#Rounding

Round measurements values, choosing from Round, Round up & Round down and define the number of digits - up to 12 - after the decimal separator (only available for measurement attributes used as a source). Rounding

#Concatenation

Concatenate different sources by displaying up to 4 per column. Click on Add text to add more details and create a separation between sources. Concatenate

#Clean HTML tags

Clean automatically all the HTML tags in your text attributes used as a source. Clean HTML tags

If you added a default value with HTML tags thanks to the Use default value when empty operation, and if you checked Clean HTML tags for the same source, this operation won't clean the HTML tags for the default value.

#Selection

Select the format of the value you want to export. For instance, you can select the label or the code, the separator, etc. This operation will allow you to decide exactly what product information you want to export, for each source. Selection

#Duplicate a tailored product export profile

If you want to create another export profile based on an existing one, you can duplicate it. To do this, please follow the steps below:

  1. Select the export profile you would like to duplicate
  2. Click on Edit
  3. In the top right corner, click on the three dots "..." and select Duplicate
  4. Write a label and a code then click on Save

Want to find out more? Take a look at these related articles