Monitoring and queueing

Commerce 365 brings you real-time integration between Business Central and Magento. In order to accomplish this, the extension comes with an integration mechanism that runs in the background. Highly simplified this mechanism monitors all relevant changes in your database. This can be a direct change of an item description, but also the creation of a new sales or purchase order that might influence the available inventory. Anything that might lead to an update of the Magento webstore is first queued and then processed by the integration mechanism.

We absolutely don't want the integration mechanism to be something which mysteriously runs in the background as some kind of magic component. It can do just that. And once you are in production mode, we would advise to switch to automatic processing of the integration mechanism. But, at the same time we offer you full control and transparency. 

Go to Integration > Queue to see which data is currently queued for synchronization.

When running in manual sync mode (more info below) the queue shows exactly what has happened in your system and therefore got queued. To synchronize the data just click on the Synchronize Queue button. The system will then process the whole queue. 

When debugging or when testing something specific it might be that you quickly want to synchronize a single record. For this you can use the Synchronize Selected button. 

Manual or automatic mode

Synchronizing data in Commerce 365 can be done either manually or automatically. If you want to switch to automatic mode, you can activate a job queue task which will automatically take care of all synchronization work. Click on the button Job Queue Settings to open the list of job queue entries. During the installation of Commerce 365, two new entries (tasks) were added to this list. 

By default these entries are place On Hold, but you can edit these entries, alter their settings, and then active to run these tasks according to your desired schedules. Most of the time you are just fine running these tasks every one or two minutes.  

If you want to switch to manual mode again, set these job queue entries to On Hold.

The job Commerce 365 Sales Order Synchronization is for all inbound data, which will consist of sales order and optionally newly registered customers. 

The job Commerce 365 Content Synchronization is for all outbound communication. 

Errors

Sometimes there are reasons why a record cannot be synchronised. By default the system will retry to synchronize 5 times. This is to prevent immediate hiccups when for example your Magento system was rebooted and therefore was not accessible for a minute or two. But after 5 times, these records are moved to the Errors list. In this list you will find the exact error message, and you can click on Show Details to jump directly to the corresponding detail page for a specific record. Correct the problem, close the page, and click on Retry to place any selected record(s) back in to the queue for processing.

Log

After you have to enabled logging on the general setup page, you will find all the details on what the integration mechanism is doing in this list. Click on the Entry No. to see the full details on what was sent.

If you want to see what data has been processed by the integration mechanism go to Integration > Log. Here you’ll find a list of every synchronization task that was executed, including the data object details. Click on Entry No. to view that data. 

If the list is empty, go to Administration > Setup to enable logging. Click here for more details. (See Logging paragraph)