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

A developer can:

• Inspect XML values and know whether AL code has taken effect
• 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  

1. It is always the Mobile device that initiates the communication with a Request
2. Business Central generates a Response

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)