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, six 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.
In order to activate them you need to know what they are actually doing, this is described per Job Queue below.
Commerce 365 Content Synchronization
is for all outbound communication.
Commerce 365 Bulk Inventory Synchronization
This will synchronize all inventory records via the magento bulk inventory api
Commerce 365 Price Updates
This will make sure all prices and price lists with from and to dates will be recalculated and send to magento.
Commerce 365 Sales Order Synchronization
is for all inbound data, which will consist of sales order and optionally newly registered customers.
Commerce 365 Job Queue Health Check
This checks if all of the Commerce 365 Job Queues are running, if they are in error mode this Job Queue will restart the Job Queue in error mode.
Commerce 365 Log Cleanup
This Job Queue will delete all records from the Integration log.
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)