Scheduled Tasks

Sana Commerce 9.3
Your connector

Customer Import

The Customer import task is used to retrieve and update all customers, contacts and sales agents from your ERP system. You can set up the task to index only those accounts which you need.

When the customers are indexed, you can create the shop accounts in Sana Admin for those customers that already exist in your ERP system. For those customers who register online in the Sana web store, the customer records will be created automatically in the ERP system, and shop accounts in Sana. Those customers and sales agents who have shop accounts can purchase online using the Sana web store.

For more information about how to create shop accounts in Sana Admin, see "Shop Accounts".

 NOTE

When Sana is installed and connected to your ERP system, you will need to run the Customer import task to retrieve all customers from your ERP system to be able to create the shop accounts.


Update Index vs. Rebuild Index

By default, when you click Start, the Customer import task will update the customer index, but there is the alternative option - Rebuild index.

  • Update index - checks whether some customer data has been modified in the ERP system and synchronizes the changes with Sana. This is the default action when you click Start. You must update the customer index, when you changed some customer data in the ERP system.

  • Rebuild index - retrieves all customers, contacts and sales agents from ERP. Rebuilding the customer index removes the previously created index and creates the new one. You must rebuild the customer index only when you changed some global settings which might influence all customers, for example:
    • Set up web store filters for the customers, contacts or sales agents in ERP.
    • Set up data validation rules for the customers, contacts or sales agents in ERP.
    • Change the default currency in ERP.
    • Change the company in ERP the Sana add-on is assigned to.
    • Upgrade Sana to the new version. This is optional, but might be useful to make sure that everything is fine after upgrade, especially when you upgrade to the major version.

When you change customer, contact or sales agent data in the ERP system, the value of the Last date/time modified field will be updated with the current date and time. Based on this, when you run the Customer import task, Sana will check whether some data has been changed since last indexing, then it will update the customer index and apply the changes to the web store.

Set up the "Customer import" task

To set up the Customer import task, click Edit.

The table below provides the description of the Customer import task settings:

Settings Description
Run on schedule Use this option to enable automatic running of the customer import task according to the configured schedule, or disable it to allow only manual start of the task.

If you enable Run on schedule, you should enter either the interval in minutes when the task should run automatically or the fixed time.
Run interval (in minutes) Enter the time interval in minutes when the task should run automatically.
Run time

Enter the fixed time when the task should run automatically. For the fixed time, the time of the server is used.

Send e-mail to administrator when task has failed Use this option to enable or disable e-mail notifications when a scheduled task fails.

If the scheduled task has failed, the webstore administrator receives an e-mail with the name of the task that failed, the name of the webstore, which is useful in case you have several webstores, when the task failed, and the error message. Thanks to this, the webstore administrator can quickly respond to problems with data synchronization.

Batch size Enter the quantity of customers that should be handled in one batch.
Maximum interval between retries (seconds) Enter the maximum interval between retries. When some customers cannot be indexed for some reason, the task will make another attempt during the specified time interval.
Maximum retries count Enter the maximum retries count. When some customers cannot be indexed for some reason, this value specifies how many times the task should try to index them again.
Maximum items to skip before failure Enter the maximum items to skip before failure. When some customers cannot be indexed for some reason, this value specifies how many customers can be skipped before the task will fail.
Maximum archived log files Enter the maximum number of log files to store. If this number exceeds, the oldest log file will be removed and the new one will be created.
Index customers This option is used to index customers from the ERP system.
Index contacts This option is used to index contacts from the ERP system.
Index sales agents This option is used to index sales agents from the ERP system.

 

See also:

How Customers Are Synchronized between Sana and Microsoft Dynamics NAV
How Customers Are Synchronized between Sana and Microsoft Dynamics AX
How Customers Are Synchronized between Sana and Microsoft Dynamics 365 Business Central
How Customers Are Synchronized between Sana and Microsoft Dynamics 365 Enterprise Edition