Description
Logs and displays the communication between the Mobile Device and Business Central. The entries are called "mobile documents" or "Requests".
- You can view the data sent back and forth, Ths is essential if you need to track down a specific issue
- Combine this with access to the mobile device (using MobiControl) and you can troubleshoot many issues
- Developers will use the Mobile Document Queue during the development of customizations
Overview
Use Case
- An administrator can:
- review Mobile WMS is used
- inspect active Mobile Devices and their properties
- A developer can:
- Inspect XML values
- Reprocess failed mobile documents and initiate Debugging
- Inspect Error Call Stacks
Request and Response
When the mobile device communicates with Business Central, an XML document is sent to the system.
The XML contains the required instructions for Business Central to perform
- Mobile initiates communication with a Request
- Business Central generates a Response
Mobile Document Queue List-page
To open the page, search for "Mobile Document Queue" in Business Central.
Filtering the queue
You can filter the list using:
- the predefined fields for
- Mobile Document Type
- Mobile User
- processing "Status"
- or regular page filters e.g. filter by "Created Date/Time"
Document Type
The Mobile Document Type is displayed here.
Registration Type
Additional context information.
For example, Unplanned Move will display the "Item No." and "Quantity" that was handled.
Processing Time
The time it took Business Central to process this Mobile Document.
Viewing XML Request and Response
Two large text fields display the current entry's Request and Response XML.
You can search the data using the browser "Find function", CTRL+F.
Download the XML
- Select Document > Show Request XML
- Select Document > Show Response XML
Example of Request XML
The request is likely most interesting for development. The request will give you an overview of which values are available to you and what they are named.
Here are a number of fields i.e. "MyDate", "MyText" visible in a request for an Unplanned Function named "MyUnplanned".
<?xml version="1.0" encoding="utf-8"?> <request name="PostAdhocRegistration" created="2020-02-14T15:24:24+01:00" xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Request"> <requestData name="PostAdhocRegistration"> <MyDate>14-02-2020</MyDate> <MyText>2</MyText> <MyDecimal>4</MyDecimal> <MyDateStep>14-02-2020</MyDateStep> <MyTextStep>2</MyTextStep> <MyDecimalStep>4</MyDecimalStep> <RegistrationType>MyUnplanned</RegistrationType> </requestData> </request>
Viewing Mobile Registrations
These registrations are the result of the mobile user performing order line registrations, step by step. See Receiving Order Lines.
To view
- Select Document > Show Registrations
Note: Mobile Registrations are only used with Planned Functions. Unplanned functions do not utilize order lines.
Example of Registrations
This is an example of receiving three items.
- One item is using Lot no. tracking and another Serial no.
- All the registered quantities, units, actions, etc. can be inspected.
Viewing Mobile Device Properties
- Manufacturer
- Model
- Language Culture Name (See Mobile Language)
Example of Mobile Device Properties
To view Mobile Device Properties:
- Select "Device ID" value
- Select "Open Full List"
- Select "No. of Properties" value
- A new page will display the available properties for this mobile device.
Note: The installed Mobile App Version is shown in the "Version" property