OHI Studio

OHI Studio streamlines Oracle Health Insurance development by bringing Dynamic Logic (Groovy), Floorplans, Logs, Object exploration, and multi-environment management into VS Code. It is designed for OHI developers, consultants, and support engineers who work with Policies, Claims, and other OHI applications and need a fast inner loop for editing, testing, and deploying artifacts.

• Work directly from your editor: send, fetch, test, preview
• One place to define and switch Environments and Applications
• Rich editor assistance: hover, inlay hints, signature lenses, and object-aware autocomplete
• Built-in logs viewer and trace file reader

Quick Start

1. Open the Environments window

• Command Palette → “OHI: Manage Environments”
• Add an Environment (name + token), then add an Application (name + Base URL; do not include /api)
• Optionally set the Objects Folder Path for that app (folder that directly contains .groovy files)

2. Select target

• Use the status bar left side:
  • OHI Env: Select the active Environment
  • OHI App: Select the active Application

3. Open a file and use commands

• Open a .groovy DyLo file or a floorplan_*.json
• Use editor title actions or context menu to Send / Get / Test (DyLo) or Send / Get / Preview (Floorplan)
• Open “OHI: Query Application Logs” to search logs

What’s included

• DyLos (Groovy)
  • Send, Get, Test endpoints, rich editor assistance (hover, inlay hints, signature CodeLens), object-aware autocomplete
• Floorplans (JSON)
  • Send, Get, and a live preview webview
• View Objects
  • Searchable viewer of your .groovy data model and Signatures, with cross-links
• API Browser
  • API/IP entity explorer with cached listing, definition table, and Swagger metadata viewer
• Logs
  • Unified logs viewer for Application and Dynamic Logic events, with trace file modal viewer
• Environments Management
  • Full create/edit/delete for envs and apps in a dedicated window; quick selection in status bar

Entities and Features

Below each feature, minimum requirements and relevant settings are highlighted to stand out.

DyLos (Groovy)

Actions

• OHI: Send Dynamic Logic — updates the DyLo on the server
• OHI: Get Dynamic Logic — fetches the DyLo and replaces editor content
• OHI: Test Dynamic Logic — runs code against /api/testdynamiclogic/{key}

Editor assistance

• “📖” inlay hints on signature headers; recognized object variables are highlighted inline with a rounded rectangle (color customizable)
• Hover tooltips linking to related Objects/Signatures
• Signature input variables shown as a CodeLens on the next line
• Object-aware autocomplete: properties/methods from your Objects folder

⚠ REQUIREMENTS

• Environment and Application selected (status bar)
• Valid token configured for the selected environment
• For object-aware autocomplete/links: Application’s Objects Folder Path must point to a folder that directly contains .groovy files (you can set it in the Environments window or via “OHI: View Objects” on first use)
• For signature CodeLens visibility: VS Code “Editor: Code Lens” must be enabled
• For inlay hints visibility: VS Code “Editor: Inlay Hints” must be enabled
• For hovers: VS Code “Editor > Hover: Enabled” must be enabled

🔧 SETTINGS (ohiStudio)

• confirmBeforeSend (boolean, default true)
• confirmBeforeGetReplace (boolean, default true)
• preferFilenameKey (boolean, default true) — derive DyLo key from filename when available
• api.pathTemplate.dynamicLogic (string, default “/api/generic/dynamiclogic/key/${key}”)
• testDynamicLogic.confirmBeforeTest (boolean, default true)
• testDynamicLogic.sendBeforeRun (boolean, default true)
• features.bookHintsEnabled (boolean, default true) — toggle “📖” inlay hints
• features.hoverEnabled (boolean, default true) — toggle hover tooltips
• features.signatureGhostEnabled (boolean, default true) — toggle signature CodeLens/ghost
• features.objectsAutocompleteEnabled (boolean, default true) — toggle object-aware autocomplete
• http.verifySSL (boolean, default true)
• http.timeoutMs (number, default 20000)

Notes

• If a token is expired, you will be prompted to refresh it.
• DyLo key is determined by filename or “-- Name:” header (depending on preferFilenameKey).
• Object-aware autocomplete and hovers depend on a valid Objects Folder Path.
• To customize the variable highlight color, run “OHI: Pick Object Highlight Color” (updates ohiStudio.features.objectTokenHighlightColor).

Floorplans (JSON)

Actions

• OHI: Send Floorplan — updates floorplan on the server
• OHI: Get Floorplan — fetches floorplan into the editor
• OHI: Preview Floorplan — webview that renders a quick layout (searches, actions, sections, tabs, etc.)

⚠ REQUIREMENTS

• Environment and Application selected (status bar)
• Valid token configured
• A floorplan_.json (or floorplans_.json) file is open to use these commands

🔧 SETTINGS (ohiStudio)

• confirmBeforeSend (boolean, default true)
• confirmBeforeGetReplace (boolean, default true)
• api.pathTemplate.floorplan (string, default “/api/generic/floorplans/key/${key}”)
• http.verifySSL (boolean, default true)
• http.timeoutMs (number, default 20000)

Notes

• The preview is a convenience visualization and not a full runtime emulator.

API Browser (APIs / IPs)

What it does

• Lists APIs and Integration Points from cache when available; fetches/refreshes from environment when cache is missing or expired
• Shows definition tables with sticky header/field column, breadcrumb navigation, and reference links to nested definitions
• Renders enum valid values with meaning (x-oi-meaning) in the definition table
• Provides metadata Swagger view with operation colors, default media type control, and operations collapsed by default
• Supports copy-to-clipboard actions for request/sample payloads with in-app confirmation toasts
• Cross-links with View Objects:
  • In API definition view, shows “View Object” when the matching object is loaded
  • In View Objects, shows “View API definition” when a matching API/IP exists in cache

Open with

• OHI: API Browser

⚠ REQUIREMENTS

• Environment and Application selected (status bar)
• Valid token configured
• Server endpoints reachable from your machine

🔧 SETTINGS (ohiStudio)

• apiBrowser.entitiesCacheTtlMinutes (number, default 60) — cache TTL in minutes (0 disables caching)

Notes

• Cache refresh events display a notification in the browser window.
• “View API definition”/“View Object” buttons appear only when both data sources are available (cache + objects).

View Objects

What it does

• Parses your local .groovy data model (and optional signatures) and provides a searchable, interactive viewer
• Cross-links properties and signature parameter types so you can navigate across classes

How to open

• OHI: View Objects (interactive viewer)
• Inlay hint / Hover / CodeLens links → “Open Objects for Class”
• OHI: Set Objects Folder Path

⚠ REQUIREMENTS

• Environment and Application selected (status bar)
• Application’s Objects Folder Path must be set to a folder that directly contains the datamodel .groovy files
  • Generated from /api/objects/generate
  • If missing, you will be prompted to select it

🔧 SETTINGS (ohiStudio)

• features.objectsAutocompleteEnabled (boolean, default true) — impacts editor suggestions (not the viewer itself)
• features.bookHintsEnabled / hoverEnabled / signatureGhostEnabled — impact editor assistance that links into the viewer

Notes

• If you have a “signatures” subfolder under your objects folder, signature files will be parsed to show input parameters.
• “View API definition” appears when the selected class matches an API/IP entity in API Browser cache.

Logs

What it does

• Unified viewer for Application and Dynamic Logic events with date-range search
• Message filter and DyLo code filter (when viewing dynamic logic events)
• “View Trace File” link opens a modal and fetches the remote trace log securely

Open with

• OHI: Query Application Logs

⚠ REQUIREMENTS

• Environment and Application selected (status bar)
• Valid token configured
• Server endpoints reachable from your machine

🔧 SETTINGS (ohiStudio)

• logs.apiPath.applicationEvents (string, default “/api/generic/logapplicationevents/search”)
• logs.apiPath.dynamicLogicEvents (string, default “/api/generic/logdynamiclogicevents/search”)
• logs.pageSize (number, default 50)
• logs.serverTimeZone (string, default “Asia/Manila”)
• http.verifySSL (boolean, default true)
• http.timeoutMs (number, default 20000)

Notes

• Supports pagination (Load More).
• Highlights certain patterns to improve readability, e.g., OHI class lines in stack traces.

Environments Management

What it does

• Dedicated window to create/edit/delete Environments and Applications
• Set per-environment token, custom auth header name/value template, and server timezone
• Configure OAuth auto-token acquisition per environment (password grant)
• Set per-application Base URL and Objects Folder Path
• Status bar selectors to switch active Environment and Application

Open with

• OHI: Manage Environments
• OHI: Select Active Environment
• OHI: Select Active Application
• OHI: Acquire/Refresh Token

⚠ REQUIREMENTS

• None (this window is how you initially configure everything)

🔧 SETTINGS (ohiStudio)

• auth.headerName (string, default “Authorization”)
• auth.headerValueTemplate (string, default “Bearer ${token}”)
• auth.tokenMaxAgeMinutes (number, default 60)
• logs.serverTimeZone (string, default “Asia/Manila”) — global default, can be overridden per environment

Notes

• Tokens are stored in VS Code Secret Storage under an environment-specific key.
• OAuth fields available in each environment:
  • OAuth Token URL
  • OAuth Client ID
  • OAuth Scope (optional)
  • Username
  • Client Secret (stored securely)
  • Password (stored securely)
• OHI: Acquire/Refresh Token (or the Acquire Token button in Manage Environments) uses OAuth grant_type=password and stores the returned access_token as the environment token.
• Changing settings or feature toggles refreshes providers immediately; no reload needed.

Configuration Reference (selected)

HTTP and Auth

• ohiStudio.http.verifySSL (boolean, default true)
• ohiStudio.http.timeoutMs (number, default 20000)
• ohiStudio.auth.headerName (string, default “Authorization”)
• ohiStudio.auth.headerValueTemplate (string, default “Bearer ${token}”)
• ohiStudio.auth.tokenMaxAgeMinutes (number, default 60)

Dynamic Logic and Floorplans

• ohiStudio.confirmBeforeSend (boolean, default true)
• ohiStudio.confirmBeforeGetReplace (boolean, default true)
• ohiStudio.preferFilenameKey (boolean, default true)
• ohiStudio.api.pathTemplate.dynamicLogic (string, default “/api/generic/dynamiclogic/key/${key}”)
• ohiStudio.api.pathTemplate.floorplan (string, default “/api/generic/floorplans/key/${key}”)

Testing and Logs

• ohiStudio.testDynamicLogic.confirmBeforeTest (boolean, default true)
• ohiStudio.testDynamicLogic.sendBeforeRun (boolean, default true)
• ohiStudio.logs.apiPath.applicationEvents (string)
• ohiStudio.logs.apiPath.dynamicLogicEvents (string)
• ohiStudio.logs.pageSize (number, default 50)
• ohiStudio.logs.serverTimeZone (string, default “Asia/Manila”)

Editor Feature Toggles (default: enabled)

• ohiStudio.features.bookHintsEnabled — inlay “📖” hints
• ohiStudio.features.hoverEnabled — hover tooltips
• ohiStudio.features.signatureGhostEnabled — signature variables CodeLens/ghost
• ohiStudio.features.objectsAutocompleteEnabled — object-aware autocomplete
• ohiStudio.features.objectTokenHighlightEnabled — inline object token highlighting
• ohiStudio.features.objectTokenHighlightColor — token highlight color

Completions

• ohiStudio.features.completions.keywordsEnabled — keyword/common-word suggestions
• ohiStudio.features.completions.inFileSymbolsEnabled — symbols from current Groovy file
• ohiStudio.features.completions.snippetsForMethods — method-call snippets with placeholders

API Browser and Objects

• ohiStudio.apiBrowser.entitiesCacheTtlMinutes (number, default 60)
• ohiStudio.objects.folderPath (string, absolute folder path to generated objects)

General

• ohiStudio.showOutputBox (boolean, default false)

Utility Commands

• OHI: Show Output Channel — opens the “OHI Studio” output channel
• OHI: Set Objects Folder Path — sets/updates the local generated objects folder
• OHI: Open Objects for Class — opens the objects viewer directly for a class
• OHI: Pick Object Highlight Color — visual picker for object token highlighting

❤️ Buy me a coffee

If OHI Studio saves you time and boosts your productivity, consider supporting its development!

• Buy me a coffee: https://buymeacoffee.com/seththefirst

🛡 Security

• Tokens are stored securely via VS Code Secret Storage (per environment).
• Authentication headers are masked in logs.
• Avoid disabling TLS (ohiStudio.http.verifySSL) in production environments.

Troubleshooting

• 401/403 Unauthorized: Your token may be expired; you’ll be prompted to refresh it.
• 404 Not Found: Verify the Application’s Base URL in Manage Environments.
• SSL errors in dev: Set ohiStudio.http.verifySSL to false (not recommended for production).
• Check the “OHI Studio” Output channel for HTTP details and errors.