SuperAPI AI 工具集

deploying-omnistudio-datapacks

部署与运维

查看项目

更新于 10-15 21:43

技能介绍

用途:该技能用于编排 OmniStudio/Industries DataPack 的导出与部署工作流,包括清单驱动的部署、失败排查以及 CI/CD 顺序安排。涉及 vlocity packDeploy、packRetry、packContinue、packExport、packGetDiffs、validateLocalData,以及 job-file 设计(projectPath、expansionPath、manifest、queries)、组织间迁移与依赖、匹配键、GlobalKey 问题处理。

主要能力与用法:需先收集源/目标组织别名、job 文件与项目路径、部署范围、操作类型、命名空间模型与已知约束。预检可用 vlocity help、sf org list、sf org display --target-org <alias> --json、test -f <job-file>.yaml。安装:npm install --global vlocity。典型顺序为:用 validateLocalData 做本地校验(可选 packGetDiffs),再 packExport 导出、packDeploy 部署到目标、packRetry 反复重试直至错误数不再下降、packContinue 续跑中断任务、packGetDiffs 验证一致性。优先使用 Salesforce CLI 认证集成(-sfdx.username <alias>)。仅在明确要求并说明影响后使用 --fixLocalGlobalKeys。增量部署可用 gitCheck、gitCheckKey、manifest 控制范围。

限制与注意:DataPack 应使用 Vlocity Build 命令而非 sf project deploy;需保持源与目标组织的匹配键策略和 GlobalKey 一致。常见问题包括目标缺少依赖、GlobalKey 重复、源端匹配键重复、DataPack 设置过旧、记录未处理、模板编译失败等,需按对应方向修复。标准元数据部署、OmniStudio 组件编写、EPC 建模、Apex/LWC 生成应转交其他技能。完成后输出目标、源/目标组织、范围、结果、关键发现与下一步。参考文件包括 job-file-template.md、troubleshooting-matrix.md 及示例目录。