Migrate from Studio

Server-Side Editing

You can configure VS Code to edit code directly on a server, which is analogous to Studio’s architecture. However, VS Code enhances this workflow with support for having multiple server-namespaces open at the same time (using VS Code’s multi-root workspace featureOpens in a new tab) and for filtering the files shown for each server-namespace. See the Server-side Editing for more information on how to configure this feature.

Server-Side Source Control

VS Code supports server-side source control without requiring any additional configuration. Server-side source control is supported for both server-side and client-side editing. If a source control class is activeOpens in a new tab, its hooks fire automatically for document lifecycle events like creation, first edit, save and deletion. You can access the server source contol menu in these locations:

• The source control icon (when a document is open)

• An open document’s context menu

• A node in the context menu for the ObjectScript Explorer

• A node in the context menu for the VS Code ExplorerOpens in a new tab.

Server-Side Projects

VS Code supports using existing Studio projects, as well as the creation, modification and deletion of them. See Work with Projects for more information about this feature and how to use it.

Accurate Syntax Coloring

The InterSystems Language Server extensionOpens in a new tab leverages VS Code’s semantic tokens APIOpens in a new tab to provide the same accurate syntax coloring for InterSystems ObjectScript and other embedded languages that Studio users are familiar with. For more information on how to customize the syntax colors for InterSystems tokens, see the Language Server’s READMEOpens in a new tab. InterSystems provides a command for Windows users to migrate their existing color customizations from Studio.

Import Server Definitions Command

The InterSystems Server Manager extensionOpens in a new tab provides the Import Servers from Windows Registry command, which will import any Studio server defintions from your Windows registry into VS Code so you can continue using them without having to do the migration youself.

To invoke the command, open the command paletteOpens in a new tab, find the InterSystems Server Manager: Import Servers from Windows Registry menu option, and run it.

Load Studio Snippets Command

The InterSystems ObjectScript extensionOpens in a new tab provides the Load Studio Snippets command, which will load any user defined snippets from Studio into VS Code. It works by reading the locations of Studio user defined snippets files from the Windows registry, converting the snippets contained in those files to VS Code’s JSON format and lastly writing the snippets to a new global snippets file called isc-studio.code-snippets. This command will only convert snippets for ObjectScript, Class Definition Language (UDL) or HTML; all other snippets are ignored.

To invoke the command, open the command paletteOpens in a new tab, find the ObjectScript: Load Studio Snippets menu option, and run it.

After you load your snippets, InterSystems recommends opening the generated file and enhancing the snippets so that they can fully leverage features available in VS CodeOpens in a new tab which Studio does not support, like tabstops and variable substitution.

You can open the snippets file in two ways:

• Upon loading your snippets, select the Open File button in the success notification box.

• Select the Settings button. Select the Configure User Snippets from the settings menu, and then select the isc-studio.code-snippets file from the drop-down menu.

Load Studio Syntax Colors Command

The InterSystems ObjectScript extensionOpens in a new tab provides the Load Studio Syntax Colors command, which will load the editor background and syntax foreground colors from Studio into VS Code. It works by reading the color configurations from the Windows registry and storing them in VS Code’s User SettingsOpens in a new tab as customizations of one of the InterSystems default themes provided by the Language Server extension. The command uses the background color loaded from Studio to determine which default theme it should modify, and will activate the modified theme automatically. This command will not load foreground colors for any syntax tokens that have a custom background color because per-token background colors are not supported in VS Code. This command requires that the InterSystems Language Server extensionOpens in a new tab is installed and active.

To invoke the command, open the command paletteOpens in a new tab, find the ObjectScript: Load Studio Syntax Colors option, and run it.

New File Commands

The InterSystems ObjectScript extensionOpens in a new tab provides commands for creating new Interoperability classes. Commands are provided for Business Operation, Business Process, Business Rule, Business Service and Data Transformation classes. These commands are modeled after the wizards in Studio’s File > New... > Production menu.

In VS Code, these commands are available by navigating to File > New File..., or by selecting the link on the Get Started welcome page.

Keyboard Shortcuts

In general, VS Code keyboard shortcuts are entirely customizable, as described in the VS Code documentationOpens in a new tab. However, VS Code is pre-configured with a number of shortcuts that match Studio. Download a cheat sheet hereOpens in a new tab.

This section provides mapping tables for Studio users to compare Studio shortcuts with the shortcuts which VS Code provides by default.