Reference manual
The reference manual describes every window and page of Prism for AL, with each control, menu command and setting it has. Look up a window here when you want to know what something does or which options it offers.
Prism for AL has two kinds of window. The main window is where you open workspaces and manage features, settings and the license. Each workspace you open gets a workspace window of its own, where you browse, search and analyze its code.
- The Glossary defines the terms the manual uses.
- The Declaration search matrix compares the ways to find a declaration.
- Using Prism for AL covers keyboard shortcuts, filter syntax and other conventions shared by all windows.
Control windows
| Page | What it covers |
|---|---|
| Control Panel | The Prism for AL Control Panel: the Home, Features, Package cache, Environment, About and Settings pages, the File and Help menus, logs, workspace recordings and shortcuts. |
| Home page | Open a workspace, folder, package or Business Central solution from the Prism for AL Home page, reopen a recent one, check your version and license, and set package resolution and graph options. |
| Open from BC window | Open a solution from a running Business Central service in Prism for AL: the connection string, on-premises, Online and Cosmo Alpaca targets, ports, the download folder, sign-in and the download. |
| Features page | Browse the main features of Prism for AL on the Features page, filter to new, updated or unexplored features, track your progress, and rate a feature or suggest a new one. |
| Package cache page | Manage the Prism for AL package cache: see cached packages and their size, wipe entries, and exclude the cache from Microsoft Defender scans. |
| Environment page | See the AL settings in your Visual Studio Code user settings.json from Prism for AL, filter them, read lists and tables at a glance or as JSON, and check the system Prism runs on. |
| Settings page | Every Prism for AL setting: Visual Studio Code and Business Central integration, workspaces, the package cache, the code graph, code, find usages, find flows and windows. |
| About page | The Prism for AL About page shows the version, the installed package, the license state and the build's expiry date, and links to documentation, release notes and legal resources. |
| Trial license window | Request a Prism for AL trial license key by email from the Trial license window: the fields it asks for, and the messages after you send the request. |
| Activate license window | Activate, check or undo a Prism for AL license key: the preview of what a key installs, why a key is rejected, and restoring or removing a license. |
| Loading window | What Prism for AL does while loading a workspace, from locating app.json and package files to resolving dependencies and parsing AL files. |
| Feedback window | Send a problem, an idea, a question or praise to the Prism team from Prism for AL, with the log, diagnostics, a screenshot or a file attached. |
Workspace windows
| Page | What it covers |
|---|---|
| Workspace window | The Prism for AL workspace window: its Solution, Objects, Module graph, Namespaces, Reports and Code graph pages, and File, View, Search, History and Help menus. |
| Solution page | See a solution's modules, workspace health, AL settings and Git status in Prism for AL, with per-module tabs for details, launch settings, discovery, usings, usages, namespaces and translations. |
| Objects page | The Prism for AL Objects page brings together the objects panel, view selector, outline, navigation history, namespace display and translation language. |
| Objects panel | Find AL objects in the Prism for AL objects panel: group by module, namespace, folder or type, search by name, number, namespace or folder, filter by type, bookmark or ObsoleteState, and show details in columns. |
| Outline panel | Navigate an AL object's declarations in the Prism for AL outline, with search, presets, node types, procedure access and display options remembered per object type. |
| Object view | The Prism for AL object view shows an AL object with semantic coloring, immediate insights, event markers, inlined XLIFF translations and context menus on every declaration. |
| Extended view | The Prism for AL extended view inlines items added by extensions into the base object, applied in the topological order of module dependencies. |
| Source view | The Prism for AL Source tab shows an AL object as read-only text: open it, go to a declaration or a character position, and copy selected text. |
| Dependencies tab | Switch between the objects that use the current object and those it uses in Prism for AL, filter by name, id and dependency kind, and drill into where each dependency occurs. |
| Code fragment window | Keep or share code fragments in the Prism for AL code fragment window, with a link back to the original procedure or trigger, notes and copy to clipboard. |
| Event subscriber source generator | Generate the AL code of an event subscriber in Prism for AL for an event, a table or page trigger event, a field or a page action, with its prefix, skip and temporary record options. |
Search
| Page | What it covers |
|---|---|
| Universal Search | Find AL objects, members, Prism Paths, commands and pages in Prism for AL from one Ctrl+T box, with filter tokens, grouping, actions and a source preview. |
| Free text search window | Search AL source line by line with wildcards in Prism for AL, in this object, the filtered objects or all objects, with object type chips, a code preview and copyable results. |
| Usages window | Find usages of an AL declaration in Prism for AL, with grouped results, pinning, text filters, and filters for field assignment and temporary records. |
| Built-in function usages window | Find where selected built-in methods are called on an object in Prism for AL, with table methods grouped by Read, Insert, Modify and Delete. |
Analysis
| Page | What it covers |
|---|---|
| Module graph page | Visualize a workspace's module dependencies as a graph in Prism for AL, with layout options and annotations for degree, location and version constraints. |
| Discovery page | See which app.json and .app package files Prism for AL considered while loading a workspace, which were included or ignored, and which failed and why. |
| Namespaces page | Explore AL namespaces in Prism for AL: each namespace's objects and metrics, and which namespaces it uses or is used by, with the evidence. |
| Namespace usage details window | See the evidence for a dependency between two AL namespaces in Prism for AL, as pairs of source and target objects, and find each usage. |
| Reports page | Run Prism for AL reports on a workspace: solution metrics, object dependencies, unreferenced objects, OnPrem usages and parse errors. |
| Code graph page | Start or stop the Prism for AL code graph that features such as immediate insights need, follow its progress, and see its graph detail and metrics. |
| File explorer window | Browse the files that make up a Prism for AL workspace, from cached packages to .al files and the objects in them, with file and object context menus. |
| Diagnostics page | Review the module, compilation unit and code graph errors Prism for AL found while loading a workspace or building the code graph, and copy the details. |
| Flows window | Explore inbound and outbound flows in the Prism for AL Flows window, filter to user actions, event publishers or RIMD operations, and find shortest paths. |
| Procedural flow graph window | Visualize the inbound or outbound procedural flow of a procedure or trigger in Prism for AL as a graph you can search, lay out and save as a PNG. |
| Explore table relations window | Explore a table's relations in Prism for AL as a diagram, adding inbound and outbound related tables step by step, and save it as a PNG. |
| Object dependencies window | Open the Prism for AL Dependencies tab of the current object in a window of its own, from the tab's menu, the View menu or Ctrl+Shift+D. |
| Transfer fields window | View the TransferFields mapping between two tables in Prism for AL, matched by field number and including fields from every extension in the workspace. |
| RIMD overview window | View which tables a procedure or trigger reads, inserts, modifies or deletes in Prism for AL. |
MCP server, connector and command line
| Page | What it covers |
|---|---|
| MCP server | Connect an AI coding agent to Prism for AL over MCP, tell it to use Prism, and the questions it can answer. |
| Prism for AL Connector | Install Prism for AL Connector for Visual Studio Code to jump from any line of AL code to Prism, and to give GitHub Copilot agent mode Prism's MCP server. |
| Full Solution Download | Download all apps from a Business Central sandbox with Visual Studio Code using the Full Solution Download app, then open them in Prism for AL. |
| Command-line interface | Run Prism for AL from the command line with prism-al: reports, license status and installation, the package cache, the open command and the MCP server, with every option and exit code. |
Data and privacy
| Page | What it covers |
|---|---|
| What Prism sends, and where | Every flow of data between Prism for AL and anything outside it: what reaches Statical, Microsoft, your Business Central and your AI provider, and what you control. |
Troubleshooting
| Page | What it covers |
|---|---|
| Troubleshooting | Fix common Prism for AL problems: unresolved modules, ignored packages, parse errors, opening from Business Central, navigation, the license and the MCP server. |