When you make a change in Business Central, Tinx Connector detects it through a trigger on the relevant message definition. For example, publishing a new item to the webshop triggers the relevant outbound message definition. The trigger captures the change and adds it to the Record Queue page as a new entry. From there, the Tinx NAS Outbound Mgt. job queue picks up those entries and sends them to your webshop. The Record Queue page is the step between a change occurring in Business Central and its publication on your webshop.
Workflow
The following image shows this process for a new item published to the webshop.
The Record Queue page lists all changes made in Business Central that are waiting to be processed and sent to your webshop. Check this page when:
- A change isn’t visible on the webshop yet. You updated an item, customer, or price in Business Central, but the change hasn’t appeared on your webshop.
- You want to see what’s being processed. Check how many outbound changes are waiting to be synchronized and where your change is in the queue.
- You want to check processing status. Changes are either waiting to be processed or currently being processed (shown in the Processed By field). Already completed changes are automatically deleted.
The Record Queue page contains only outbound messages. These are changes originating in Business Central that are sent to your webshop. Inbound messages, such as webshop order imports, don’t go through the Record Queue page.
In rare cases, changes published from Business Central to your webshop are sent shortly after being added to the Record Queue page. You might not always be able to see them in the queue. Always check the Synchronisation Ledger Entries page to ensure the change has been processed. For more information, see Synchronisation Ledger Entries.
When a task is complete, Tinx Connector automatically deletes the related record queue entries. You can find the processed entries on the Synchronisation Ledger Entries page.
If your webshop is temporarily unavailable, entries remain on the Record Queue page until the connection is restored. No changes are lost.
Processing entries in the record queue
Entries in the record queue are processed differently depending on the job queue and synchronization dashboard setup. The following procedures explain the three different processing scenarios.
To review entries that are processed automatically in the record queue
If the TINX NAS Outbound Mgt job queue is set to Ready and the appropriate synchronization dashboard is set to On Timer: Entries added to the record queue are automatically processed at regular intervals. You can review the entries on the Record Queue page only right after you make the change in Business Central.
- Select Search (Alt+Q) in the upper-right corner, enter Record Queue, and then choose the related link.
- On the Record Queue page, review all entries added by all users that are waiting to be processed. Processed entries are automatically deleted from the Record Queue page.
- To review the processed entries, on the action bar, in the History group, select the Sync. Ledger Entries action. For more information, see Synchronization ledger entries.
To manually process all entries in the record queue
If the TINX NAS Outbound Mgt job queue is set to On Hold or the dashboard is set to Manual, the entries remain on the Record Queue page until you manually process them.
- Select Search (Alt+Q) in the upper-right corner, enter Record Queue, and then choose the related link.
- On the Record Queue page, on the action bar, in the Home group, choose the Process all Records action. This sends all the entries to the webshop immediately.
To manually process selected entries in the record queue
If you want to process only specific entries rather than all entries, use filters to narrow the record queue before processing.
- Select Search (Alt+Q) in the upper-right corner, enter Record Queue, and then choose the related link.
- Select Filter (Shift+F3) at the top of the list, to open the filter pane.
- In the filter pane, set up the filters to show only the entries you want to process.
- On the action bar, in the Home group, choose the Process Filtered Records action. This sends only the filtered entries to your webshop.
Processing order
After entries are added to the Record Queue page, you cannot change their processing order. To control which changes are processed first, set the priorities on the Synchronisation Dashboards page before the jobs run. The Priority field on a dashboard determines the sequence in which dashboards are processed. You can also define priorities for individual messages on the Synchronisation Dashboard page. For more information, see Synchronisation Dashboards.
Partial queue
When you process large catalog updates (such as changing 1,000 prices), incoming webshop orders get stuck in a waiting state. Customers place orders, but they don’t show up in Business Central for a long time. The partial queue breaks large updates into smaller batches, for example, 30 changes at a time. Instead of processing all 1,000 price changes at once, the partial queue processes 30 changes and lets new orders come in. It then processes another 30 changes. Your catalog updates take longer to complete, but new orders are imported faster. Enable this if you regularly make bulk product updates or experience busy periods such as Black Friday.
To enable partial queue
-
Select Search (Alt+Q) in the upper-right corner, enter E-Commerce Integration Setup, and then choose the related link.
If you don’t find E-Commerce Integration Setup in Search, change your role in Business Central to TINX E-Com Admin. Then on the Role Center page, select Setup, and then choose E-Commerce Integration Setup.
On the General FastTab, turn on the Enable Partial Queue toggle.
-
In the No. Of Records To Process field, enter the number of records to process per minute.
Set this value based on how often the job queue runs. For example, if the job queue runs every minute, Tinx Connector can typically process 50 records in that time, but 100 records may be too many to complete before the next run starts.
Related information
Job queues
Synchronization
dashboards
Synchronization ledger
entries
Key concepts in Tinx
Connector
Troubleshooting checklist