ITAS Integration
ITAS Integration is a VS Code extension for uploading selected local Salesforce, Vlocity, or RLM folders to the ITAS API. The server-side ITAS API handles the Git/Jira workflow, including staging files on Linux, creating or updating the predefined branch, and processing the related Jira story.
Features
- Adds an ITAS Branch button to the VS Code status bar.
- Opens a workflow form for project key, user story number, component type, and requested by.
- Lets developers select one or more folders from the current workspace.
- Creates a ZIP from only the selected folders.
- Preserves workspace-relative paths inside the ZIP.
- Uploads the ZIP to the existing ITAS API URL and endpoint.
- Shows success or failure messages returned by the API.
Branch rule
Branch naming is handled by the ITAS API.
feature/<PROJECT_KEY>-<STORY_NUMBER>
Example:
Project Key: TR
Story Number: 37
Branch: feature/TR-37
Requirements
- VS Code 1.95.0 or newer.
- Node.js and npm for development/building.
- ITAS Spring Boot API running at the configured URL.
Extension settings
Open VS Code settings and search for ITAS Integration.
| Setting |
Default |
Description |
itasintegration.apiBaseUrl |
http://localhost:8080 |
Base URL of the ITAS Spring Boot API. |
itasintegration.apiKey |
empty |
Optional API key sent as X-ITAS-API-KEY. |
itasintegration.defaultProjectKey |
TR |
Default project key shown in the form. |
itasintegration.maxUploadMb |
100 |
Maximum ZIP upload size in MB. |
The API URL has been left as-is:
{
"itasintegration.apiBaseUrl": "http://localhost:8080"
}
API endpoint used
The extension uploads to:
POST /api/workflow/upload-and-process
The full URL is built from:
itasintegration.apiBaseUrl + /api/workflow/upload-and-process
With the default setting, that becomes:
http://localhost:8080/api/workflow/upload-and-process
Usage
- Open the workspace that contains your Salesforce, Vlocity, or RLM files.
- Click ITAS Branch from the VS Code status bar.
- Enter the project key, story number, component type, and requested by value.
- Click Select Folders and Upload.
- Select one or more folders from the current workspace.
- Wait for the ITAS API response.
ZIP path behavior
The ZIP preserves paths relative to the VS Code workspace root.
Example workspace:
my-project/
force-app/main/default/classes/MyClass.cls
vlocity/Product2/Test.json
If the developer selects:
force-app/main/default/classes
The ZIP contains:
force-app/main/default/classes/MyClass.cls
Excluded folders and files
The extension skips common development/build folders and upload artifacts:
.git
node_modules
target
dist
build
.sfdx
.sf
.vscode-test
*.zip
*.log
Development
npm install
npm run compile
code .
Press F5 in VS Code to open the Extension Development Host.
Package as VSIX
npm install -g @vscode/vsce
npm run compile
vsce package
Publish to VS Code Marketplace
Make sure the publisher value in package.json matches your Marketplace publisher ID.
vsce login <publisher-id>
vsce publish
License
MIT
