omnistudio-datapacks-deploy
Salesforce Industries DataPack deployment automation using Vlocity Build. Export, validate, deploy, retry, and compare OmniStudio/Vlocity DataPacks with predictable workflow guardrails.
Features
- DataPack Deployment Workflow: Run
packExport, packDeploy, packRetry, packContinue, and packGetDiffs
- Job File Guidance: Build deterministic
projectPath, expansionPath, queries, and manifest job patterns
- Validation-First Operations: Gate deployment with
validateLocalData and dependency checks
- Failure Triage: Diagnose matching-key, GlobalKey, dependency, and configuration drift failures
- CI/CD Patterns: Support manifest-driven and git-aware deployment sequencing
Usage
Invoke this skill when working with OmniStudio/Vlocity DataPack deployments:
Skill: omnistudio-datapacks-deploy
Request: "Deploy my OmniStudio DataPacks to UAT using Vlocity Build and include retry guidance."
Common Operations
| Operation |
Example Request |
| Export |
"Export DataPacks from source org with this job file." |
| Validate local files |
"Run pre-deploy validation and identify key issues." |
| Deploy |
"Deploy DataPacks to target org using packDeploy." |
| Retry failures |
"Run packRetry and summarize what remains." |
| Resume interrupted run |
"Continue the failed deployment job." |
| Compare with target |
"Run packGetDiffs and report drift." |
Key Commands
# Validate local DataPack integrity
vlocity -sfdx.username [sourceAlias] -job [jobFile].yaml validateLocalData
# Export from source
vlocity -sfdx.username [sourceAlias] -job [jobFile].yaml packExport
# Deploy to target
vlocity -sfdx.username [targetAlias] -job [jobFile].yaml packDeploy
# Retry failed DataPacks
vlocity -sfdx.username [targetAlias] -job [jobFile].yaml packRetry
# Continue interrupted execution
vlocity -sfdx.username [targetAlias] -job [jobFile].yaml packContinue
# Compare local files to target org
vlocity -sfdx.username [targetAlias] -job [jobFile].yaml packGetDiffs
Best Practices
| Rule |
Details |
| Validate first |
Run validateLocalData before deploy |
| Keep scope minimal |
Prefer manifest/key-scoped deploys for safer rollouts |
| Retry intentionally |
Use packRetry while error count is decreasing |
| Preserve key strategy |
Keep matching keys and GlobalKeys consistent across orgs |
| Compare post-deploy |
Run packGetDiffs to verify target parity |
Cross-Skill Integration
| Related Skill |
When to Use |
| platform-metadata-deploy |
Deploy non-DataPack Salesforce metadata with sf project deploy |
| omnistudio-omniscript-generate |
Author OmniScripts before deployment |
| omnistudio-flexcard-generate |
Build FlexCards before deployment |
| omnistudio-integration-procedure-generate |
Build Integration Procedures before deployment |
| platform-apex-logs-debug |
Investigate runtime/triggers/log failures surfaced during deploy |
Documentation
Requirements
- Node.js 18+
- Vlocity Build CLI (
npm install --global vlocity)
- Salesforce CLI v2 (for org auth and context)
- Source and target org access
