Serenji

Serenji from George James Software (GJS) is an extension for Visual Studio Code (VSCode), allowing you to browse, edit and debug InterSystems ObjectScript code directly in namespaces of InterSystems environments.

Serenji includes an embedded edition of the Deltanji source code management product from GJS. A separate extension integrates Deltanji as a VSCode source control provider which you can interact with from the Source Control viewlet. Click here for more information about that extension. You can also access Serenji's embedded Deltanji through its web browser UI.

Unless you have disabled VSCode's telemetry feature, this extension will send some usage data to GJS. For more details consult the section below.

Installation

Click here for full instructions for a new installation.

If you are upgrading from a previous version of this extension we normally recommend that you also upgrade the server-side Serenji support code. However on this occasion (3.1.4) we are shipping the 3.1.3 server-side code, so you do not need to reinstall this on servers you have previously connected to from a 3.1.3 client.

Features

Since its debut in 1999 Serenji has built a strong reputation as a code editor and debugger for developers working on the InterSystems platforms. Now Serenji has been re-engineered as a Visual Studio Code extension to provide state-of-the-art browsing, editing and debugging of InterSystems IRIS, Ensemble, Caché and HealthShare source code from Linux, macOS and Windows workstations.

With Serenji you can:

• Browse the contents of namespaces on your InterSystems servers. Explore classes, MAC, INT and INC routines, and web application textfiles (CSP, CSR, js, css etc.).
• Edit classes, routines and web application textfiles directly on the servers without having to export them to your workstation.
• Debug classes and routines by invoking them directly, or debug any kind of running process by attaching to it.
• Debug REST services.
• Set breakpoints and watchpoints.
• Execute code one command at a time, stepping in, out or over each statement.
• View variables at each stack level.
• Use a variety of source control tools seamlessly, including Deltanji. The free Solo edition of Deltanji is bundled with Serenji.

Known Issues

• Datatipping is primitive (#33)
• WRITE commands are not handled well during debugging (#35)
• Non-Deltanji server-side source control providers are not respected (#39)
• Deltanji comment lines written by save do not result in a document reload (#66)

Release Notes

This is version 3.1.4.

See the Changelog for details.

Telemetry

This extension uses the vscode-extension-telemetry module to report usage data to a Microsoft Azure Application Insights (AppInsights) endpoint controlled by George James Software. An example of the custom datapoints:

• common.platformversion 10.0.18363
• common.vscodesessionid someValue.sessionId
• common.vscodemachineid someValue.machineId
• common.vscodeversion 1.43.0-insider
• common.extversion 3.1.3
• common.extname vscode-serenji
• common.os win32
• serverResponse 220 %Serenj831 Version 7.0 + Serenji 3.1.3 (InterSystems platforms)

AppInsights also provides geolocation data.

You can disable all telemetry output from VSCode by setting "telemetry.enableTelemetry": false

Support

Email support@georgejames.com