Mobile Document Queue List

Logs and displays the communication between the Mobile Device and Business Central.

Description

The entries are called "mobile documents" or "Requests".
Inspect the data sent back and forth so you can track down issues
Developers will use the Mobile Document Queue during the development of customizations

Combining the document queue with access to the mobile device (using MobiControl), you can troubleshoot many issues.

Overview

1 Request and Response
2 The Mobile Document Queue List-page
3 Inspect XML Request and Response
4 Mobile Registrations (planned functions only)
5 Mobile Device Properties

Use Cases

An administrator can:
- review how 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

Mobile devices communicate with Business Central using XML data.

The XML contains the required instructions for Business Central to perform:

Mobile initiates communication with a Request
Business Central generates a Response

The Mobile Document Queue List-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.

Inspect XML Request and Response

Two large text fields displays the current entry's Request and Response XML.

Tip: You can search the data using the browser "Find function", Ctrl+f

How to download the XML

Select Document > Show Request XML
Select Document > Show Response XML

Example of Request XML

Request is likely the most interesting for development. The request will give you an overview of which values their names.
E.g. this is a request for an Unplanned Function called "MyUnplanned with custom fields like "MyDate" and "MyText".

Request example

<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">
    <MyText>2</MyText>
    <MyDecimal>4</MyDecimal>
    <MyDate>14-02-2020</MyDate>
    <RegistrationType>MyUnplanned</RegistrationType>
..

Mobile Registrations (planned functions only)

These registrations result from mobile users performing order line registrations,

How to view Registrations

Select Document > Show Registrations

Note: Mobile Registrations are only used with Planned Functions.
Unplanned Functions does not have mobile 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

Mobile Device Properties

Mobile devices report device-specific information during login, for example:

Mobile App. Version
Manufacturer
Model
Language Culture Name
- Regional date, time, and number formatting. See Mobile Language

How to view Mobile Device Properties

Select "Device ID" value
Select "Open Full List"
Select "No. of Properties" value

You can now inspect the properties of this mobile device.

Note: The installed Mobile App Version is shown in the "Version" property