Reference manual

Settings page

The Settings page holds the settings that apply to all of Prism for C/AL: how mirrors synchronize, which files a folder store reads, how code looks and how windows behave. This page lists every setting, its options, its default and when a change takes effect.

Opening it

  • Select Settings at the bottom of the rail of the Control Panel.
  • Select File › Settings… in the main window, or press Ctrl+P.
  • Select Settings at the bottom of the rail of a Workspace window.
Prism for C/AL Settings page with all setting groups collapsed
1 2 3 4 5 6 7 8
The Settings page with its groups collapsed.
#NameDescription
1Object StorageThe section for the groups about object stores and mirrors.
2MirrorsHow mirrors synchronize. See Mirrors.
3Unstructured Directory StoreWhich files a folder store reads. See Unstructured Directory Store.
4Object StoreHow Prism reads object files. See Object Store.
5Appearance & behaviorThe section for the groups about how Prism looks and behaves.
6CodeHow code looks. See Code.
7Windows in generalHow windows behave. See Windows in general.
8RenderingHow Prism draws its windows. See Rendering.

Select a group to expand or collapse it; all groups start collapsed. Each setting shows its name, a description below it, and its control on the right. Hover a setting for more help.

The page has no Save button. Prism saves a change and applies it half a second after you make it.

Mirrors

How Prism synchronizes mirrors. Section Object Storage.

The Mirrors group of the Settings page, expanded
1 2 3 4
The Mirrors group.
#NameDescription
1Object comparisonHow synchronization spots a changed object.
2Synchronization intervalMinutes between synchronizations.
3Database connection timeoutSeconds to wait for a database connection.
4Post-update hookA script to run after an update, and its Input.
SettingOptionsDefaultEffect
Object comparison NameVersionListTimeBlobSize, RowVersion NameVersionListTimeBlobSize How synchronization decides that an object in the database differs from the mirrored copy. NameVersionListTimeBlobSize, the recommended option, compares the object's name, version list, date, time and size. RowVersion compares the timestamp column of the Object table. Takes effect after you restart Prism.
Synchronization interval A whole number of minutes, 1 or more 15 Minutes between two synchronizations of the mirrors that have Automatic synchronization on. Takes effect after you restart Prism.
Database connection timeout A whole number of seconds, 1 or more 8 Seconds Prism waits for a connection to a mirror's database before it gives up. Applies to the next connection.
Post-update hook The path of a .ps1, .bat, .cmd or .sh script; Browse... picks one Empty: no script runs A script Prism runs each time a mirror update writes object files. Copy sample script copies a commented PowerShell template to the clipboard. Applies to the next update. See Run a script after an update.
Input (under Post-update hook) None, PlainText, Json None What Prism writes to the script's standard input: nothing, the changed file paths with a prefix, or a JSON object. Applies to the next update.

Unstructured Directory Store

Which files and folders Prism reads when it opens an unstructured folder of object files, with Open folder… on the Home page or File › Open › Object Text Directory (Unstructured *.txt)…. Use them when the folder is a version control working folder that also holds files without objects. Section Object Storage.

The Unstructured Directory Store group of the Settings page, expanded
1 2 3
The Unstructured Directory Store group.
#NameDescription
1File name inclusion filterThe files Prism reads.
2File name exclusion filterThe files Prism skips.
3Directory name exclusion filterThe folders Prism skips.
SettingOptionsDefaultEffect
File name inclusion filter A filter, such as *.txt or table*.txt|object.* Empty: every file Prism reads only the files whose names match.
File name exclusion filter A filter Empty: no file is skipped Prism skips the files whose names match.
Directory name exclusion filter A filter, such as .git or temp_*|tmp_* Empty: no folder is skipped Prism skips the folders whose names match, with everything in them.

A filter is one or more names separated by |. A name can hold the wildcards * (any characters) and ? (one character). The filters apply the next time you open a folder. For example, to read only .txt and .cal files from a Git working folder, set File name inclusion filter to *.txt|*.cal and Directory name exclusion filter to .git. The command-line tool takes the same filters as options; see Command line.

Object Store

How Prism reads C/AL object files. Section Object Storage.

The Object Store group of the Settings page, expanded, with Default object encoding blank for the OEM code page
The Object Store group.
#NameDescription
1Default object encodingThe text encoding of object files.
SettingOptionsDefaultEffect
Default object encoding A blank entry, or a code page from the list, shown as its name and display name Blank: the system's OEM code page The text encoding Prism reads object files with, in every file store, folder store and mirror. A mirror's own Object encoding overrides it. Applies the next time you open an object store.

Code

How code looks and behaves in the Object view. Section Appearance & behavior.

The Code group of the Settings page, expanded
1 2 3 4 5
The Code group.
#NameDescription
1FontThe font of code.
2Font sizeThe size of code.
3Line spacingThe space between code lines.
4Remember code line selectionsSelects your code lines again when you return to an object.
5Show used global variablesLists the global variables each procedure and trigger uses.
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 12 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 used global variables On, Off Off Lists, under each procedure and trigger, the global variables it uses directly. The object on screen is drawn again at once.

Windows in general

How windows behave and what they show. Section Appearance & behavior.

The Windows in general group of the Settings page, expanded
1 2 3 4 5 6
The Windows in general group.
#NameDescription
1Escape closes windowWhether Esc closes a window.
2Show toolbar button labelsLabels next to toolbar icons.
3Open workspace window maximizedHow a workspace window opens.
4Confirm closing object storeWhether Prism asks before it closes a store.
5Show Solution pageThe Solution page in the workspace rail.
6Show Interop References pageThe Interop References page in the workspace rail.
SettingOptionsDefaultEffect
Escape closes window On, Off On Pressing Esc also closes the windows you work in, such as search results and Explore Table Relations. Dialogs always close on Esc.
Show toolbar button labels On, Off On Shows a label next to each toolbar icon; a few buttons always show only their icon. Applies at once.
Open workspace window maximized On, Off On Opens each new workspace window maximized. Applies to the next object store you open.
Confirm closing object store On, Off On Asks before an object store closes, before all open stores close, and once before Prism exits.
Show Solution page On, Off On Shows the Solution page in the rail of every workspace window. Applies at once, also to open windows.
Show Interop References page On, Off On Shows the Interop References page in the rail of every workspace window. Applies at once, also to open windows.

Rendering

How Prism draws its windows. Section Appearance & behavior.

The Rendering group of the Settings page, expanded
The Rendering group.
#NameDescription
1Hardware-accelerated graphicsWhether Prism draws with the graphics card.
2Enable UI virtualization in usages windowsWhether usages windows draw only the rows in view.
SettingOptionsDefaultEffect
Hardware-accelerated graphics On, Off On Turn it off when Prism shows display problems; Prism may then run slower. Turning it off applies at once. Turning it back on takes a restart; Prism says Restart required: "Prism must be restarted before hardware-accelerated graphics can be re-enabled."
Enable UI virtualization in usages windows On, Off On Lets usages windows draw only the rows in view, which keeps long result lists fast. While it is on, a usages window may forget which nodes you collapsed or expanded. Applies to the next usages window.

Settings kept in other windows

Prism also remembers choices you make in other windows. They are not on the Settings page; change them where you make them. Each applies at once and stays for every object store until you change it.

SettingWhereDefaultEffect
Toolbar, Objects, Outline, Status Bar View › Show in a Workspace window All on Show or hide the toolbar, the object index, the outline and the status bar. View is highlighted while any of them is hidden.
Object Numbers View › Show in a workspace window On Shows object IDs in the object index.
Object types The filter of the Object index All types shown Which object types the object index lists. Clear shows all again.
Granule / ID range The filter of the object index All ranges shown Which ID ranges the object index lists, from Microsoft Dynamics NAV (0–9999) to Other (system / virtual / unknown).
Topological sort order and the sort direction Sort in the object index settings Off; ascending Sorts the objects of each type by dependency depth instead of by ID, ascending or descending.
Kinds and the outline filter The settings of the Outline Kinds on; no filter Shows each node's kind, such as Local Procedure or FlowField. The outline filter is kept per object type.
Hidden cards The edit mode of the Solution page All cards shown Which cards the Solution page leaves out.
Include options Find Usages, under Show where assigned and read and Show where assigned only All on The Include options a new usages window starts with. Set the options, then select the save button beside the option group; its tooltip reads Save current Include Options as my new default.
Reply to and Remember The Feedback window Empty; Remember on With Remember on, the address you send feedback from is filled in next time.
Port The MCP Server page; see MCP server 47821 The port the MCP server last ran on, used again the next time you start it.