Alternate Text
D365 Business Central VS Code integration,
25-01-2026
Microsoft Dynamics D365

Opening Visual Studio Code from D365 Business Central for Extension Investigation

Modern D365 Business Central extension development is no longer limited to writing AL code from scratch. Microsoft has introduced smarter ways to inspect, investigate, and troubleshoot extensions directly from the Business Central web client by opening Visual Studio Code in context.

This capability is especially useful when developers, consultants, or support teams need to understand how a page works, which fields are used, or why an extension behaves unexpectedly. Instead of guessing, Business Central now allows you to jump straight into Visual Studio Code from the web interface and inspect the underlying AL structure.

Need help with extension investigation or enterprise-level customization?
Our team delivers secure and scalable Microsoft Dynamic 365 Solutions, covering development, debugging, and long-term support for Business Central environments.

What Does “Opening VS Code from Business Central” Mean?

Opening Visual Studio Code from Business Central does not mean editing live production code directly. Instead, it allows you to:

  • Inspect page and object definitions

  • Download symbols or source (based on permissions)

  • Attach a debugger to a running session

  • Understand how extensions interact with standard objects

This feature is designed for safe investigation and troubleshooting, especially in sandbox environments.

Who Should Use This Feature?

This workflow is useful for multiple roles:

Role

How It Helps

AL Developers

Inspect pages, fields, and triggers faster

Functional Consultants

Understand page behavior without guessing

Support Teams

Troubleshoot extension issues efficiently

System Administrators

Investigate issues without direct code access

If you are new to AL development, we recommend first reviewing our detailed setup guide on How to Connect Your Business Central with Visual Studio Code, as this blog builds on that foundation.

Prerequisites Before You Start

Before using the “Open in VS Code” feature, make sure the following are ready:

  • Visual Studio Code installed locally

  • AL Language extension enabled

  • Access to Business Central cloud sandbox or environment

  • Proper user permissions

  • Internet connection for symbol download and authentication

Without these, the investigation workflow will not function correctly.

Watch Out2sol Youtube Video on Extension Investigation

Step-by-Step: Opening Visual Studio Code from Business Central Web Client

Below are the exact classroom-style steps used in the Out2Sol training video.

Step 1: Search for a Customer

  • Use the Tell me what you want to do search

  • Type cus

  • Select Customer from the results

Step 2: Open Help Pane

  • Click the question mark (?) icon in the top-right corner

  • The Help pane opens on the right side

  • Scroll down

Step 3: Go to Help & Support

  • In the Other resources section

  • Click Help & Support

Step 4: Inspect Pages and Data

  • Locate the Troubleshooting section

  • Click Inspect pages and data

Step 5: Page Inspection Pane Opens

  • The inspection panel appears on the right

  • Displays page metadata, fields, and data sources

This pane is the bridge between the UI and AL code.

Step 6: Explore Page in Visual Studio Code

  • Inside the Page section

  • Click Explore page in Visual Studio Code

Step 7: Allow VS Code to Open

  • A confirmation dialog appears in VS Code

  • Allow the AL Language extension to open the URI

  • Click Open

Step 8: Inspect the AL Code

  • The page source file opens (for example CustomerList.al)

  • Scroll through the AL code

  • Fields shown in Page Inspection match field() definitions

At this stage, you are inspecting the structure, not modifying live data.

What Actually Opens in Visual Studio Code?

When VS Code launches, Business Central automatically:

  • Creates a temporary AL project

  • Generates app.json and launch.json

  • Downloads symbols or source code (based on permissions)

  • Connects to the correct environment

Key Files Explained 

File

Purpose

app.json

Extension identity and metadata

launch.json

Extension identity and metadata

Production Debugging: What You Should Know

Yes, debugging production sessions is possible, but it is controlled.

  • You can attach a debugger to a live session

  • Source code visibility depends on resourceExposurePolicy

  • If source is restricted, only symbols are available

  • This prevents unauthorized access to proprietary code

Microsoft designed this to balance power with security.

Common Use Cases for This Feature

  • Investigating unexpected page behavior

  • Verifying which fields are used by extensions

  • Troubleshooting performance issues

  • Understanding third-party extension logic

  • Learning AL structure from real objects

Visual Workflow Overview

Step

Action

Web Client

Open page and inspect

Page Inspector

View metadata

VS Code

Open AL project

Symbols

Download objects

Debugger

Attach to session

This flow removes guesswork and speeds up analysis.

Common Issues and Fixes

VS Code does not open

  • Check AL Language extension

  • Verify VS Code installation

  • Confirm browser permissions

Source code not visible

  • Extension does not allow source exposure

  • You will receive symbols only

Debugger not attaching

  • Environment mismatch

  • Incorrect launch.json values

Why This Feature Matters for Business Central Teams

Extension investigation is no longer limited to senior developers. Microsoft has made it accessible, structured, and safer for broader teams. This improves collaboration between development, functional, and support roles while reducing resolution time.

FAQs

Q. What are the prerequisites for opening VS Code from Business Central?
You need VS Code, AL Language extension, correct permissions, and access to the environment.

Q. Can I debug production environments?
Yes, but access is restricted and controlled by extension policies.

Q. Why do I only see symbols instead of code?
The extension owner has restricted source exposure.

Q. Does this work with cloud sandboxes?
Yes, sandbox is the recommended environment for investigation.

Final Thoughts

Opening Visual Studio Code from the D365 Business Central web client makes extension investigation faster and more practical. It allows teams to move directly from the user interface to AL code, symbols, and debugging tools without breaking workflow.

Used correctly, this feature helps developers, consultants, and support teams understand extensions, trace issues, and work confidently across sandbox and production environments.


Microsoft Dynamics D365
Share:
Lets Talk