Troubleshooting in the client

Path: Development > Troubleshooting > Troubleshooting in the client · tier official · system development · narrative reviewed (checked by Opus)

Overview

This section collects tools and pages that help developers, administrators, and advanced users diagnose problems from within the Business Central client. They fall into a few groups: diagnosing errors and performance, examining data and the database, and adjusting what users see and can do.

Key points

• Understanding the error dialog explains the Copy Details section, AL call stacks, and the Application Insights session ID for investigating user errors.
• Performance Profiler subtopic: record and analyze business process performance, read call trees, schedule profiling for specific users and activity types, and share or download profiles.
• Inspecting pages shows page design, elements, and data sources, with Visual Studio Code integration and permission control.
• View Database Locks shows a snapshot of current locks to troubleshoot transaction blocking, and View table information shows record counts, data and index sizes, and compression types.
• Missing indexes uses SQL Server Dynamic Management Views to suggest equality, inequality, and include columns.
• Analyzing report data with Excel and XML exports report datasets, metadata, and filter information as data-only Excel or XML.
• Events discoverability uses the Event Recorder to capture events during a scenario and produce AL snippets for subscribers.
• Personalizing the workspace, customizing pages for roles, defining granular permissions with security filters, and fixing on-premises mobile app issues (icon fonts, device date, client type errors) are also covered.

Subtopics

• Performance Profiler (2 pages)

More Learn pages

• Analyzing report data with Excel and XML: Learn how to use Excel and XML to analyze a report dataset.
• Customizing Pages for Roles: Learn how to customize the user interface for a profile (role) so that all users assigned that role see a customized workspace.
• Define granular permissions: This article describes how to define granular permissions and assign each user the permission sets that they need to do their jobs.
• Events discoverability: Using the Event Recorder, you can record the events that are published and raised while performing the actions of your scenario.
• Inspecting pages in Business Central: Use page inspection feature to view page design and data source details. Ideal for troubleshooting and understanding data in Business Central.
• Missing indexes in Business Central databases: Learn about missing indexes and the database missing indexes page.
• Personalize your workspace: Learn how to customize the user interface and personalize your workspace to suit your way of working and personal preferences in Business Central.
• Troubleshooting the Business Central Mobile App On-Premises: Find help for resolving problems with the Business Central web, tablet, and phone clients when you run Business Central on-premises.
• Understanding the error dialog: Understand the different parts the error dialog to be able to help mitigate issues for users
• View Database Locks: Learn how you can view information about customer database locks right from the client interface in Business Central.
• View table information: Learn how you can view information about the database tables in Business Central.

Videos, posts and code changes

Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.

• #10335 Unblock bc login due to pp failures (code change): “Prevents sign-in blocking when linked Power Platform environment lookup fails”
• Quick Tips: Find a Field on a Business Central Page (community post): “Page Inspection is a built-in tool in Business Central that helps you quickly find”

Business Central pages and reports

The pages, reports and queries this hub’s Learn pages name (ms.search.form, API reference), joined to the code by exact object id (data/index/docs-objects.json); a page shows the table it runs on.

• Page 119 “User Setup” · on Table 91 “User Setup”
• Page 8700 “Table Information”
• Page 8705 “Table Information Card” · captioned “Index Management”
• Page 8930 “Email View Policy List” · captioned “User Email View Policies” · on Table 8930 “Email View Policy”
• Page 9000 “Whse. WMS Role Center” · captioned “Shipping and Receiving - Warehouse Management System”
• Page 9004 “Bookkeeper Role Center” · captioned “Bookkeeper”
• Page 9005 “Sales Manager Role Center” · captioned “Sales Manager”
• Page 9006 “Order Processor Role Center” · captioned “Sales Order Processor”
• Page 9007 “Purchasing Agent Role Center” · captioned “Purchasing Agent”
• Page 9009 “Whse. Worker WMS Role Center” · captioned “Warehouse Worker - Warehouse Management System”
• Page 9010 “Production Planner Role Center” · captioned “Manufacturing Manager”
• Page 9016 “Service Dispatcher Role Center” · captioned “Service Manager”
• Page 9017 “Service Technician Role Center” · captioned “Outbound Technician - Customer Service”
• Page 9020 “Small Business Owner RC” · captioned “President - Small Business”
• Page 9022 “Business Manager Role Center” · captioned “Business Manager”
• Page 9024 “Security Admin Role Center” · captioned “Administration of users, security groups and permissions”
• Page 9026 “Sales & Relationship Mgr. RC” · captioned “Sales and Relationship Manager”
• Page 9027 “Accountant Role Center” · captioned “Accountant”
• Page 9030 “Account Manager Activities” · captioned “Activities” · on Table 9054 “Finance Cue”
• Page 9171 “Profile List” · captioned “Profiles (Roles)”
• Page 9511 “Database Locks”
• Page 9800 “Users”
• Page 9802 “Permission Sets” · on Table 9009 “Permission Set Buffer”
• Page 9807 “User Card”
• Page 9808 “User Permission Sets”
• Page 9816 “Permission Set by User”
• Page 9855 “Permission Set” · on Table 9862 “PermissionSet Buffer”
• Page 9862 “Expanded Permissions”
• Page 9865 “Permission Lookup List” · on Table 9865 “Permission Lookup Buffer”
• Page 9874 “Permission Set By Sec. Group” · captioned “Permission Set by Security Group”
• Page 9878 “Permission Set Lookup List” · captioned “Permission Set Lookup” · on Table 9862 “PermissionSet Buffer”
• Page 9883 “Permissions Overview”

Learn also names 2 objects with no object page: page/9830, page/9831.

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.