Versions Compared

Old Version 76

changes.mady.by.user Johannes Sebastian Nielsen

Saved on

compared with

New Version 77

changes.mady.by.user Johannes Sebastian Nielsen

Saved on

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.

Overview

Table of Contents
maxLevel2
minLevel2
excludeOverview|Description|Use Case

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:

  1. Mobile initiates communication with a Request

  2. Business Central generates a Response

Mobile Document Queue List-page

Search for "Mobile Document Queue" in Business Central.

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.

Inspect XML Request and Response

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

Tip

Tip: You can search the data using the browser "Find function", CTRL+F.

image-20241004-120356.png

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

  • Select Document > Show Registrations

Image Removed

Note: Mobile Registrations are only used with Planned Functions.

Unplanned

functions do not utilize order lines.

Functions does not have mobile registrations

Image Added

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 Removed
Image Added

View Mobile Device Properties

Example of Mobile Device Properties

To view Mobile Device Properties:

  1. Select "Device ID" value

  2. Select "Open Full List"


  3. Select "No. of Properties" value


     

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


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