How-to: Use Mobile Document Queue to Inspect XML, Error Call Stack and Debug

Description

Use the document queue to inspect the XML data being sent to and from the Mobile devices. Also, error call stacks can be found here.

Overview

Use case

When development it can be very useful to inspect the XML to know:

• Has the code taken effect?
• Which values are available in the request you are reading

Flow

1. It is always Mobile that initiates the communication with a Request
2. Business Central is always the responding party

Inspect Mobile XML Communication

Go to the "Mobile Document Queue"-page.

• Select Document 
  1. Select Document > Show Request XML
     or
  2. Select Document > Show Response 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.

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

Inspect Error Call Stack and Debug

When a request ends in Status: Error, it will remain so until it succeeds. Subsequent attempts from mobile will only attempt to re-process this original request.

You can use this to inspect the Call stack and initiate debugging.

Go to the "Mobile Document Queue"-page.

• Select the latest Document with Status = Error
  
• Select Document > Show Response XML
  or
• Select Process >  Process Document

You can also re-run the process and get the error on the screen

1. Select Process >  Process Document
   
   
   
2. Select "Copy Details"
   
   
3. Paste the text into a Text Editor like "Notepad" (Ctrl+V)