Precisely for VS Code

Bring Precisely Data Integration Suite projects into VS Code. Author DSL and Mainframe Replication files, work with your Suite projects and catalog, and monitor project health without leaving your editor.

What You Can Do

Author DSL files with syntax highlighting, completion, hover help, navigation, rename, snippets, formatting, and real-time validation for .dis.yaml files.
Work with Mainframe Replication by editing .sqd and .rpl files with language-aware assistance, then pulling, pushing, refreshing, and managing pipelines from VS Code.
Connect to Suite workspaces across supported regions, securely save credentials, and switch between workspaces from the status bar or Command Palette.
Browse projects and configuration from the Precisely activity bar, including catalog datasources, connections, schemas, tables, and columns.
Synchronize DSL projects with pull, push, staging, revision history, diffs, restore, and guided conflict resolution.
Create and convert projects by starting Mainframe or Advanced Replication projects locally, or converting eligible Continuous Replication projects to Advanced Replication.
Monitor project health with pipeline, table, and file statistics, then refresh data on demand.
Import Connect CDC XML into DISDSL files for continued authoring in VS Code.

Supported Project Types

Project Type	Authoring	Synchronization	Monitoring
Advanced Replication (DSL)	`.dis.yaml`	Pull, push, revisions, and restore	Pipeline and table statistics
Mainframe Replication	`.sqd` and `.rpl`	Pull, push, refresh, and pipeline management	Pipeline and file statistics
Continuous Replication	Read-only conversion preview	—	Pipeline and table statistics

Get Started

Install Precisely from the VS Code Marketplace.
Select the Precisely icon in the Activity Bar.
Run Precisely: Add Workspace and select your Suite region.
Enter your Access Key ID and Secret Key, then select Connect.
Open or create a .dis.yaml, .sqd, or .rpl file, or browse projects from Data Integration.

ℹ️ Note: You need credentials for a Precisely Data Integration Suite workspace. The extension stores credentials in VS Code SecretStorage and refreshes session tokens automatically.

Everyday Workflows

Author and Validate

Open a supported file to activate language features. Use Format Document to format DSL files and fix broken indentation, and use the project context menu to run syntax or full-project validation before you push changes.

Pull, Edit, and Push

Pull a DSL or Mainframe project to a local folder, edit it in VS Code, and push changes from the Data Integration or DI Sync view. The extension detects remote changes and guides you through conflict resolution when needed.

Explore Your Catalog

Open Configuration in the Precisely Activity Bar to browse agents, datasources, connections, schemas, and tables. Copy a resource's full path or drag a dataset into a supported editor.

Common Commands

Command	Description
`Precisely: Add Workspace`	Connect a new Precisely Cloud workspace.
`Precisely: Select Active Workspace`	Switch, log out of, or remove a saved workspace.
`Precisely: Pull Project`	Download a DSL or Mainframe project to a local folder.
`Push to Precisely`	Push staged DSL changes with conflict checks.
`Push Pipeline`	Push all pending changes for a Mainframe pipeline.
`Precisely: Show Revision History`	View, compare, restore, or switch DSL project revisions.
`Precisely: Import XML Project`	Convert a Connect CDC XML model into DISDSL files.
`Precisely: Clear All Data`	Remove extension-managed credentials and local state.

Open the Command Palette with Ctrl+Shift+P on Windows and Linux, or Cmd+Shift+P on macOS, and search for Precisely to see all available commands.

Settings

Open VS Code Settings and search for precisely.

Setting	Default	Description
`precisely.monitoringRefreshMs`	`15000`	Controls the monitoring panel refresh interval in milliseconds.
`precisely.projectsCacheTtlMs`	`300000`	Controls how long the project list remains cached; set `0` to disable caching.
`precisely.pull.defaultProjectsFolder`	Empty	Sets the parent folder used when you pull projects.
`precisely.pull.maxConcurrentDownloads`	`5`	Limits simultaneous project-download requests.
`precisely.logging.level`	`INFO`	Controls the amount of diagnostic information written to the output channel.

Supported Regions

Connect to Suite workspaces in US, EU1, GB1, and AU1.

Privacy and Data

Credentials are stored only in VS Code SecretStorage. The extension does not send telemetry unless you explicitly configure and enable OpenTelemetry export. You can remove all extension-managed data at any time with Precisely: Clear All Data.

Documentation

For workspace setup, project workflows, configuration, and troubleshooting, see the Precisely Cloud User Guide.

Precisely