Get to Know the User Interface for the InterSystems ObjectScript Extension Pack

Explorer View Context Menu Enhancements

The Explorer view is a standard VS Code view which allows you to view and organize directories and files within your open workspace. Access the Explorer view by selecting the Explorer button from the Activity Bar.

The InterSystems extension pack adds the following items to context menus within this view:

• Add Server Namespace to Workspace... in the context menu of folders

• Import and Compile in the context menu of folders and files when a workspace is connected to an InterSystems server for client-side editing.

• Import Without Compilation in context menu of folders and files when a workspace is connected to an InterSystems server for client-side editing.

• Server Command Menu... — Allows you to select a command from menus which are defined by a source control class on the server.

• Server Source Control... — Allows you to select a command from menus which are defined by a source control class on the server.

InterSystems View Container

The InterSystems extension pack provides most of the capabilities necessary to support development within the InterSystems view container. To access the InterSystems view container, select the InterSystems button in the Activity bar.

By default, the InterSystems view container includes three views, as illustrated in the following screenshot:

These views include:

1. The InterSystems Servers view, which you can use to manage connections to your InterSystems servers and add server-side virtual folders to your workspace.

2. The ObjectScript Explorer view, which you can use to explore files on a connected InterSystems server.

3. The InterSystems Projects Explorer view, which you can use to create, manage, and explore projects. For more information on using this view, see Work with Projects.

When there is no workspace open in the Explorer, only the InterSystems Servers view is available. Connect to an InterSystems server or open a document within the Explorer to display the ObjectScript Explorer and InterSystems Projects Explorer.

InterSystems Servers

This view displays a directory tree outlining the contents of servers for which you have configured connection profiles, as illustrated by the following image:

The view groups servers into a several folders: servers currently in use, user-defined favorites, and servers which have been recently used. Within the view, you can perform operations on the servers. When you move the cursor over a server listing, command buttons appear which let you mark the server as a favorite, open the server’s Management Portal in VS Code’s built-in Simple Browser, or open the server’s Management Portal in an external browser, as illustrated by the following images:

When you move the cursor over a namespace within a server, command buttons appear which let you add a server-side virtual folder for that namespace within your current workspace, as illustrated by the following image:

Server Context Menu

Servers listed in the InterSystems Server view provide a context menu which includes options to refresh the server, edit the settings.json specification for the server, and set the color of the icon for the server in the tree view, as illustrated by the following image:

Notes About the VS Code Simple Browser

Note:

The Simple Browser uses iframes to embed web pages within VS Code. Beginning with InterSystems IRIS 2024.1, the Management Portal restricts iframe embedding. This means that if your server version is InterSystems IRIS 2024.1 or later, the Open Management Portal in Tab button does not work. The Open Management Portal in External Browser button is unaffected.

Only one Simple Browser tab can be open at a time, so launching a second server’s Management Portal replaces the previous one.

To use the Simple Browser when the server version is between InterSystems IRIS 2020.1.1 and InterSystems IRIS 2023.3, you need to change a setting on the suite of web applications that implement Management Portal. The Simple Browser is not permitted to store the Portal’s session management cookies, so the Management Portal must be willing to fall back to using the CSPCHD query parameter mechanism.

To do so:

1. In Management Portal, select System Administration > Security > Applications > Web Applications.

2. Enter /csp/sys in the filter field to find the web applications which have paths beginning with /csp/sys.

   

3. For each application:

   1. Select the link in the Name column to edit the application definition.

   2. In the section labeled Session Settings, change the value of Use Cookie for Session from Always to Autodetect.

      

   3. Select Save to save the change.

This change should not affect the use of session cookies on ordinary browsers.

Server Connection Status Bar

The connection status of the current server can be seen in the VS Code status barOpens in a new tab. If the server connection is active, the connected server and namespace will be shown in the status bar. If the server connection info is defined in the intersystems.servers settings object, the name of the server and namespace appears:

Otherwise, the host, port, and namespace appear:

Hover over the status bar item to see more detailed connection information, like a full connection URL and the username of the connection. Click on the status bar item to open the Server Actions menu.

If the server connection is inactive, the status bar displays the connection info or the word ObjectScript will be shown, along with an error or warning icon:

Hover over the status bar item to see more detailed error information. Click on the status bar item to open a menu that will help you activate your connection.