Debugging

Owned by Johannes Sebastian Nielsen
Last updated: Sept 06, 2024 by Rawn Hornsby
2 min read

Description

During AL development or if you need to track down a specific issue, you can debug using the Mobile Document Queue List in Business Central.


Use Case

  • A developer can:
    • Inspect XML values
    • Reprocess failed mobile documents and initiate debugging
    • Inspect Error Call Stack

What causes Mobile Documents to get error status 

  • Invalid inputs from the mobile user 
  • "Source document" was changed, or processed by another user
  • Testing AL development


Reprocessing Mobile Documents / Start Debugging

You can reprocess failed mobile documents from the Mobile Document Queue List in Business Central.

  • You cannot modify the original request.
  • The current User is used to execute the code. Instead of running as the web service, the code will be executed in the context of "you", the currently logged-in user.
  • You must Reset a document before reprocessing

"Reset Documents"-action

Go to the "Mobile Document Queue"-page.

  1. Select a document with Status "Error"
  2. Select Process >  Reset Documents

"Process Documents"-action

  1. Perform "Reset Documents" first
  2. Select Process >  Process Document


Viewing the "Error Call Stack"

If a mobile document fails to process, the error call stack can be viewed.

Processing from mobile failed

The error call stack is written to the Response XML.


Reprocessing from Mobile Document Queue

When you reprocess from the mobile document queue you will see the error on-screen.



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