Error and Performance Troubleshooting Checklist
Description
You get a runtime error on mobile related to Business Central or experience bad performance.
Checklist
Step 1: Is it a known error message?
See Error Messages.
Note: Errors caused by extensions other than Mobile WMS and Microsoft, will have (Extension Name - Publisher) added to the end.
Step 2: Inspect the Callstack and "Mobile Document Queue"
See View Request and Response XML and Error Call Stack
The call stack points to the code where the Error happens.
This code is not necessarily the source of the error - but it is still valuable information that we need to know.
The call stack is included in the XML 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 setup data?
Have you changed extension code?
Has Mobile WMS extension been updated?
Has the area been changed in recent releases? See Release Notes (Business Central)
Has Business Central been updated?
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 code. Do you have other extensions installed?
Try uninstalling them temporarily.
Consider doing this in a sandbox (step 6) to avoid disrupting the business.
Go to: Extension Management > Select extension > Select the three dots > Select Uninstall
Reproduce the issue. Has the issue changed?
Step 4.2: Use "Code Coverage" to identify Partner customization
Go to Code Coverage.
Select Start
Provoke the Error/Issue
Select Stop
Inspect the result for non-base object IDs e.g. 50100 Note: Mobile WMS objects are numbered 6181271-6182270, so ignore them
Step 4.3: Use "Event Subscriptions" to identify Partner customization
There are two ways to view active Event subscribers to Mobile WMS.
Method 1:
Go to Mobile Document Queue List. Select Troubleshooting, > Event Subscriptions
Method 2: Go directly to the "Event Subscriptions" page by adding ?page=9510 to your URL.
Example:
Example with filters:
https://businesscentral.dynamics.com/TenantID/SandboxOrProd/?page=9510&filter='Publisher Object ID' IS '6181271..6182270' AND 'Subscriber Codeunit ID' IS '<6181271|>6182270'
This only shows subscribers to Mobile WMS.
Remove the filter to view subscribers to standard posting events or database triggers.
Step 5: Do you have the correct User Permissions?
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 Debugging
Step 8: Troubleshoot performance using Profiler
See Performance Profiler (AL Profiler)
Also, when dealing with slow performance on BC Online, consider raising a Support Case with Microsoft, directly from Business Central.
See also