How to Mass Import Assets¶
A command has been created in the PIM to allow you to mass import assets: php bin/console pim:product-asset:mass-upload --user=[username]
For instance, with the user “admin”, the command will be: php bin/console pim:product-asset:mass-upload --user=admin
To make this command work, you need to copy the files you want to import into the following folder:
[tmp_storage_dir]/mass_upload_imported/[username]/
With:
[tmp_storage_dir]
the path configured in pim_parameters.yml
under the parameter tmp_storage
.
[username]
the name of the user that processes the import.
The command will upload the files into the application.
For example, if you upload a file named “demo_video.avi”, Akeneo PIM will check if an asset with the code “demo_video” exists. If so, the application will update the asset “demo_video” by importing the file “demo_video.avi” as the new reference file for this asset (and will also generate its variations). If no asset exists with the code “demo_video”, the PIM will create this new asset and will generate its variations.
If you want to enrich these newly imported assets with other information (such as a description, tags, etc.), you need to create an import profile for the job “Asset import in CSV”. For the sake of our example, let’s say the code of this profile is “assets_mass_upload”.
The job accepts a CSV file in the same format as the one below (delimiters and escape characters can be configured in the interface):
code | localized | description | end_of_use | tags | categories |
---|---|---|---|---|---|
paint | 0 | Photo of a paint. | 2006-05-12 | images | |
chicagoskyline | 1 | This is chicago! | chicago,cities | front | |
akene | 0 | Because Akeneo | 2015-08-01 | flowers,sunset | other |
autumn | 0 | Leaves and water | 2015-12-01 | colored,flowers | other |
bridge | 0 | Architectural bridge of a city, above water | cities,water | ||
dog | 0 | Obviously not a cat, but still an animal | 2006-05-12 | animal,dog |
In the profile configuration of the import job, you can specify the path to the assets CSV file on the server, so that this file is imported when the job is executed.
Then, the job can be can ran with:
php bin/console akeneo:batch:publish-job-to-queue assets_mass_upload --env=prod
Warning
One daemon or several daemon processes have to be started to execute the jobs. Please follow the documentation Setting up the job queue daemon if it’s not the case.
Found a typo or a hole in the documentation and feel like contributing?
Join us on Github!