Professional Documents
Culture Documents
CONTENTS
I
INTRODUCTION.................................................................................................. 3
II
TRAINING ............................................................................................................ 4
VI TIPS ................................................................................................................... 21
6.6 How to export prices incl. Tax & shipping cost separately ............................... 23
6.7 How to identify product reference duplicates ................................................... 24
6.8 How to modify the exported prices with a calculation ...................................... 24
6.9 How to modify the exported characters strings ................................................ 24
INTRODUCTION
Store Commander includes an option, which allows you to quickly export products off
your catalog. This is the Quick Export option, identified by the icon
on the
Products panel toolbar and on some grids in the Properties panel.
With this option you can export the data displayed in the panel you are in; a fast and
efficient functionality.
However, if you wish to customize your exports, this is where the CSV Export tool
comes into place.
With Store Commanders integrated CSV Export tool you can run multiple timesaving tasks such as:
II
TRAINING
This Users Guide dedicated to CSV Export is to guide you in a pragmatic manner
managing your Export operations with Store Commander.
If you wish to gain even more time and efficiency, various training sessions are
available, of which SC CSV Export.
The program is well-structured and the training session is delivered on a one-to-one
basis, directly with you and your files. This accelerates even more the understanding
and handling of the CSV export tool so that you can run your exports in full
autonomy.
Attractive packs Store Commander License + Training are available on this page:
http://www.storecommander.com/en/103-training-packs
III
DEFINITIONS
Now you might be totally tech-savvy and already know what we are talking about
when mentioning export scripts and mapping. Yet again you may be less techsavvy and need a little explanation before moving onto the detailed process.
3.1
3.2
What is a mapping?
When preparing the export of your products, you will need to decide which
information you want to export, such as products names, prices, combinations
attributes, images, etc.
This information is stored in the database as database fields. These are the fields
that you will need to choose when setting up your CSV export script. This
configuration is called the mapping.
The mapping fields will then be displayed as columns in your generated CSV export
file.
We will see in more details how to configure a mapping later.
IV
When running the CSV Export tool for the first time, Store Commander will prompt
you to install export scripts beforehand. To do so, go to Tools > Installation > Create
scripts files examples for CSV export.
This will create configuration files needed for the export tool to run.
Please refer to our article http://support.storecommander.com/entries/22081736-thecsv-export-tool-requires-folders-to-be-created
Once installed, you will see scripts displayed in the CSV Export window.
Note that these export scripts are only sample scripts to help you configure your own
export scripts. They are not necessarily up-to-date with templates from price
comparators or market places. You can use and modify them according to your
specific needs.
EXPORTING EFFICIENTLY
Store Commander's exporting feature is not just your standard export tool... Much
more than just a management tool, it is a powerful turnover booster. Not only will it
will assist you in getting your products visible quicker on the Net, but it will also help
you selling them much faster!
Indeed this universal export tool allows you to export your products to any price
shopping engine or marketplace such as Googlemerchant, Amazon, Nextag, Ebay,
Shopping.com, etc. What's more, you can also export your products to other
Prestashop stores if you are selling the same products on different stores.
The following section is dedicated to explaining how to proceed to boost your sales
using the powerful Universal Export feature integrated to Store Commander.
The CSV Export window can be found under the Catalog menu.
5.1
To export your data in a fast and error-free manner, simply follow these steps.
Once the lines are added, double click each line to select the database field from the
drop-down list (see the complete list <AJOUTER LIEN SECTION>).
Some fields require an additional setting indicated by a dark blue color in the
Language and Options columns. Double-click to select the corresponding option.
Once all fields are populated, you can save this mapping configuration by giving it a
name and click on save to validate.
10
Saving your mapping configuration is compulsory, but it also means that you will be
able to use it again for another export, a great time-saving feature.
To re-use any saved mapping, simply select it from the available drop-down menu.
Any changes made to an existing mapping need to be saved.
Your next step is to select the categories you wish to export. To do so, simply tick the
corresponding boxes against the categorys name.
By default, if a category is selected, the sub-categories are automatically selected.
However, you have the option to disable the recursive selection with a right-click on
the tree structure to display the pop-up menu where the option is:
Like the mapping, give a name to your selection and save it.
11
Saving your categories selection is compulsory, but it also means that you will be
able to use it again for another export, a great time-saving feature.
To re-use any saved categories selection, simply select it from the available dropdown menu.
Any changes made to an existing selection need to be saved
12
Once the export is completed, the information is displayed in the panel, providing you
with a link to the export file, as well as the number of lines included in the file. Click
on the link to save and open the file.
5.2
You would like to export your entire catalog quickly without overloading your server?
With Store Commanders powerful auto-export tool, you are going to be able to
export your catalog in the blink of an eye.
Lets see how it works.
From the CSV export window, create an export script by clicking on the add icon.
13
Lets move onto the mapping configuration, which corresponds to the database fields
that will display your products information in the generated CSV file.
Store Commander will be able to detect all fields used in your catalog and display
them in this mapping configuration, simply by clicking on this new icon called load all
fields,
Here we are. All fields, all languages included, are displayed. You do not need to
select the languages, nor the combinations and features groups in the Options
column. Everything has been done to make it easy for you.
14
By ticking Home, all categories and sub-categories are automatically selected at the
same time.
Like for the mapping, we need to name and save this category configuration here.
Now to finalize the export, we need to select the information in the top panel:
Select the mapping name, the categories configuration, name the exported file
without forgetting the file extension (.csv).
Tick the options you wish to include in this export file. Here we will select everything.
Make sure this option enclosed by is selected to export your descriptions, and that
the ISO encoding option is ticked for accentuated characters if need be.
Whether you are on a dedicated or shared server, the servers resources will be
impacted during the export process, especially considering the large number of
products, and whether they include combinations, features, image, etc.
To ensure a seamless export, we have designed a powerful auto-export tool in this
panel.
15
The auto-export allows you to setup a time interval to split the export process in small
chunks, which will reduce the server resources, especially if you are on a shared
server.
To enable the option, simply click on the icon.
Enter the number of lines and the time interval in seconds.
5.3
Just like we have seen above, Store Commander allows you to export your entire
catalog in all languages in just a few steps.
16
The mapping panel also includes filtering options, allowing to exclude specific fields.
With these filters, you will be able to export your catalog but this time in different
languages.
For instance, to export your catalog in French, load all fields with the corresponding
icon, and then add EN in the filter box of the Language column. Only data in
English is displayed.
17
Now you can choose to delete them using the delete icon:
Repeat the same steps for all other languages except French.
Once you have saved this mapping and categories configuration and selected the
additional options, you can start the export.
The generated CSV file will include your catalog in French only.
5.4
If you are managing multiples stores with Store Commander, the CSV export tool
allows you to export data for one or multiple stores in the same export.
18
This allows you to select the store you wish to export the data from.
Selected shop corresponds to the store(s) currently selected:
You can then export products existing in all the stores you would have previously
selected in the stores tree.
To find out which stores the exported products belong to, simply include these two
fields in the mapping configuration:
id_shop_list: ID of all stores onto which products will be added
id_shop_default: ID of the default store for those products
19
VI
TIPS
6.1
Auto-export tool
Whether you are on a dedicated or shared server, the servers resources will be
impacted during the export process, especially considering the large number of
products, and whether they include combinations, features, image, etc.
To ensure a seamless export, we have designed a powerful auto-export tool in the
Export Process panel.
The auto-export allows you to setup a time interval to split the export process in small
chunks, which will reduce the server resources, especially if you are on a shared
server.
To enable the option, simply click on the icon.
Once the process has started, you can follow it in the panel until it is completed:
20
6.2
6.3
Store Commander includes a column in the mapping panel allowing you to rename
any column headers, i.e. replacing the name of the selected database fields in your
mapping configuration.
Simply double-click in the column name of column
21
6.4
With Store Commander you can export your description without html tags. This article
explains how.
Also, when exporting descriptions, you need to select the option Enclosed by in the
top panel of the Export window. This will avoid having your descriptions being spread
in multiple cells of the CSV file. More information in this article.
6.5
Store Commanders integrated CSV export tool allows you to customize your export
files, such as exporting your products combinations.
This article provides you with a detailed explanation, including screenshots, on how
to proceed.
6.6
Store Commander allows you to export your products price incl. tax + shipping cost
with the mapping field 'priceinctaxwithshipping'.
On the other hand, it is not currently possible to export the shipping cost only
because the field is not yet available in the mapping. It will be added in a future
update.
Until then, the workaround to allow you to export your products price including tax as
well as the shipping costs as two separate fields can be found in this article.
6.7
If you wish to identify duplicate products references in your catalog, run an export
using database fields name & reference. Once the data is exported, use the MS
Excel SORT function.
6.8
You can enter a mathematical formula in the Modifications column in the mapping to
apply a calculation on the exported value:
A suggestion to improve this guide? Contact us
Copyright 2009-2015 SARL Store Commander
22
= x * 1.10
This formula will add 10% increase. x represents the exported value.
= round ( x * 1.115 , 2 )
This formula will add 11.5% increase and will round up to 2 decimals.
= ceil ( x * 1.115 )
This formula will add 11.5% increase and round up to the next higher whole number
= floor ( x * 1.115 )
This formula will add 11.5% increase and round up to the next lower whole number.
=(x)+15
This formula will add an amount of 5. x represents the exported value.
=(x)*1.2
This formula will add a 5% increase. x represents the exported value.
6.9
You can add one of the codes below in the Modifications column of your mapping to
change the exported value (name, descriptions, etc):
html_entity_decode
Allows the decoding of html characters.
strip_tags
Deletes html elements, obtaining only plain text with no formatting.
strtolower
Changes the strings to lower cases.
strtoupper
Changes the strings to upper cases.
23
VII
CHECKLIST
24
VIII
8.1
8.2
My categories selection includes 50 products but only 40 products are
exported?
Check that the option in the top panel of the export window called Export by default
category is not selected (Checklist 7).
8.3
Check the categories selection you have created has been effectively saved and
selected in the main configuration panel (Checklist 3).
8.4
Your CSV export file is not displaying accents correctly; instead you see characters
of type <irement raliss >.
This happens when you do not select the ISO encoded option in the configuration of
your export script (Checklist 7).
8.5
This error occurs when an integrity issue has been found in the database in the
category ID specified in the error message. Refer to this article for more information.
25
IX
Here is the list of all icons used in Store Commander CSV export configuration
window.
Scripts
Refreshes the panel
Creates an export script
Deletes the selected script(s)
Mapping
Refreshes the panel
Loads an existing mapping
Saves the new mapping
Deletes the selected mapping and resets the display
Adds a line for a database field
Deletes a line of database field
Selects all database fields displayed in the panel
Loads all database fields used in the catalog
Categories
Refreshes the panel
Loads an existing categories selection
Saves the new categories selection
Deletes the categories selection
Process
Auto-export option splits the export process
Starts the export process
A suggestion to improve this guide? Contact us
Copyright 2009-2015 SARL Store Commander
26
Here is the complete list of available database fields to export your data.
_fixed_value
*active
availability_message
available date
available_later
available_now
categories
name of categories
category by default
condition
date_add
date_upd
depth
description
description_short
ean13
ean13 number
ecotax
amount of ecotax
feature
name of feature
height
id_category(s)
id_category_default
default category ID
id_manufacturer
manufacturer ID
id_product
product ID
id_product-id_attribute
id_product_attribute
combination ID
id_shop_default
default shop ID
id_shop_list
id_supplier
supplier ID
image_id
image ID
image_legd
image legend
image_link
image URL
last order
link_rewrite
27
link_to_cover_image
link_to_product
product URL
links_to_all_images
location
manufacturer
name of manufacturer
margin
margin amount
meta_description
meta_keywords
meta_title
minimum quantity
name
name_with_attributes
*on_sale
*out_of_stock
price_exctax_without_reduction
price_inctax_without_reduction
priceexctax
priceinctax
priceinctaxwithshipping
productshippingcost
quantity
quantity of product
redirect_id_product
product ID redirected to
redirect_type
page/type of redirection
reduction_from
reduction_perct
reduction_price
reduction_to
reference
product/combination reference
show price
stock_value
stock_value_wholesale
supplier
name of supplier
supplier_refenrce
supplier reference
tags
type of unit
unit price
unit_price_impact
upc
upc number
vat
tax rule
weight
wholesale_price
wholesale price
width
28
29