Skip to main content
Next section


Welcome to the ObjectScript Tutorial!

ObjectScript is a procedural language with distinctive features, the most notable of which is a powerful and flexible data model and storage engine, called globals. InterSystems IRIS® data platform provides multiple data models and APIs for developers. ObjectScript and globals are at the core of it all!

The tutorial has three parts:

  • Part 1 (The Basics) covers standard language elements and introduces the Atelier IDE (Integrated Development Environment).

  • Part 2 (The Good Stuff) covers string and list handling, arrays, and introduces globals.

  • Part 3 (Using Globals) covers globals in depth. It also contains a brief introduction to objects, properties, instance methods, and SQL queries.

Apart from the introductory pages on objects in Part 3, the tutorial covers InterSystems IRIS class definitions only as containers for class methods. The other pages that mention objects are:

  • Part 1, when discussing Try/Catch and Throw. The tutorial covers exception objects along with their important properties and some methods.

  • Part 2, when discussing JSON. The tutorial covers dynamic objects along with some of their methods.

During this tutorial you will write methods (in class definitions) that use many of the features of ObjectScript. You'll use Atelier, the Eclipse-based IDE for InterSystems IRIS. Full documentation for Atelier is available here. You can also do the exercises using the older IDE, Studio (Windows only), but the tutorial assumes you're using Atelier. There will also be examples of using commands and functions shown in the Terminal. You should freely experiment with these examples.

The best way to learn ObjectScript is to do the hands-on exercises that are included throughout this tutorial. In the first few exercises, you'll write code to collect, validate, and store basic data for persons. In later exercises, you'll write code for looking up persons and editing or deleting their data. There are also step-by-step solutions to each exercise, available when you click this picture on an exercise page.

Step by Step Solution

All of the classes used in examples and exercises are available on GitHub in the Samples-ObjectScript repository. You can connect Atelier to the repository, or download it and import the classes into your Atelier workspace. Read Downloading Samples for Use with InterSystems IRIS for general information about samples on GitHub.


This tutorial assumes that you have installed InterSystems IRIS using Minimal security settings. If you have installed using Normal or Locked Down security settings, the Terminal, Atelier, and the Management Portal will require you to authenticate.