RO CSVI

HikaShop Limit Import with RO CSVI

This tutorial explains how to create a HikaShop limit import template, add the fields and how to run the import. Step by step we show you how to perform each task. A video will show you the steps in action so you can follow that as well.

Creating the template

A template can be created by following these steps:

  1. Go to Components -> RO CSVI -> Templates
  2. Click New
  3. Give the template a name, say for example HikaShop Limit import
  4. Set Action to Import
  5. Set Component to HikaShop
  6. Set Operation to Limit
  7. Click Next: Select Source
  8. Source is set default to Load from your computer. No need for change.
  9. Click Next: Select options
  10. The default values are OK, change if needed.
  11. Click Next: Select fields
  12. Nothing needed here as we set to Use column headers as configuration in step 10.
  13. Click Next: Finalize
  14. All done here
  15. Click Close to return to the list of templates or Edit if you want to fine-tune the template further.

Adding the template fields

Template fields can be added by following these steps:

  1. Go to Components -> RO CSVI -> Templates
  2. Click on Template fields
  3. In the Search Tools select your template
  4. Click on New to add a single field or click on Quick Add to add multiple fields.

Quick Add

The Quick Add Option allows you to quickly add multiple fields to a template. It is not possible to set any settings per field here but that can be done after the fields have been added to the template.

Required fields

  • product_code
  • category_path

Criteria

Unlike other imports, this import uses the all fields in import file to select existing row though the criteria shows product_code and category_path as required fields. That is because HikaShop does not have any unique column value with limits. If all the import fields values match an existing record, the record will be updated else record will be added.

Run the import

The import can be run by following these steps:

  1. Go to Components -> RO CSVI -> Import
  2. Select the template created earlier with name HikaShop Limit import
  3. Click Select file
  4. Select the file to import
  5. Click Preview
  6. You now see a preview of the file as to how CSVI sees the file
  7. Click Start import
  8. The import is run
  9. The Log details page will be shown with information regarding the import if the Enable logging is enabled in the template

Example Content

Access level for Custom usergroups

product_code,category_path,currency_code,limit_access
10001,product category/category1|product category/category2,EUR,Editor|Registered|Manager

Access level for all

product_code,category_path,currency_code,limit_access
10001,product category/category1|product category/category2,EUR,all

Access level for None

product_code,category_path,currency_code,limit_access
10001,product category/category1|product category/category2,EUR,none

Update a Limit

Since there is no unique identifier for a limit entry, it is not possible to update any existing limits. The way to handle this is to first delete a limit and then add a new limit.

Delete a Limit

To delete a limit use the field limit_delete and set the value to Y in the import file.

RO CSVI uses the following list of fields to find a matching row. The more the fields in import file, the more exact matching row is fetched to update.

  • product_code
  • category_path
  • limit_periodicity
  • limit_type
  • limit_value
  • limit_access
  • limit_status
  • limit_currency_id
  • limit_start
  • limit_end

The example below shows how to delete a limit and after deleting the rule, create a new limit with an updated category path.

product_code,category_path,currency_code,limit_access,limit_delete
10001,product category/category1|product category/category2,EUR,all,Y
10001,product category/category3|product category/category4,EUR,all,

Video showing the process

 

Example file

hikashop_limit_import.csv

Related Articles