Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Description

Logs and displays the communication between the Mobile Device and Business Central. The entries are called "mobile documents" or "Requests".


The Mobile Document Queue displays the exact data sent back and forth and is essential if you need to track down specific scenarios, i.e., if a user experiences an issue. Combine this with access to the mobile device (using MobiControl) and you can troubleshoot many issues.

Developers will use the Mobile Document Queue during the development of customizations.


 

Overview

Use Case

  • An administrator can:
    • review 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

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. Mobile device will initiate the communication with a Request
  2. Business Central generates a Response





Mobile Documents with Status "Error"

If a mobile document processing fails, it gets Status "Error".

What causes errors

  • Invalid inputs from the mobile user 
  • "Source document" was changed, or processed by another user
  • You are testing customizations during the development


Reprocessing Mobile Documents / Start Debugging

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

  • Processing never changes the request.
    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 can use this reprocessing for debugging your customization. 

"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)


  • No labels