NopTalk Pro
User guide
vasksoft@gmail.com
www.vasksoft.com
Table of Contents
I.
About NopTalk Pro ............................................................................................... 3
Features ................................................................................................................................................................. 3
System requirement ............................................................................................................................................. 4
Supports nopCommerce ..................................................................................................................................... 4
Supports receive locations .................................................................................................................................. 4
Supports source formats ..................................................................................................................................... 4
Support resource mapping ................................................................................................................................. 4
II.
NopTalk Pro Installation ...................................................................................... 5
Installations instructions ..................................................................................................................................... 5
III.
NopTalk Pro Usage............................................................................................... 8
Start application.................................................................................................................................................... 8
NopTalk Manager - Application menu ............................................................................................................ 8
NopTalk Manager – Stores ................................................................................................................................ 8
NopTalk Manager – Vendors (Source mapping).......................................................................................... 10
Vendors list ............................................................................................................................................................................. 10
Vendor`s information and source data mapping ............................................................................................................. 11
Vendor`s data ......................................................................................................................................................................... 11
Vendor`s source data ............................................................................................................................................................ 12
XML source data ................................................................................................................................................................. 12
Excel source data ................................................................................................................................................................. 12
CSV source data ................................................................................................................................................................... 13
Vendor`s source data mapping to nopCommerce .......................................................................................................... 14
General rules for XML mapping....................................................................................................................................... 14
General rules for Excel or CSV mapping ........................................................................................................................ 14
Product info mapping ......................................................................................................................................................... 15
SEO mapping ....................................................................................................................................................................... 16
Category mapping ................................................................................................................................................................ 18
Manufacturer mapping ........................................................................................................................................................ 19
Pictures mapping ................................................................................................................................................................. 20
Product attributes mapping................................................................................................................................................ 21
Source data filter mapping ................................................................................................................................................. 22
Test source mapping ........................................................................................................................................................... 23
NopTalk Manager – Tasks ............................................................................................................................... 25
Tasks list .................................................................................................................................................................................. 25
Insert or update tasks. ........................................................................................................................................................... 26
Insert task ................................................................................................................................................................................ 26
Task mapping ......................................................................................................................................................................... 27
NopTalk Manager – Logs................................................................................................................................. 32
Logs and reports .................................................................................................................................................................... 32
NopTalk Manager - System Tray .................................................................................................................... 33
About NopTalk Pro
NopTalk PRO allows you to easily upload your product information into your nopCommerce store.
Save yourself hours with this module and make inventory management a breeze.
Simply match the tags from your XML/CSV/XLSX file to nopCommerce product fields to import your feed thousands of products imported in one click!
It's easy to migrate from any other platform to nopCommerce - as long as you can get a XML/CSV/XLSX file from
your old system, this tool can import it to nopCommerce. Or you can use it to set up multiple shops with ease. This
is also good for daily updates from suppliers' feeds.
Features

Tools can set automatic close store before import;

Import from multiple Suppliers;

Map fields;

Set scheduler for importing individual per supplier (minutely/hourly/daily);

Upload your XML/CSV/XLS file or download it from a HTTP URL or a FTP;

Manage Suppliers list and theirs import tasks. One supplier can have multi tasks. Example:
o
One tasks for products filtered by category/manufacturer/or another filter - just update
price/quantity/availability/attributes;
o
One tasks for products filtered by category/manufacturer/or another filter - insert and update
products;

Add and update products;

Specify the meta data, default name, short description, full description;

Modify the price field during import - e.g., add 21% to your supplier's pricing;

Import only these products that you want - e.g., Filter where Quantity >0, Price <50, Brand=Nike,
Type=Shirts;

Import multiple top level categories and subcategories;

Split categories by delimiter;

Download remote images from path;

Does not require any particular field to be imported, only import the data you want to show in your store;

Import into multiple nopCommerce stores;

Show importing logs and reports.
System requirement

Windows OS;

.NET Framework 4.5.1;
Supports nopCommerce

nopCommerce v3.50;

nopCommerce v3.60;

nopCommerce v3.70 (will available in NopTalk Pro v2.0)
Supports receive locations

File System;

FTP;

Web URL;

Web services ((will available in NopTalk Pro v2.0))
Supports source formats

XML;

CSV;

XLSX;
Support resource mapping

Replace founded source text with your text. (Will available in NopTalk Pro v2.0);
NopTalk Pro Installation
Installations instructions

First download the installation file “NopTalkPro_v1.1.msi” from our site http://www.vasksoft.com

Run the downloaded file. It will open the installation wizard.
Picture 1 Setup wizard

Press button “Next”.
Picture 2 Setup wizard

Read the End-User License Agreement, then check “I accept the terms in the License Agreement” and press
button “Next”.
Picture 3 Setup wizard

Specify the installation path and press button “Next”.
Picture 4 Setup wizard

Click “Install” button to begin installation.
Picture 5 Setup wizard

Click the “Finish” button to finish installation.
NopTalk Pro Usage
Start application
To run application click shortcut on Desktop
or in Start menu. The application will start.
Picture 6 Application start
NopTalk Manager - Application menu
Ribbon menu – NopTalk manager:

Stores – there are saved nopCommerce stores settings;

Vendors - there are saved vendor sources settings and mappings;

Tasks - there are saved import tasks settings, mappings and statuses ;

Logs – import tasks logs and reports viewer;

System Tray – minimize the application to system tray;

Exit – exit the application.
NopTalk Manager – Stores
This module is designed to save connections to nopCommerces stores, in which will be imported products. Stores
module functionality:

List of nopCommerce stores;

Insert nopCommerce store settings;

Update nopCommerce store settings;

Delete nopCommerce store settings;
Picture 7 List of stores
Picture 8 Connection data of the nopCommerce store
NopTalk Manager – Vendors (Source mapping)
This module is designed to save Vendor`s information and data source mapping. The module functionality:

Vendors list;

Save Vendor`s data;

Save Vendor`s source data;

Save Vendor`s source data mapping to nopCommerce;

Test source mapping – preview mapped data.
Vendors list
Picture 9 List of Vendors
Vendor`s information and source data mapping
Vendor`s data
Picture 10 Data of Vendor
Input fields:

Name – Vendor name;

Description – Vendor description.
Buttons:

Test mapping – will open items preview windows to view mapped data from source file.

Save – save data;

Close – close this windows and return to Vendors list form.
Vendor`s source data
XML source data
Picture 11 Data of Vendor`s XML data file
Excel source data
Picture 12 Data of Vendor`s XLSX data file
CSV source data
Picture 13 Data of Vendor`s CSV data file
Input fields:

Source type – How to get the file. Available values: File System/Ftp/Web URL;

Source address – Where to get the file. File/Ftp/Web Paths;

Source username – Set username, if required credentials get source file;

Source password – Set password, if required credentials get source file;

Source format – source formats list. Available values: XML/CSV/XLSX.

First data row index – start reading products from current data row. (Most need if Excel or CSV have first
header row, then must set to 1).

CSV delimiter – Any character may be used to separate the values. In a comma-separated values (CSV) file the
data items are separated using commas as a delimiter.
Buttons:

Test source – will test source file download.
Vendor`s source data mapping to nopCommerce
General rules for XML mapping

You must fill “XPath uses path expressions to navigate in XML documents” input fields, where want to map
source value to nopCommerce product field.

Default value using rules:
o Replace null or empty value – if XPath (not)mapped value will be null or empty than will fill product
field with entered text in default value field;
o Add text to the end of XPath value – if default value begin whit symbol ‘+’ then default text will be
added to the end of XPath mapped value.;
o I you use text in brackets [xpath], then application will this understand as XPath. Example if you want
replace empty XPath with other XPath or concatenate multi XPath in one field;
XPath examples
https://msdn.microsoft.com/en-us/library/ms256086(v=vs.110).aspx
General rules for Excel or CSV mapping

You must fill “Source Column Index” input fields, where want to map source value to nopCommerce product
field.

Default value using rules:
o Replace null or empty value – if source column (not)mapped value will be null or empty than will fill
product field with entered text in default value field;
o Add text to the end of source field value – if default value begin whit symbol ‘+’ then default text will
be added to the end of source mapped value.;
o I you use number in brackets [number], then application will this understand as column index.
Example if you want replace empty source column with other source column or concatenate multi
source columns in one field;
Product info mapping
Picture 14 Product info mapping for XML
Picture 15 Product info mapping for Excel, CSV
Input fields:

Product repeat node – The name of the product root xml node in source file. This field is mandatory;

Product Id – The product identifier in vendors source file. This field is mandatory;

Product SKU – The product identifier in nopCommerce store. By this field will be search of existing products
in nopCommerce store (If exist, then product can be updated if not - inserted). This field is mandatory. If not
filled, then will by auto generated;

Product name – The name of the product;

Short description – The short description of the product;

Full description – The full description of the product;

Manufacturer part number – The manufacturer`s part number of this product;

Product cost – The cost of the product. This field value must be number;

Product price – The price for customer of the product. This field value must be number;

Stock quantity – The current stock quantity of this product.
SEO mapping
Picture 14 SEO mapping for XML
Picture 15 SEO mapping for Excel, CSV
Input fields:

Meta keywords – Meta keywords to be added to product page header;

Meta description – Meta description to be added to product page header;

Meta title – Override the page title. The default is the name of the product;

Search engine friendly page name – Set a search engine friendly page name e.g. 'the-best-category' to make your
page URL 'http://www.yourStore.com/the-best-category'. Leave empty to generate it automatically based on
the name of the product;
Category mapping
Picture 16 Category mapping for XML
Picture 17 Category mapping for Excel, CSV
Input fields:

Category(s) – Category(s) name. If categories are in repeat node, you can save there repeated node name (for
XML);

Category1 – Name of other category;

Category2 – Name of other category;

Category3 – Name of other category;

Category(s) – Name of other category;

Delimiter to split – If source value save multi categories in on field you can split it. Example: “women->shoes>ballets”. The delimiter would be there “->”
Manufacturer mapping
Picture 18 Manufacturer mapping for XML
Picture 19 Manufacturer mapping for Excel, CSV
Input fields:

Manufacturer – The manufacturer name of the product;
Pictures mapping
Picture 20 Pictures mapping for XML
Picture 21 Pictures mapping for Excel, CSV
Input fields:

Image(s) – URL(s) of image(s). If images URLs are in repeat node, you can save there repeated node name (for
XML);

Image1 – URL of other image;

Image2 – URL of other image;

Image3 – URL of other image;

Image4 – URL of other image;
Product attributes mapping
Picture 22 Product attributes mapping for XML
Picture 23 Product attributes mapping for Excel, CSV

Attributes repeat node – If attributes are in repeat node, you can save there repeated node name (for XML);

Attribute name – Name of the attribute;

Attribute value – Value of the attribute. The attribute name must be mapped;

Attribute stock – Stock by the attribute. The attribute name must be mapped;

Attribute1 name – Name of the other attribute;

Attribute1 value – Value of the other attribute. The other attribute name must be mapped;

Attribute1 stock – Stock by the other attribute. The other attribute name must be mapped;

Attribute2 name – Name of the other attribute;

Attribute2 value – Value of the other attribute. The other attribute name must be mapped;

Attribute2 stock – Stock by the other attribute. The other attribute name must be mapped;
Source data filter mapping
In filter mapping you can map any xml value to the filter. And later you can use these filters in tasks. For example if you
want to import products where their price are smaller than 50 or where brand is named Nike.
Picture 24 Filter mapping for XML
Picture 25 Filter mapping for Excel, CSV
Test source mapping
You can test the source mapping – press button “Test mapping”. Will open new windows with mapped items preview.
Picture 26 Test source mapping
NopTalk Manager – Tasks
After you has been created Vendor source mapping, now you can create multiple tasks for that Vendor source mapping..
For example:

The task for products filtered by category/manufacturer/or another filter - insert new products;

The task for products filtered by category/manufacturer/or another filter - just update
price/quantity/availability/attributes;
Tasks list
Picture 26 List of tasks
Filter:

Auto refresh list – if checked the task list will be auto refreshed every 5 seconds.
List fields:

Id – task identifier;

Store – Name of nopCommerce store;

Vendor – Name of vendor;

Task name – Name of task;

Task action – Action of task. Available values: insert, update;

Task status – Status of task. Available values: started, stopped; Started - mean that task will start when running
task scheduler, stopped – mean that task will not start;

Schedule type – Type of schedule. Available values: minutely, hourly, daily ;

Task last run – The date when task run last time;

Task next run – The date when task will run next time ;

Total items – Count of filtered items found in source data, when task run last time;

Exported items – Count of items imported to the nopCommerce store, when task run last time;

Task running – The task is now running;
Buttons:

Start task scheduler – Start schedule or stop schedule tasks on configured time.

Run now all tasks – Run now all tasks;

Cancel task – Cancel selected running task;

Run now task – Run selected task;

Insert – Insert new task;

Edit – Edit selected task;

Delete – Delete selected task;
Insert or update tasks.
Insert task
Picture 27 Insert new task data
Picture 27 Edit task data
Input fields:

Name – Task name; This field is mandatory;

Store – nopCommerce stores configured in Stores module; This field is mandatory;

Vendor source mapping – Vendor mapping configured in Vendors module; This field is mandatory;

Status – Task status. Available values: started, stopped. Started - mean that task will start when running task
scheduler, stopped – mean that task will not start. This field is mandatory;

Action – Action of task. Available values: insert, update. This field is mandatory;

Disable store while processing – Set nopCommerce store state as disabled when the task is running;

Limited to stores – List of nopCommerce virtual stores. You can select to which virtual store you want to store
product.

Unpublish product – If product in source not found then unpublish the product in nopCommerce. It works
only if the product was imported with current task;

Scheduler type - Types of scheduler. Available values: minutely, hourly, daily;

Scheduler interval – repeat interval for schedule task in minutes or hours;

Scheduler time – time to run tasks on daily scheduler type ;
Task mapping
On new task insert the default source mapping will be copied from vendor source mapping. Than you can configure
each task individual as you want:

You can change “Default value” of fields.

You can check which mapped fields you want to import to nopCommerce store (Checkbox “Fields to
import”).

You can configure Category relationships – set parent and child categories;

You can set some other product attributes like (values are selected from nopCommerce store):
o Delivery date;
o Manage inventory method;
o Product attribute types;

You can modify the price of product during import - e.g., add 21% to your supplier's pricing;

You can filter which items you want to import. Available filters operations:
o == (equal);
o <= (less or equal);
o >= (more or equal);
o != (not equal);
o %Like% (contains);
o %Like (starts with);
o Like% (ends with);

You can test mapping – items preview windows:
Picture 28 Task mapping – Product Info
Picture 29 Task mapping – SEO
Picture 30 Task mapping – Category
Picture 31 Task mapping – Pictures
Picture 32 Task mapping – Attributes
Picture 33 Task mapping – Filters
Picture 34 Task mapping – test mapping
NopTalk Manager – Logs
In this module you can view all logs messages. There are logged:

Tasks results;

Error messages;

Warning messages;
Logs and reports
Picture 35 Logs list
Filters:

Date from – Log message date from;

Date to – Log message date to;

Auto refresh list –if checked the logs list will be auto refreshed every 5 seconds;
Buttons:

Clear logs – Delete all logged messages;
NopTalk Manager - System Tray
You can minimize NopTalk application to System Tray.
Picture 35 Minimize to system tray.