OIPA Config Guard
OIPA Config Guard is an enterprise-grade Visual Studio Code extension engineered to modernize and secure the configuration lifecycle for Oracle Insurance Policy Administration (OIPA). By deeply integrating your local IDE with backend OIPA databases and Git repositories, this extension bridges the gap between rule configuration and strict version control.
The extension operates as an active workspace sentinel—seamlessly enforcing environment boundaries, managing package deployments, and providing real-time visibility into the exact state of your configurations across Development and UAT environments.
Core Capabilities
Strict Version Control & Active File Locking
Config Guard actively intercepts keystrokes to prevent conflicting edits and accidental overrides.
- Read-Only Enforcement: Automatically locks files that are unassigned to a configuration package, actively checked out by another developer, or when the user's session expires. Any unauthorized edits are instantly reverted.
- Smart Assignment: Automatically prompts developers to map unassigned files to existing or new
IvsConfigPackage instances the moment a modification is attempted.
Advanced Release Management
Manage your entire OIPA deployment pipeline without leaving VS Code.
- Lifecycle State Tracking: Filter, search, and migrate configuration packages across their lifecycle states (e.g., Development, Ready to Migrate, Checked-In).
- Automated Migrations: One-click promotions automatically execute the necessary backend synchronization logic (including
ivsconfigpackagecontents mapping) to ensure database integrity during deployments.
UAT Comparison Engine
A dedicated, highly optimized diffing engine built specifically for OIPA environments.
- Side-by-Side Validation: Instantly compare local Development configurations against the live UAT environment.
- Performance-Optimized Indexing: Search and navigate through thousands of environment differences with zero layout thrashing or input lag.
- Visual Delta Tracking: A comprehensive, color-coded tree view instantly highlights additions, deletions, and modifications across the entire rule hierarchy.
Automated Workspace Synchronization
Abstracts away complex Git operations to ensure local environments are always perfectly synced with the master database.
- One-Click Pulls: Securely stashes local work, fetches the latest mainline rules, performs a seamless rebase, and restores the working tree automatically.
- Frictionless Check-Ins: Submits configuration changes through a clean UI, handling commits, merges, and pushes while triggering the necessary remote OIPA save endpoints.
Prerequisites
- Git Tooling: Git must be installed, configured, and accessible via the system PATH.
- Workspace Convention: The target VS Code workspace folder must contain the identifier
oipa-in-vscode (e.g., modal-office-oipa-in-vscode) for proper internal routing.
- Network Access: An active network or VPN connection to the target OIPA application servers is required.
Getting Started
- Authentication: Locate the Login button on the bottom-left of the VS Code Status Bar. Enter your credentials to securely authenticate your session and unlock your assigned packages.
- Synchronize: Before editing, click Sync on the Status Bar. This guarantees your local workspace reflects the exact state of the remote OIPA database.
- Configure & Compare: Open any XML file to begin development. If you are preparing for a release, utilize the Compare with UAT tab to validate your changes against the target environment.
- Deploy: Once your configuration is validated, launch the Check-In process from the Status Bar to securely package and push your ruleset.
Note: To prevent repository corruption and ensure strict OIPA compliance, standard VS Code source control buttons are intentionally suppressed. All synchronization must be performed through the extension's proprietary tooling.
