skills.rest
intersystems-community
intersystems-communityOFFICIAL
Explore all skills by this author →
WebsiteGitHub

iris-vscode-objectscript

Configure VSCode ObjectScript development against InterSystems IRIS via Atelier REST.

27|10|Updated Apr 21, 2026
Search Tags:#vscode#configuration#csp#iris#objectscript#atelier#webgateway
One-click install
npx skills add https://github.com/intersystems-community/iris-agentic-dev --skill iris-vscode-objectscript
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: iris-vscode-objectscript
Source: https://github.com/intersystems-community/iris-agentic-dev/tree/main/light-skills/skills/iris-vscode-objectscript
Command: npx skills add https://github.com/intersystems-community/iris-agentic-dev --skill iris-vscode-objectscript

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of configuring VSCode for ObjectScript development when the Atelier REST API port and enterprise web server setup are tricky, leading to time-wasting 404s, auth failures, or dead connections.

Core Features & Use Cases

  • Correct VSCode server configuration: Sets up intersystems.servers so VSCode can call Atelier with the right host, port, and credentials.
  • Enterprise IRIS compatibility via webgateway: Provides a working container pattern for enterprise images that have WebServer=0, including the correct way to route CSP requests.
  • Connection troubleshooting that matches real failure modes: Targets common issues like hitting the wrong port, missing CSP credentials, and misconfigured Apache directives.

Quick Start

Ask your AI assistant to configure your VSCode intersystems.servers for the IRIS Atelier endpoint by using port 52773 for direct community images, or by setting up the enterprise webgateway pattern and validating the connection with the Atelier version check.

Frequently Asked Questions about iris-vscode-objectscript

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure VSCode for InterSystems IRIS ObjectScript development?▼

To configure VSCode for ObjectScript, set up the `intersystems.servers` settings with the correct IRIS host, port, and credentials to enable reliable Atelier REST connectivity.

Why does my VSCode Atelier connection fail with a 404 or authentication error?▼

Atelier connection failures often stem from hitting the wrong port, missing CSP credentials, or misconfigured Apache directives. Verify HTTP authentication against the `/api/atelier/` endpoint to resolve this.

Do I need a webgateway to connect VSCode to enterprise IRIS images?▼

Yes, enterprise IRIS images with `WebServer=0` require a webgateway container pattern to correctly route CSP and Atelier REST requests for VSCode connectivity.

What port should I use for VSCode intersystems.servers settings with local IRIS containers?▼

For direct community IRIS images, use port 52773 in your VSCode `intersystems.servers` settings to ensure the Atelier REST API is reachable.

How can I verify that my VSCode Atelier REST connection is working properly?▼

Validate your Atelier REST connection by performing an HTTP authentication check against the `/api/atelier/` endpoint, which confirms correct credential routing and port selection.

What is the difference between port 1972 and 52773 for IRIS Atelier connectivity?▼

Port 52773 is typically used for direct web access and Atelier REST connectivity in community images, whereas 1972 is the superserver port; using the wrong one causes dead connections.

Related Skills

Explore More Software Engineering Skills→
intersystems-communityintersystems-community
27

irishealth-container

Configure IRIS Health and AI Hub container web server paths for Atelier REST.

Official
Advanced
sorodriguezzsorodriguezz

Orientation Guide for Server-Side Programming

Explain server-side programming with ObjectScript and Python in InterSystems IRIS.

Community
Intermediate
linguistic76linguistic76
2

docker

Explain SKUEL Docker compose configurations, Dockerfile conventions, and startup sequences.

Community
Advanced
sorodriguezzsorodriguezz

Using the Native SDK for Java

Call ObjectScript methods and manage global arrays from Java.

Community
Advanced