Page Comparison

Problem

You get a runtime error on mobile with an error message from Business Central.

...

You experience bad performance

...

Checklist

Step 1: Is it a known error message?

See Error Messages

Step 2:

...

Inspect the Callstack and "Mobile Document Queue"

See View Request and Response XML and Error Call Stack

The callstack points directly at to the code where the Error happens.

This is VERY helpful.The code is not necessarily the source of the error can be:

...

- but it is still valuable information that we need to know.

The call stack is included in the error XML response and in the Mobile Document Queue.

• See How-to: Inspect Request Response XML and Error Call Stack 

The Request /Response shows also what data was exchanged between Mobile and BCXML Response. 

Note: Tasklet support might also be able to see a limited Callstack using "Telemetry".

Step 3: Has the system been updated lately?

• Have you changed setups?
• Have you changed any extension code?
  
  
• Has Mobile WMS extension been updated?
  • Has the area been changed in recent releases? See Release Notes (Business Central)
    
• Have you changed any extension code?
• • 
    
• Has Business Central been updated?
  Have you changed setups?
  • Search BC Release Notes for the error message 

  Step 4.1:

  ...

  Identify and Uninstall third-party extensions including Partner customization

  Partners extend Mobile WMS with their own code. Do you have other extensions installed?

  Try uninstalling them temporarily  temporarily.

  Consider doing this in a sandbox (step 6) to avoid disrupting the business.

  • Go to: Extension Management
  • Select an extension
  • Select the three dots
  • Select Uninstall
  • Does the issue change?

  Step 4.2:

  ...

  Extensions can affect the system through event subscribers,

  Check for any  

  ...

  Use "Code Coverage" to identify Partner customization

  Go to the "Code Coverage" -page.

  1. Select "Start"
  2. Provoke the Error/Issue
  3. Select "Stop"
  4. Inspect the result for non-base object IDs e.g. 50100 
     
     Note: Mobile WMS objects are numbered 6181000-6182250, so ignore them

  Step 4.3: Use "Event Subscriptions" to identify Partner customization

  Go to the "Event Subscriptions" -page by :

  ...

  adding ?page=9510 to your URL

  ...

  .

  Example: https://businesscentral.dynamics.com/TenantID/SandboxOrProd/?page=9510

  Example with filters: https://businesscentral.dynamics.com/TenantID/SandboxOrProd/?page=9510&filter='Publisher Object ID' IS '6181000..6182250' AND 'Subscriber Codeunit ID' IS '<6181000|>6182250'

  Please note that the filtered view displays only subscribers to Mobile WMS events. However, a request may also trigger other partner subscriber functions that are linked to standard Business Central events, such as posting events or database triggers related to standard BC tables.

  Step 5: Do you have the correct User Permissions?

  See User Permissions (3/10)

  Step 6: Is it isolated to one order or any order?

  • Is it a single document that cannot be processed?
  • Can you reproduce the issue by creating new documents? (Using a sandbox, step 3)

  Step

  ...

  7: Reproduce the issue in a "Sandbox" (copy of the production)

  With a sandbox you can:

  • Avoid disrupting the customer's business
  • Change data to check whether the issue changes
  • Disable/Enable extensions and check if issue changes
  • Debug code, see Debugging Cloud sandbox  
     

  Step

  ...

  8: Troubleshoot perfomance using Profiler

  See Performance Profiler (AL Profiler)

  ...

  Filter by label (Content by label)
  showLabels false max 555 spaces TFSK showSpace false sort modified reverse true type page excludeCurrent true cql label = "troubleshooting" and label = "bc" and space = "TFSK" labels MobiControl lockdown locked administrator

  ...