This application is not supported by InterSystems Corporation. Please be notified that you use it at your own responsibility.

What's new in this version

Initial Release

Gitter Quality Gate Status Reliability Rating

License: MIT


I have described the inspiration for this project here - Article

Online Demo

You can find online demo here - User Export or Management Portal


This repository provides a ready-to-go development environment for coding productively with InterSystems ObjectScript. This template: * Runs InterSystems IRIS Community Edition in a docker container * Creates a new namespace and database IRISAPP * Loads the ObjectScript code into IRISAPP database using Package Manager * Promotes development with the 'Package First' paradigm. Watch the video * Provides a unit testing environment: sample unit tests, tests module enablement * Ready for embedded python development: ENV varialbes are set up, CallIn service is On, all modules in requirements.txt will be installed during docker build.


Start a new dev repository with InterSystems IRIS using this one as a template. Once you clone the new repo to your laptop and open VSCode (with the InterSystems ObjectScript Extension Pack installed) you'll be able to start development immediately.


Make sure you have git and Docker desktop installed.


Clone/git pull the repo into any local directory

$ git clone

Open the terminal in this directory and call the command to build and run InterSystems IRIS in container: Note: Users running containers on a Linux CLI, should use "docker compose" instead of "docker-compose" See Install the Compose plugin

$ docker-compose up -d

To open IRIS Terminal do:

$ docker-compose exec iris iris session iris -U IRISAPP IRISAPP>

To exit the terminal, do any of the following:

Enter HALT or H (not case-sensitive)

What does it do

THe sample repository contains two simplest examples of ObjectScript classes: ObjectScript method that returns value and method that creates a persistent record.

  1. Open IRIS terminal and run the ObjectScript Test() method to see if runs the script and returns values from IRIS:

$ docker-compose exec iris iris session iris -U IRISAPP IRISAPP>write ##class(dc.sample.ObjectScript).Test() It works! 42

  1. Class dc.sample.PersistentClass contains a method CreateRecord that creates an object with one property, Test, and returns its id.

Open IRIS terminal and run:

IRISAPP>write ##class(dc.sample.PersistentClass).CreateRecord(.id) 1 IRISAPP>write id 1

In your case the value of id could be different. And it will be different with every call of the method.

You can check whether the record exists and try to right the property of the object by its id.

IRISAPP>write ##class(dc.sample.PersistentClass).ReadProperty(id) Test string

What is next?

Add or update %ZSTART routine to import User data. I have implemented the User import as a task previously. More details to come.

How to start the development

This repository is ready to code in VSCode with the ObjectScript plugin.

Install VSCode, Docker and the InterSystems ObjectScript Extension Pack plugin and open the folder in VSCode.

Open the /src/cls/PackageSample/ObjectScript.cls class and make changes - it will be compiled in the running IRIS docker container.


Feel free to delete the PackageSample folder and place your ObjectScript classes in the form /src/organisation/package/Classname.cls

Read more about folder setup for InterSystems ObjectScript and here on the naming convention

Running unit tests

The template contains two test classes: TestObjectScript.cls and TestPersistentClass.cls

To run the unit tests we can use the Package Manager environment.

``` IRISAPP>zpm

============================================================================= || Welcome to the Package Manager Shell (ZPM). || || Enter q/quit to exit the shell. Enter ?/help to view available commands || ============================================================================= zpm:IRISAPP>load /irisrun/repo

[dc-sample-template] Reload START (/irisrun/repo/) [dc-sample-template] Reload SUCCESS [dc-sample-template] Module object refreshed. [dc-sample-template] Validate START [dc-sample-template] Validate SUCCESS [dc-sample-template] Compile START [dc-sample-template] Compile SUCCESS [dc-sample-template] Activate START [dc-sample-template] Configure START [dc-sample-template] Configure SUCCESS [dc-sample-template] MakeDeployed START [dc-sample-template] MakeDeployed SUCCESS [dc-sample-template] Activate SUCCESS zpm:IRISAPP>test dc-sample-template

[dc-sample-template] Reload START (/irisrun/repo/) [dc-sample-template] Reload SUCCESS [dc-sample-template] Module object refreshed. [dc-sample-template] Validate START [dc-sample-template] Validate SUCCESS [dc-sample-template] Compile START [dc-sample-template] Compile SUCCESS [dc-sample-template] Activate START [dc-sample-template] Configure START [dc-sample-template] Configure SUCCESS [dc-sample-template] MakeDeployed START [dc-sample-template] MakeDeployed SUCCESS [dc-sample-template] Activate SUCCESS [dc-sample-template] Test STARTIt works!

Use the following URL to view the result:$NAMESPACE=IRISAPP All PASSED

[dc-sample-template] Test SUCCESS zpm:IRISAPP> ```

In case of test errors, you can find more details back in the UnitTest portal, which can be easily opened via ObjectScript menu in VSCode:

vscvode unittest

What else is inside the repository

.github folder

Contains two GitHub actions workflows: 1. github-registry.yml Once changes pushed to the repo, the action builds the docker image on Github side and pushes the image to Github registry that can be very convenient to further cloud deployement, e.g. kubernetes. 2. objectscript-qaulity.yml with every push to master or main branch the workflow launches the repo test on objectscript issues with Objectscript Quality tool, see the examples. This works if the repo is open-source only.

Both workflows are repo agnostic: so they work with any repository where they exist.

.vscode folder

Contains two files to setup vscode environment:


Settings file to let you immediately code in VSCode with VSCode ObjectScript plugin)


Config file if you want to debug with VSCode ObjectScript

src folder

Contains source files. src/iris contains InterSystems IRIS Objectscript code

tests folder

Contains unit tests for the ObjectScript classes

Contains a set of useful commands that will help during the development


A docker engine helper file to manage images building and rule ports mapping an the host to container folders(volumes) mapping


The simplest dockerfile which starts IRIS and imports code from /src folder into it. Use the related docker-compose.yml to easily setup additional parametes like port number and where you map keys and host folders.


Contains objectscript commands that are feeded to iris during the image building


IPM Module's description of the code in the repository. It describes what is loaded with the method, how it is being tested and what apps neeed to be created, what files need to be copied.

Read about all the files in this artilce


If you have issues with docker image building here are some recipes that could help.

  1. You are out of free space in docker. You can expand the amount of space or clean up maually via docker desktop. Or you can call the following line to clean up: docker system prune -f

  2. We use multi-stage image building which in some cases doesn't work. Switch the target to builder from final in the docker compose and try again.

4.5 (1)
ObjectScript quality test
Updated on 11 December 2023
ObjectScript quality report
Developer Environment
Works with
InterSystems IRIS
Last updated