Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

Description

Excerpt

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

  • 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) and you can troubleshoot many issues.

Image Added

Column
width11

Overview

Table of Contents
maxLevel2
minLevel2
excludeOverview|Description|Use Case

...

...

Image Removed

Use Cases

  • 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

Mobile devices communicate with Business Central using XML data.

Image Added

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

  1. Mobile initiates communication with a Request

  2. Business Central generates a Response

Image Removed

Mobile Document Queue List-page

To open the page, search for "Mobile Document Queue" in Business Central.

...

Image Added

Filtering the queue

You can filter the list using:

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.

View 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

...

Image Added

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 fields like "MyDate" and "MyText".

Request example
Code Block
languagexml

...

...

<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>
..

View Mobile Registrations

These registrations result from mobile users performing order line registrations, step by step. See  Receiving Order Lines.

To view 

  • Select Document > Show Registrations

...

Image Added

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.

Image Modified

View Mobile Device Properties

Example of Mobile Device Properties

To view Mobile Device Properties:

  1. Select "Device ID" value

  2. Select "Open Full List"

...

  1. Image Added


  2. Select "No. of Properties" value

...

  1. Image Added


     

  2. A new page will display the available properties for this mobile device.

...

  1. Image Added


    Note:

...

  1. The installed Mobile App Version is shown in the "Version" property