Problem
You get a runtime error on mobile with an error message from Business Central.
...
Step 2: Inspect the Callstack and "Mobile Document Queue"
See View Request and Response XML and Error Call Stack
The callstack points to the code where the Error happens.
Note: This 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 which is found in the Mobile Document Queue. See How-to: Inspect Request Response XML and Error Call Stack
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)
- 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 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.
- 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 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?
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) | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...