Mobile Document Queue
This document relates to the new version of the Mobile Document Queue page introduced in MOB 5.62.
The new Mobile Document Queue page is only available for BC 25.0 and newer.
For versions BC 24.0 and older please refer to the legacy https://taskletfactory.atlassian.net/wiki/x/FbK0B
Description
The Mobile Document Queue page serves as the central hub for monitoring and troubleshooting communication between mobile devices and Business Central.
It displays all requests received from mobile devices and the corresponding responses sent back from the backend system.
This page facilitates troubleshooting issues and customization development.
Mobile Document Queue Page
Main List View
The main repeater displays document queue entries with the following information:
Field | Description | For more details |
|---|---|---|
Created Date/Time | When the request was received from the mobile device. |
|
Mobile User ID | The user who sent the request from their mobile device. | |
Document Type | Type of document for the incoming request. | |
Registration Type | Sub-type used for specific documents, like Lookup and Ad hoc registrations. The field can also hold additional context information, such as “Item No.” and “Quantity”. |
|
Status | Current processing status (New, Processing, Completed, Error). |
|
Processing Duration | Time taken to process the request. |
|
Device ID | Unique identifier of the mobile device. | |
Message ID | Unique identifier for the request/response pair. |
|
Request and Response Viewers
Below the list, the page displays two side-by-side panels:
Request Panel: Shows the XML content received from the mobile device.
Click the highlighted header to download the request as an XML file.
Response Panel: Shows the XML content sent back to the mobile device.
Click the highlighted header to download the response as an XML file.
Factboxes
Two factboxes provide additional context:
Details Factbox: Shows detailed information about the selected entry.
From the Related Entries section, you can navigate to the related entries.
Registrations Factbox: Displays a simple view of registrations linked to the selected entry.
From here, you can open a list of all registration details via the Open Overview action.
Available Views
Use the built-in views to quickly filter entries:
Not Completed: Shows all entries except those with status Completed
Error: Shows only entries with errors (status = Error)
Processing: Shows entries currently being processed (Status = Processing)
New: Shows new, unprocessed entries (Status = New)
Completed: Shows successfully completed entries (Status = Completed)
Actions Overview
Action grouping:
Processing: In the Processing group, you find actions related to processing the selected document queue entries.
Document: In the Document group, you find actions to download the XML files or open the Mobile Registrations list.
Troubleshooting: In the Troubleshooting group, you find actions related to troubleshooting and performance analysis of the document queue entries.
Action | Description | Group |
|---|---|---|
Refresh | Reload the list to show newly received requests. |
|
Process Selected (F10) | Run the processing code for the selected documents (requests). Info: Documents must have a status of New or Error to be processed. | Processing |
Reset Selected (F9) | Reset the selected documents to status New so they can be reprocessed. Warning: Be careful when resetting Post-requests in production companies, as the reprocessing may lead to duplicate postings in your system. | Processing |
Delete Selected | Delete the selected documents from the Mobile Document Queue. | Processing |
Download Request | Download the request as an XML file. | Document |
Download Response | Download the response as an XML file. | Document |
Show Registrations | Opens a list with all details about the registrations associated with the document queue entry. Note: Mobile WMS Registrations are only created when Planned Functions are posted. | Document |
Process with Performance Profiler (Ctrl+F10) | Process selected entries while capturing detailed performance data. Profiler data files are automatically downloaded to your Downloads folder, and Performance profiler entries are created in the system. | Troubleshooting |
Show Performance Profiler Entries | View performance profiler data for selected entries. | Troubleshooting |
Event Subscriptions | View a list of objects that subscribe to any of the Mobile WMS events. | Troubleshooting |
Tweaks | View a list of tweaks to the Mobile WMS configuration. This will show any tweaks that are applied from the backend | Troubleshooting |
Legacy Document Queue List | Access the older version of the Document Queue page. Note: The legacy page will become obsolete in future versions. | Navigation |
Mobile WMS Registrations
Mobile WMS Registrations are created when mobile users have processed order lines, and the posting request is processed in Business Central.
Note: Mobile WMS Registrations are only created when Planned Functions are posted.
Unplanned Functions do not generate Mobile WMS Registrations.
In the example below, three different items were received:
TF-002 without tracking.
TF-003 with Lot No. tracking.
TF-004 with Serial No. tracking.
All registered details (quantities, units, action type, etc.) can be inspected in the list.
How to View Mobile WMS Registrations
The Mobile WMS Registrations List can be accessed in the following ways:
Action Ribbon: Document > Show Registrations (list filtered to related registrations)
Registrations Factbox: Open Overview (list filtered to related registrations)
Details Factbox: Related Entries > Drill down on Registrations count (list filtered to related registrations)
Search Feature (Alt+Q): Opens the page without filters, showing all existing registrations
Mobile Device Properties
During login, a mobile device sends device-specific information to the backend, including:
Mobile App Version
Manufacturer
Model
Language Culture Name
Regional date, time, and number formatting (see Mobile Language)
How to View Mobile Device Properties
From the Mobile Document Queue page, you can navigate to the properties for a specific device.
When selecting the Device ID value in the list a few details about the device is displayed.
Open full list to view more information about the device.
From here, you can navigate to all the properties sent from the device in the GetReferenceData request by drilling down in the No. of Properties field.
Tip: The Mobile Devices list can also be accessed by using the Business Central Search feature (Alt+Q)
Note: Device properties are updated with each login. Therefore, the properties are not related to individual document queue entries and do not indicate which properties were in effect at the time of the request.
Info
The Device ID corresponds to the Hardware Serial Number in MobiControl.
Common Workflows in Mobile Document Queue Page
Investigating Errors
Identify and select the entry you want to investigate.
Review the Request and Response XML in the lower panels.
Check the Details factbox for additional information.
Use "Download Request" or "Download Response" when you need to share with support.
Reprocessing a Request
Identify and select the entry to reprocess.
Click "Reset Selected" (F9) and confirm.
Click "Process Selected" (F10) to reprocess.
Monitor the result of the processing.
Warning: Don't reset and reprocess post-related requests in production environments (risk of duplicate posting).
Tip: Entries with status New or Error can be processed. Error entries do not need to be reset first.
Additional info:https://taskletfactory.atlassian.net/wiki/x/jrK0B
Troubleshooting Custom Behavior
Inspect Event Subscriptions
Click "Event Subscriptions" to see what custom code is active.
Review the subscriber codeunits listed.
Use this information to understand why the system may behave differently than expected.
Additional info: Use "Event Subscriptions" to identify customizations
Inspect Configuration Tweaks
Click "Tweaks" to see any configuration overrides and additions.
Review the tweaks listed.
Use this information to understand why the system may behave differently than expected.
Additional info: https://taskletfactory.atlassian.net/wiki/x/UQCOC
Performance Analysis
Use https://taskletfactory.atlassian.net/wiki/x/la20B to analyze the performance of time-consuming processes. Monitor the "Processing Duration" field to identify performance bottlenecks.
Switch Performance Profiler on for specific Mobile Document Types or Mobile Users to collect performance data for incoming requests in 15 minutes. Alternatively, use "Process with Performance Profiler" to easily re-process requests directly from the document queue.
Warning: Don't reset and reprocess post-related requests in production environments (risk of duplicate posting).
In this article
Navigation