Reference manual

Objects page

Settings page

The Settings page holds the settings that apply to all of Prism for AL: how it works with Visual Studio Code and Business Central, what it sends outside your computer, how workspaces open, the package cache, the code graph, how code looks, and how the usages, flows and other windows behave. This page lists every setting, its options, its default and when a change takes effect.

Opening it

Prism for AL Settings page in the main window with all setting groups collapsed
1 2 3 4 5 6
The Settings page with its groups collapsed.
#NameDescription
1Filter buttonShows only the settings for the window the page is in, or all settings. See Show only the settings for a window.
2IntegrationsVisual Studio Code, Open from BC, and Data and privacy. See Integrations.
3WorkspaceHow workspaces open and load, and how code looks. See Workspace.
4Find usagesHow usages are searched and shown. See Find usages.
5Find flowsHow many results a flow search returns. See Find flows.
6Search settingsShows only the settings that contain every word you type, across all groups. See Search settings.

Below Find flows is Appearance & behavior: how windows behave and how Prism draws them. See Appearance & behavior.

Each group holds cards. A card shows a setting's name, a description below it and its control on the right; a card with an arrow expands to a set of related settings; select it to expand or collapse it. Hover a setting for more help. A slider or a path with a Reset to default value button beside it returns to its default when you select the button.

The page has no Save button. Prism saves a change half a second after you make it; see When changes take effect.

Search settings

Type in the Search settings box, at the top of the page, to show only the settings whose name, description, card or group contains every word you type, ignoring case. A card that holds a match opens, and a group with no match is hidden. While you search, the page looks through every setting, whatever the filter button is set to. When nothing matches, the page says “No settings match the search.” Clear the box to see all the settings again.

When you open a setting from Universal Search, the Settings page clears its search, shows all settings if the filter button hides that one, opens its card and scrolls to it. The setting is outlined in the accent color for about two seconds.

Integrations

How Prism works with Visual Studio Code and Business Central, and what it sends outside your computer.

The Integrations group of the Settings page with Visual Studio Code and Open from BC expanded
1 2 3 4 5 6
The Integrations group.
#NameDescription
1Path to code.cmdWhere Visual Studio Code is.
2Default download pathWhere symbol files from Business Central go.
3Re-open from BC behaviorWhether Prism downloads the symbol files again before it opens a workspace you downloaded from Business Central, opens it as it is, or asks you each time.
4Entra ID credentials cacheClears stored Business Central Online sign-ins.
5Windows Credential ManagerOpens the Windows store of on-premises sign-ins.
6Data and privacyWhat Prism sends outside your computer, and the Feature usage telemetry switch. See Data and privacy.
SettingOptionsDefaultEffect
Path to code.cmd (under Visual Studio Code) The path of code.cmd; … picks the file Empty: Prism runs code.cmd and finds it through PATH The Visual Studio Code that Prism starts when you go to code in Visual Studio Code. Set it when Visual Studio Code is not on PATH. Applies to the next time Prism starts Visual Studio Code.
Default download path (under Open from BC) A folder; … picks one Empty: Prism suggests the folder you last downloaded to When you open a workspace from a Business Central service, Prism suggests a subfolder of this folder for the downloaded symbol files. Applies to the next download. See Download folder.
Re-open from BC behavior (under Open from BC) Ask, Download symbols and open workspace, Open workspace Ask What happens when you open a workspace you downloaded from Business Central before. Ask shows “Would you like to re-download symbol files from the server before opening the workspace?”; Download symbols and open workspace always downloads them again first; Open workspace opens the files you have. Applies to the next time you open such a workspace. See Re-download symbol files.
Entra ID credentials cache (under Open from BC) Clear None Prism stores your Business Central Online sign-in for later use. Clear asks “This will clear all cached access tokens for BC Online stored in Prism, do you wish to proceed?” and then removes them, so the next connection signs in again.
Windows Credential Manager (under Open from BC) Open None Windows keeps the user names and passwords for Business Central on-premises. Open opens the Windows Credential Manager, where you edit or remove them.
Feature usage telemetry (under Data and privacy) Allow checked or cleared Cleared until you answer Prism's question Sends which features you use, and errors as exception types and code locations, to stati-cal.com every few minutes. It tells Statical a feature nobody uses from one nobody found or one that is broken. Events recorded while it is off are discarded. The setting also applies to the MCP servers you start from the command line, which never ask: a server that is already running follows a change from its next post. What it sends shows each field and an example. The privacy policy says how long Statical keeps it. You can change it at any time, with or without a license. Applies at once. For everything Prism sends, see What Prism sends, and where.

Data and privacy

The Data and privacy card shows what Prism sends outside your computer, and when. It holds the one flow you can turn off: feature usage.

The Data and privacy card of the Settings page, expanded, with Feature usage telemetry on and the drawing of where data goes
1 2 3 4 5 6 7 8 9
The Data and privacy card.
#NameDescription
1Feature usage telemetry onThe state of the switch, readable with the card collapsed: on or off. A green dot shows while it is on.
2AllowTurns feature usage on or off. See Feature usage telemetry.
3Last sentWhile the switch is on, when feature usage last reached Statical since Prism started.
4What it sendsOpens a window with a post as this computer sends it and what each of its fields carries. See What it sends below.
5Where data goesDraws every flow of data between Prism and anything outside it: your computer on the left, where data goes on the right.
6Privacy statementOpens Microsoft's privacy statement, which covers the sign-in to Business Central online.
7Privacy policyOpens Statical's privacy policy: how Statical handles what reaches it, and how long it keeps it.
8License check, Update check, Install noticeWhen the license check and the update check last reached Statical since Prism started, and whether the install notice has gone.
9What Prism sends, and whereLearn more opens this manual's page on the flows, What Prism sends, and where, in your browser.

About half a minute after it starts, Prism asks “Help Statical improve Prism?” until you answer. Allow turns the switch on and Don't allow leaves it off. If you close the question without answering, Prism asks again the next time it starts.

The card's header reads Feature usage telemetry on while the switch is on, and Feature usage telemetry off otherwise. While the switch is on, the line under it says when feature usage last reached Statical: “Last sent at 11:57” for today, “Last sent 9 Nov at 11:57” for an earlier day, or “Not sent since Prism started”. Under the drawing, the license check and the update check show the same kind of time, and the install notice shows “Sent” or “Not sent yet”. The page updates these while it is open.

What it sends

What it sends opens the What feature usage sends window. It says why Statical asks, and links to the privacy policy for how long Statical keeps each post.

The What feature usage sends window: why Statical asks, three facts, an example post and what each field means
1 2 3 4 5
The What feature usage sends window.
#NameDescription
1privacy policyOpens Statical's privacy policy, which says how long Statical keeps what Prism sends.
2FactsWhat holds for every event: it is sent only while you allow it, the workspace and object it concerns go as 8-character hashes made on your computer, and an error goes as its exception types and code locations, without its message.
3What a post looks likeA post with this computer's values around an example event. Prism sends the events recorded since the last post this way every few minutes. You can select and copy it.
4What the fields meanWhat each field of the post carries, as the table below lists.
5Features pageCloses the window and opens the Features page in the Control Panel, which shows which features you have used and which you have not explored yet.
FieldWhat it carries
versionThe version of Prism.
productWhich Prism sent the post: al for Prism for AL.
schemaThe number of the format the post is written in.
idA new ID for each post.
source.processA random ID for this run of Prism.
source.machine-codeThe code that identifies this computer in your license.
source.license-hashA hash of your license key.
events[].idA random ID for the event.
events[].nameWhat you used, such as a window or a command, or an error that occurred.
events[].workspaceAn 8-character hash of the workspace. Left out when there is none.
events[].objectAn 8-character hash of the object's name, and its type. Left out when there is none.
events[].argumentsDetails some events carry, such as choices, counts and timings; for an error, its exception types and code locations.

Workspace

How workspaces open and load. The group also holds the Package cache, Code graph, Code and Workspace window cards, described in the sections below.

The Workspace group of the Settings page with its cards collapsed
1 2 3 4 5 6 7 8
The Workspace group.
#NameDescription
1Start actionWhether a workspace opens on the Solution page or goes back to the place you last went to in it.
2Package cacheSee Package cache.
3MemcacheWhether Prism keeps a copy of the code in memory.
4Code graphSee Code graph.
5Declaration tooltipsWhether tooltips name the file of a declaration.
6Default translation languageThe language a workspace shows label translations in when it opens, if the workspace has translations to it.
7CodeSee Code.
8Workspace windowSee Workspace window.
SettingOptionsDefaultEffect
Start action Show solution view, Go to most recent navigation Go to most recent navigation What a workspace window shows after the workspace has opened: the Solution page, or the place you last navigated to in that workspace. Applies to the next workspace you open.
Memcache (Keep snapshot in memory) On, Off On Keeps a copy of the workspace's code in memory, so what you see stays the same when an external editor changes or removes files. It uses more memory. Applies to the next workspace you open.
Declaration tooltips (Show compilation unit) On, Off On Adds the file (compilation unit) a declaration is in to the path its tooltip shows.
Default translation language A language tag, such as da-DK; empty for none Empty The language a workspace shows Inlined XLIFF translations in when it opens, if it has translations to that language; Prism also marks it as the default in the translation language list. Use a dash, not an underscore; Prism says “Please use dash ('-') instead of underscore ('_')” or “Invalid ISO language tag” and keeps the last valid value. A change moves the default mark at once, also in open workspaces; the language an open workspace shows stays as it is.

Package cache

Where the package cache is, and how Prism uses it to find the packages a workspace depends on. Group Workspace.

The Package cache card of the Settings page, expanded
1 2 3
The Package cache card.
#NameDescription
1Package cache pathThe folder of the cache, with its reset and browse buttons.
2Search package cacheWhether Prism also looks for missing packages in the cache.
3Default search depthHow far Prism follows dependencies: None, Direct, Propagated or All.
SettingOptionsDefaultEffect
Package cache path A local folder; … picks it, Reset to default value returns to the default A folder in Prism's local application data, shown as Default

Where Prism keeps cached packages. Choose a fast SSD or, ideally, a Microsoft Dev Drive. You can change it only while the cache is empty and no workspace is open; Prism says “Please remove all packages before changing location.” or “Please close all open workspaces before changing location.” otherwise.

Prism checks the new folder first. It refuses a network path, the temp folder, the Windows folder, a folder that is not empty, a drive with little free space, and a drive that is slow to write to.

After the change is saved, Prism says “Package cache path changed” and closes 5 seconds later. Start it again, and run the package cache optimization script again.

Search package cache On, Off Off When a workspace's package files do not hold a module, Prism also looks in the package cache. The package found there may be much older or newer than the one the workspace expects. This is the default for the same option on the Home page.
Default search depth None, Direct, Propagated, All, on a slider; select a stop's name or drag the slider. Hover a stop's name for a diagram of what it includes. See Search depth stops. Propagated, as Visual Studio Code does; its name is always in the accent color How far Prism follows a workspace's dependencies to resolve packages. All is shown in the caution color while selected: it adds modules that “AL: Download symbols” in Visual Studio Code never updates, so they may be outdated. This is the default for the search depth on the Home page.

Code graph

The memory and detail of the code graph that flows, flow graphs and immediate insights use. Prism builds it with a graph loader and serves it from a graph server, two separate processes. Group Workspace.

The Code graph card of the Settings page, expanded
1 2 3 4 5 6
The Code graph card.
#NameDescription
1Server: minimum heap sizeMemory the graph server starts with.
2Server: maximum heap sizeMemory the graph server may use.
3Loader: minimum heap sizeMemory the graph loader starts with.
4Loader: maximum heap sizeMemory the graph loader may use.
5Full graphAdds expression- and statement-level flows to the calls between procedures. The graph is much slower to load.
6Autobuild graphWhether the graph is built when a workspace loads.
SettingOptionsDefaultEffect
Server: minimum heap size 500 to 10,000 MB in steps of 100, on a slider 100 MB The memory the graph server starts with. Raising it above the maximum raises the maximum too. Applies to the next code graph Prism starts.
Server: maximum heap size 500 to 10,000 MB in steps of 100, on a slider 2,000 MB The most memory the graph server may use. Lowering it below the minimum lowers the minimum too. Raise it when a large workspace's graph runs out of memory. Applies to the next code graph Prism starts.
Loader: minimum heap size 500 to 10,000 MB in steps of 100, on a slider 100 MB The memory the graph loader starts with. Raising it above the maximum raises the maximum too. Applies to the next code graph Prism starts.
Loader: maximum heap size 1,000 to 10,000 MB in steps of 100, on a slider 4,000 MB The most memory the graph loader may use while it builds the graph. Lowering it below the minimum lowers the minimum too. Applies to the next code graph Prism starts.
Full graph On, Off Off On builds a Full graph, which adds expression- and statement-level flows and is much slower to load. Off builds a Procedural flow graph, which keeps the calls between procedures and is far smaller. This is the default for Graph detail on the Home page; see Graph detail.
Autobuild graph On, Off On Starts the graph server when a workspace loads. This is the default for the same option on the Home page; see Auto-build graph.

Code

How code looks and behaves in the Object view. Group Workspace.

The Code card of the Settings page, expanded
1 2 3 4 5 6 7 8 9 10 11
The Code card.
#NameDescription
1FontThe typeface of code in every window that shows code. Applies at once.
2Font sizeThe size of code in every window that shows code. With Compact line spacing, the code rows follow it. Applies at once.
3Line spacingCompact fits each row of code to the font size; Standard gives code rows the height of header rows, so code reads less densely.
4Remember code line selectionsSelects your code lines again when you return to an object.
5Show line numbersLine numbers in procedures and triggers.
6Show markers on scroll barsMarks the selected row on the scroll bars of the objects panel, the object view and the outline, and each bookmarked object on the objects panel's scroll bar. Select a mark to scroll to it.
7Accelerated object viewDraws each object as a single surface, so large objects open and scroll faster. Turn it off only if an object is drawn wrongly.
8Show object numbersObject IDs next to object names.
9Show used global variablesThe global variables each procedure and trigger uses.
10Show inherited interface proceduresInherited procedures and default implementations in the extended view.
11Immediate insight layoutWhether immediate insight buttons show an icon, a name or both.
SettingOptionsDefaultEffect
Font JetBrains Mono, Cascadia Code JetBrains Mono The font of code. Prism ships both fonts. Applies at once.
Font size 11, 12, 13 or 14, on a slider 13 The size of code. Applies at once.
Line spacing Compact, Standard Compact The row height of code, parameter and variable lines. Compact sizes rows from the code font size; Standard gives them the height of header rows. Applies at once.
Remember code line selections On, Off On When you navigate away from an object and back to it, the code lines you had selected are selected again.
Show line numbers On, Off On Shows line numbers, counted from the start of each procedure and trigger. View › Show › Line Numbers in a workspace window switches the same setting. Applies at once.
Show markers on scroll bars On, Off On Marks where the selected row and your bookmarked objects are on the scroll bars of the Objects panel, the Object view and the Outline panel. Select a marker to scroll to its row. Off shows plain scroll bars. View › Show › Scroll Bar Markers in a workspace window switches the same setting. Applies at once.
Accelerated object view On, Off On Draws each object as a single surface, so large objects open and scroll faster. Off builds every line as a separate row; turn it off only if the object view draws an object wrongly. Takes full effect on objects you open after the change.
Show object numbers On, Off Off Shows object IDs in code, in the object index and in results. Declaration tooltips always show them. View › Show › Object Numbers in a workspace window switches the same setting. Applies at once.
Show used global variables On, Off Off Lists, under each procedure and trigger, the global variables it uses directly. Applies at once.
Show inherited interface procedures On, Off On In the extended view of an interface, lists the procedures it inherits from the interfaces it extends, and in that of a codeunit, the default implementations it gets from the interfaces it implements, grouped by the interface that declares them; see Inherited procedures. Applies at once.
Immediate insight layout Icon, Name, Icon and Name Name Whether the buttons of Immediate insights show an icon, a name or both. Applies at once.

Workspace window

How a Workspace window opens, shows its menus and closes. Group Workspace.

The Workspace window card of the Settings page, expanded
1 2 3
The Workspace window card.
#NameDescription
1Open workspace window maximizedWhen on, each new workspace window opens maximized; when off, it opens centered on the screen.
2Compact menuWhen on, the menus of a workspace window sit behind one Main menu (☰) button, with back, forward and Search beside it. The same commands and Alt keys work either way.
3Confirm closing workspaceWhether Prism asks before it closes workspaces.
SettingOptionsDefaultEffect
Open workspace window maximized On, Off On Opens each new workspace window maximized; off, it opens centered on the screen. Applies to the next workspace you open.
Compact menu On, Off Off Puts the menus of a workspace window behind one ☰ button, with back, forward and search beside it. The menus hold the same commands either way, and their Alt keys open them in both. Applies at once, also to open workspace windows.
Confirm closing workspace On, Off Off Asks before all open workspaces close (“Are you sure you wish to close all open workspaces?”) and before Prism exits while workspaces are open (“There are still open workspaces - do you wish to close them and exit the application?”).

Find usages

How Prism searches for usages and how the Usages window opens.

The Find usages group of the Settings page with the Usages window card expanded
1 2 3 4 5 6
The Find usages group.
#NameDescription
1Expand filter panel on openWhether the filter panel starts open.
2Highlight filter buttonShown while Expand filter panel on open is off. Meant to mark the filter button when filters are set; Prism does not apply it yet.
3Expand result groups on openWhether result groups start expanded.
4Show filter ratio barThe bar that shows how many results the filter shows.
5Window widthThe width a usages window opens with.
6Window heightThe height a usages window opens with.

Above the card, Search only candidate objects sets whether Prism narrows the objects it searches.

SettingOptionsDefaultEffect
Search only candidate objects (Optimize find usages) On, Off On Prism first works out which objects can hold usages and searches only those, which is faster. Turn it off if a search seems to miss usages: Prism then searches all objects. The results should be the same either way; if they differ, report it through the Feedback window. Applies to the next search.
Expand filter panel on open (under Usages window) On, Off Off Opens the filter panel of a usages or flows window when the window opens, if it has filters. Applies to the next window.
Highlight filter button (under Usages window) On, Off On Meant to show on the filter button, while the filter panel is collapsed, that filters are set. Shown only while Expand filter panel on open is off. Prism saves this setting but does not apply it yet.
Expand result groups on open (under Usages window) On, Off On Meant to expand the usage groups when a usages window opens. Prism saves this setting but does not apply it yet.
Show filter ratio bar (under Usages window) On, Off On Shows a bar at the bottom of usages, flows and transfer fields windows with the share of the results the filter shows.
Window width (under Usages window) 300 pixels to the width of the screen, on a slider; double-select the slider to reset it 700 pixels Meant as the width a usages window opens with, plus about 350 pixels for the filter panel. Prism saves this setting but does not apply it yet.
Window height (under Usages window) 300 pixels to the height of the screen, on a slider; double-select the slider to reset it 700 pixels Meant as the height a usages window opens with. Prism saves this setting but does not apply it yet.

Find flows

How large a flow search may grow in the Flows window.

The Find flows group of the Settings page with the Flows window card expanded
The Find flows group.
#NameDescription
1Result limitThe most nodes a flow search returns.
SettingOptionsDefaultEffect
Result limit (under Flows window) 50,000 to 10,000,000 nodes in steps of 50,000, on a slider 2,000,000 nodes The most nodes an inbound or outbound flow search returns. Lower it when large searches take too long or use too much memory. Applies to the next search.

Appearance & behavior

How windows behave, how Prism draws them, and its colors.

The Appearance and behavior group of the Settings page with Windows in general, Rendering and App theme expanded
1 2 3 4
The Appearance & behavior group.
#NameDescription
1Escape closes windowWhether Esc closes a window.
2Show toolbar button labelsLabels next to toolbar icons.
3Use software renderingWhether Prism draws without the graphics card.
4Windows color settingsOpens the Windows color settings.
SettingOptionsDefaultEffect
Escape closes window (under Windows in general) On, Off On Pressing Esc also closes the windows you work in, such as search results and Explore Table Relations. Dialogs and quick viewers always close on Esc.
Show toolbar button labels (under Windows in general) On, Off On Shows a label next to each toolbar icon; a few buttons always show only their icon. Applies at once.
Use software rendering (under Rendering) On, Off Off Draws Prism without the graphics card. Turn it on only when Prism keeps failing with UCEERR_RENDERTHREADFAILURE or other drawing errors, which graphics drivers, remote desktop, monitors going to sleep or being unplugged, and switching between graphics cards can cause. Prism then draws noticeably slower but stays stable. Takes effect the next time Prism starts; until then the card says “Restart Prism for this change to take effect.”
Windows color settings (under App theme) Open… None Prism follows the Windows color mode, light or dark. Open… opens the Windows color settings. Change the mode there, then restart Prism: changing it while Prism runs is not supported.

Show only the settings for a window

When you open the Settings page from a workspace window, a usages window or a flows window, it first shows only the group for that window: Workspace, Find usages or Find flows. In the main window and in other windows it shows every group.

The Settings page in a workspace window showing only the Workspace group, with the filter button on
The Settings page of a workspace window, showing its own settings.
#NameDescription
1Filter buttonOn: only the settings for this window. Off: all settings.
2WorkspaceThe one group a workspace window shows.
  1. Select Settings in the rail of the window.
  2. To see all settings, select the filter button at the top right of the page. Its tooltip reads “Focuses on contextual settings or shows all settings.”
  3. Select it again to show only the settings for the window.

In the main window and the other windows, the filter button is unavailable, since the page there always shows every group.

When changes take effect

Prism saves the settings half a second after your last change. The Settings page of every window shows and changes the same settings. Most settings then apply at once or the next time they are used, as their rows say. Three cases differ:

  • Home page options. Search package cache, Default search depth, Full graph and Autobuild graph are the defaults for the options on the Home page. A change you make on the Home page lasts until Prism restarts or until it saves a change to the settings; then the Home page options return to these settings.
  • Package cache path. Prism closes 5 seconds after the change is saved, and uses the new folder when you start it again.
  • Use software rendering. Takes effect the next time Prism starts.
An unhandled error has occurred. Reload 🗙