sf-vlocity-build-deploy

Salesforce Industries DataPack deployment automation using Vlocity Build. TRIGGER when: user deploys or validates OmniStudio/Vlocity DataPacks with vlocity commands (packDeploy/packRetry/packExport/packGetDiffs), sets up DataPack CI/CD pipelines, or troubleshoots DataPack migration errors. DO NOT TR

By jaganpro · 804 installs

npx skills add jaganpro/sf-skills --skill sf-vlocity-build-deploy

Source repository · Upstream listing

sf vlocity build deploy: Vlocity Build DataPack Deployment Use this skill when the user needs Vlocity DataPack deployment orchestration : export/deploy workflow, manifest driven deploys, failure triage, and CI/CD sequencing for OmniStudio/Industries DataPacks. When This Skill Owns the Task Use sf vlocity build deploy when work involves: vlocity packDeploy , packRetry , packContinue , packExport , packGetDiffs , validateLocalData DataPack job file design ( projectPath , expansionPath , manifest , queries ) org to org DataPack migration and retry loops troubleshooting DataPack dependency, matching key, and GlobalKey issues Delegate elsewhere when the user is: deploying standard metadata with sf project deploy [sf deploy](../sf deploy/SKILL.md) building OmniScripts, FlexCards, IPs, or Data Mappers sf industry commoncore designing Product2 EPC bundles [sf industry cme epc model](../sf industry cme epc model/SKILL.md) writing Apex/LWC code [sf apex](../sf apex/SKILL.md), [sf lwc](../sf lwc/SKILL.md) Critical Operating Rules Use Vlocity Build ( vlocity ) commands for DataPacks, not sf project deploy . Prefer Salesforce CLI auth integration ( sfdx.username <alias ) over username/password files when available. Always run a pre deploy quality gate before full deploy: 1) validateLocalData 2) optional packGetDiffs 3) then packDeploy Use packRetry repeatedly when error counts are dropping; stop when retries no longer improve results. Keep matching key strategy and GlobalKey integrity consistent across source and target orgs. Required Context to Gather First Ask for or infer: source org and target org aliases job file path and DataPack project path deployment scope (full project, manifest subset, or specific key ) whether this is export, deploy, retry, continue, or diff only namespace model ( %vlocity namespace% , vlocity cmt , or core) known constraints (new sandbox bootstrap, trigger behavior, matching key customizations) Preflight checks: Recommended Workflow 1. Ensure tool readiness 2. Validate project data locally Use fixLocalGlobalKeys only when explicitly requested and after explaining impact. 3. Export from source (when needed) 4. Deploy to target 5. Continue interrupted jobs 6. Verify post deploy parity Job file starter: [references/job file template.md](references/job file template.md) High Signal Failure Patterns Error / symptom Likely cause Default fix direction No match found for ... missing dependency in target org include missing DataPack key and redeploy Duplicate Results found for ... GlobalKey duplicate records in target clean duplicates and re run deploy Multiple Imported Records ... same Salesforce Record source duplicate matching key records remove duplicates in source and re export No Configuration Found outdated DataPack settings run packUpdateSettings or enable autoUpdateSettings Some records were not processed settings mismatch / partial dependency state refresh settings both orgs, then retry SASS / template compile failures missing referenced UI template assets export/deploy referenced template dependencies first Detailed matrix: [references/troubleshooting matrix.md](references/troubleshooting matrix.md) CI/CD Guidance Default pipeline shape: 1. authenticate orgs ( sf org login ... ) 2. validate local DataPack integrity ( validateLocalData ) 3. export changed scope ( packExport or manifest driven export) 4. deploy ( packDeploy ) 5. retry loop ( packRetry ) until stable 6. compare ( packGetDiffs ) and publish deployment report For incremental deploy optimization, use job file options such as: gitCheck: true gitCheckKey: <folder manifest for deterministic scope control Cross Skill Integration Need Delegate to Reason metadata deploy outside DataPacks [sf deploy](../sf deploy/SKILL.md) Metadata API workflows OmniStudio component authoring sf industry commoncore build artifacts before deploy EPC product and offer payload authoring [sf industry cme epc model](../sf industry cme epc model/SKILL.md) Product2/DataPack model quality Apex trigger/log error diagnosis [sf debug](../sf debug/SKILL.md), [sf apex](../sf apex/SKILL.md) automation side root cause fixes Reference Map Start here [references/job file template.md](references/job file template.md) [references/troubleshooting matrix.md](references/troubleshooting matrix.md) [examples/business internet plus bundle/TRANSCRIPT.md](examples/business internet plus bundle/TRANSCRIPT.md) [examples/business internet plus bundle deploy/TRANSCRIPT.md](examples/business internet plus bundle deploy/TRANSCRIPT.md) External reference [Vlocity Build GitHub](https://github.com/vlocityinc/vlocity build) Completion Format