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

During development, you may need to:

• Inspect the values are available in the XML request you are reading
• Know whether your code has taken effect

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)