ISC Test Case Runner - VS Code Extension

Build: 413

Execute ISC test cases by remotely connecting to your ISC tenant directly from VS Code.

Features

• Run test cases with the play button in the editor title bar (visible on *.isctf.json files)
• Run individual commands via the context menu or inline CodeLens actions

Requirements

• Java 17 or later must be installed and accessible in your PATH
• A connection-properties.json file must exist in your workspace root (see setup below)

To verify your Java installation, run the following in a terminal:

java -version

Expected output (version must be 17 or higher):

openjdk version "17.0.x" ...

Installation

The extension is distributed as a .vsix file. To install it in VS Code:

Option 1 — VS Code UI

1. Open VS Code
2. Go to the Extensions view (Ctrl+Shift+X)
3. Click the ... menu (top-right of the Extensions panel)
4. Select Install from VSIX...
5. Browse to the .vsix file and click Install

Option 2 — Command Line

code --install-extension path/to/isc-test-case-runner-x.x.x.vsix

After installation, reload VS Code when prompted.

Setup

1. Create connection-properties.json

Create a file named connection-properties.json in the root of your workspace with the following content:

{
    "connections": [
        {
            "name": "main",
            "iscUrl": "https://<your-tenant>.api.identitynow-demo.com",
            "clientId": "<your-client-id>",
            "clientSecret": "<your-client-secret>"
        }
    ],
    "testCaseApiVersion": "v2025"
}

Replace the placeholder values with your actual ISC tenant details:

Note: The extension will automatically create a connection-properties.json with placeholder values the first time you open a JSON file, if the file does not already exist. Make sure to replace the placeholders before running any test cases.

You can define multiple connections in the connections array and reference them by name from your test case files.

2. Run a Test Case

1. Open a *.isctf.json test case file in VS Code
2. Click the play button (▶) in the editor title bar to run the full test case, or use the inline CodeLens buttons to run individual commands
3. View results in the Java Executor output channel

ISCAT Library

The extension doesn't contain the ISCAT Java library. It downloads it from Artifactory into your project the first time you run something, and keeps it up to date.

Before the first run: run ISCAT: Set Artifactory Token from the Command Palette (Ctrl+Shift+P) and paste a JFrog access or reference token with read access to the iscat-generic-iscatLibsWithDep-release-local repository. The token is kept in VS Code's secret storage, not in your settings. If no token is set, you're asked for one on the first run.

How updates work:

• The library is installed into lib/ in your workspace. This is set by javaFileExecutor.libDir. If your project uses git, you're offered to add that folder to .gitignore.
• Artifactory is asked for a new version at most once a day. This is set by javaFileExecutor.updateCheckIntervalHours, and the check is shared across all your projects. The library is only downloaded (about 100 MB) when the version changes.
• To pin a version, set javaFileExecutor.libraryVersion to e.g. 1.4.0. A pinned version that is already installed never contacts Artifactory.
• ISCAT: Check for Library Updates checks immediately.
• The status bar shows the installed version. Click it for more options.
• When you're offline, or Artifactory is unreachable, the installed version keeps working.

Snapshot builds: set javaFileExecutor.libraryChannel to dev to follow development builds from iscat-generic-iscatLibsWithDep-dev-local. This needs read access to that repository. A new build of the same snapshot version is detected and downloaded again.

Using a local build (development): set javaFileExecutor.classPathDirs to the folders holding your jars. The classpath is then built from exactly those folders, nothing is downloaded, and the status bar shows ISCAT: local.

Project Structure

<workspace root>/
├── connection-properties.json   ← required, created automatically with placeholders
├── lib/                         ← ISCAT library, downloaded automatically (add to .gitignore)
└── *.isctf.json                 ← your test case files