Workspace window
The workspace window shows one open workspace. You browse, search and analyze its code here. It has the menus in its title bar, a rail of pages on the left, the selected page in the middle and a status bar at the bottom.
Opening it
- Open a workspace from the Home page of the control panel. Each workspace gets its own window.
- Open a workspace again from Recent workspaces.
The window opens maximized unless you turn off Open workspace window maximized on the Settings page. What it shows first follows Start action on the same page.
| # | Name | Description |
|---|---|---|
| 1 | Solution | Shows the Solution page. |
| 2 | Objects | Shows the Objects page. |
| 3 | Module graph | Shows the Module graph page. |
| 4 | Discovery | Shows the Discovery page. |
| 5 | Namespaces | Shows the Namespaces page. |
| 6 | Reports | Shows the Reports page. |
| 7 | Code graph | Shows the Code graph page. |
| 8 | MCP Server | Shows the page where you start and stop Prism's MCP server. Shown when your license includes the MCP server. |
| 9 | Operations | Shows the number of background tasks running. Select it to list them with their progress, and select the cross beside a task to cancel it. |
| 10 | Reload |
Reloads the current workspace. Use it when workspace files
(typically .al or app.json) change on disk, for example
after you edit them in Visual Studio Code. See also
Memcache.
|
| 11 | Show Prism control panel | Brings the control panel to the front (Ctrl+Shift+C). |
| 12 | Settings | Shows the Settings page filtered to the settings related to workspaces. |
| 13 | Workspace path |
The path of the workspace, after a glyph for its kind: a document for a
.code-workspace file, a cloud for a workspace opened from Business Central, a folder
or a package. Select the path to open or reveal it in Windows File Explorer, depending on how the
workspace was opened.
|
| 14 | Search depth | A magnifier and the search depth the workspace was opened with: None, Direct or All. It is hidden at the default, Propagated, which is how Visual Studio Code resolves packages, and the magnifier is in the accent color when it is shown. Hover it for the depth, its diagram and its description. When the workspace loaded modules that only All finds, the magnifier turns to the caution color and the tooltip counts them: “AL: Download symbols” in Visual Studio Code does not update those modules, so they may be outdated. |
| 15 | Memcache consumption |
Shows the amount of memory consumed by caching of source files in the workspace
folders.
It is only shown when the workspace folders contain .al files and
Memcache
was on when the workspace was opened.
|
| 16 | Page area | The selected page. |
The Search pill in the title bar, right after the menus, reads Search Ctrl T. Select it to open Universal Search, as Search › Search Everywhere… does. It hides when the window is too narrow to fit it before the window buttons. The screenshot does not show it.
The status bar shows two more items when they apply:
- A package glyph in the accent color, before the search depth, while the workspace resolves packages through the package cache as well; see Search package cache.
- The Git branch, after the memcache, when the workspace is in a Git repository.
Two buttons appear only when they apply, so the screenshot does not show them:
- Diagnostics follows the page buttons when Prism found issues loading the workspace. Select it to show the Diagnostics page.
- Start code graph follows Reload while the code graph is not running or starting. Select it to start the code graph.
While background operations run, the status bar starts with a toggle that shows or hides the large progress bar.
Menus
The menus sit in the title bar, left to right. Each menu is shown open beside its items.
Go to position window
The Go to position window takes you to a character position in the current object's source
code. The position is counted from the start of the object in its .al file, starting at 0.
Opening it
- Select View › Go to Position…, or press Ctrl+G.
| # | Name | Description |
|---|---|---|
| 1 | Position | The character position to go to. It starts at 0, selected, so you can type over it. |
| 2 | Ok | Goes to the position. It is available once you change the position; Enter does the same. |
| 3 | Cancel | Closes the window. Esc does the same. |
Prism switches to Source view, scrolls to the position and selects the character there, and the window closes. A position beyond the end of the source shows “Position out of range” with the range you can use, and the window stays open so you can correct it.
Workspace details window
The workspace details window lists how Prism resolved the modules of the workspace: each module in the order it was resolved, the file it came from, and the version constraints that led to that version. Use it to see why a workspace loaded a particular version of a dependency.
Opening it
- Press Ctrl+Y in the workspace window. No menu item opens it.
| # | Name | Description |
|---|---|---|
| 1 | Module Resolution | The list of modules, numbered #1, #2 and so on in the order Prism resolved them. |
| 2 | Path | The app.json or package file the module came from. Select it to show the file in Windows File Explorer. |
| 3 | Module | Publisher, name and version of the module, followed by its ID. |
| 4 | Resolution | “Successful resolution to version …” in green, or a failure in red, such as “Failure: No constraints”. |
| 5 | Ok | Closes the window. Esc and Enter do the same. |
Under the resolution, each version constraint on the module is listed: Source Path and Source Module, the module that depends on it, and Target Version, the version it asks for with its operator. A constraint that comes from the application or platform names the Target Module instead, and a module's own version shows as Version.
The window is titled like the workspace window and stays open beside it.