Overview
By default, two files will be available to download at the end of a completed job.
- A CSV file containing all the processed rows and columns for the completed job
- A CSV file containing all the rows deleted during the job
Each project can have multiple custom Output Formats (OF).
In the case of assets type media files being imported, at the end of a job two outputs are automatically generated in ZIP format:
- Linked media: media files linked to at least one product, meaning they can be automatically synced with Akeneo PIM during Push
- Orphan media: media files not linked to a product, they are not sent out to the PIM.
More info on the feature here
Interface
Output Formats (OF) are listed and managed in each project pages
Additional configuration controls are available when clicking on the ➡️️ button for each created Output Formats.
Configuration
At the most basic level each OF needs the following parameters:
- Name: Can be anything, it’s just an internal reference
- Step: the step in the project after which the output will be generated
- Format: self explanatory, either Excel or CSV
- Source: a dropdown list of what should be put in the export
-
inter
the working sheet that was used during the step. Mostly interesting for debug purposes -
results
stores the tags of the Extraction step -
deleted
the fields / lines that were deleted in the step - they are combined into a single file at the end of the job the get all deleted rows across all steps. -
matched
all the lines that were removed / filtered in the match history step -
input
the data that the step received -
output
the data that the step sent to the next step - this is used to generate the default output on the last step. -
export
is present in the variant step and is used to export either parents or children.
-
Advanced Configuration
When editing a specific output format the following options are available. Some of them are self explanatory like the encoding or the separator to use in the CSV file, but there also are some extra configurations for the individual sheets of the excel file.
-
sheets
is an array of Sheet objects. They only have 2 properties:-
name
: The name of the sheet -
fields
: Which fields should be included in the sheet. It expects an array offield
objects with the following possible properties-
name
: the identifier of the field, ifnull
all fields will be included -
required
: expects a boolean. iftrue
the field will still be in the exported Output File as anull
, even if the column is empty or non-existent in the Dataframe. -
template
(optional): allows formatting the value of the field, using a basic handlebars template syntax. The exposed variables arename
andvalue
. i.e."template": "{name} - {value}"
-
-
A note on Webhooks
At the end of a job, a Webhook can be triggered. To add a new webook, in the admin, go to Connectors > [Project webhooks](<https://sdm.akeneo.cloud/admin/connectors/projectwebhook/>)
.
The configuration is pretty simple and self explanatory
The url
is the URL of the webhook. The headers
section allows hardcoding extra configuration that will be passed with the request to the url
.
The only available trigger at the moment is Job Done
. This means the webhook will be triggered every time a job for the project
is completed.
The payload of the Job Done
webhook is:
job_id
completion_date
-
last_editor?
the email of the last editor of the job, if it exists
Retrieving the outputs of a job through FTP
Similarly, the outputs
directory lists all the existing projects in your organization. (cf-FTP)