sf-vlocity-build-deploy: Vlocity Build DataPack デプロイ

このスキルは、ユーザーが Vlocity DataPack デプロイメント オーケストレーション が必要な場合に使用します: エクスポート/デプロイ ワークフロー、マニフェスト駆動デプロイ、失敗のトリアージ、および OmniStudio/Industries DataPack の CI/CD シーケンシング。

---

このスキルがタスクを所有する場合

sf-vlocity-build-deploy は以下に関わる場合に使用してください:

• vlocity packDeploy、packRetry、packContinue、packExport、packGetDiffs、validateLocalData
• DataPack ジョブファイル設計 (projectPath、expansionPath、manifest、queries)
• org 間 DataPack マイグレーションおよびリトライ ループ
• DataPack 依存関係、マッチングキー、および GlobalKey の問題のトラブルシューティング

ユーザーが以下を実行している場合は他にデリゲートしてください:

• sf project deploy で標準メタデータをデプロイ -> sf-deploy
• OmniScript、FlexCard、IP、またはデータ マッパーを作成 -> sf-industry-commoncore-*
• Product2 EPC バンドルを設計 -> sf-industry-cme-epc-model
• Apex/LWC コードを作成 -> sf-apex、sf-lwc

---

重要な運用ルール

• DataPack には Vlocity Build (vlocity) コマンドを使用し、sf project deploy は使用しないでください。
• 利用可能な場合は、ユーザー名/パスワード ファイルよりも Salesforce CLI 認証統合 (-sfdx.username <alias>) を優先してください。
• フルデプロイの前に デプロイ前品質ゲート を常に実行してください:
  1. validateLocalData
  2. オプション packGetDiffs
  3. その後 packDeploy
• エラー数が減少している場合は packRetry を繰り返し使用し、リトライが結果を改善しなくなったら停止してください。
• マッチングキー戦略と GlobalKey の整合性を、ソース org とターゲット org 全体で一貫して保つ。

---

最初に収集すべき必須コンテキスト

以下を確認または推論してください:

• ソース org およびターゲット org のエイリアス
• ジョブファイル パスおよび DataPack プロジェクト パス
• デプロイ スコープ (フル プロジェクト、マニフェスト サブセット、または特定の -key)
• これがエクスポート、デプロイ、リトライ、継続、または diff のみ かどうか
• namespace モデル (%vlocity_namespace%、vlocity_cmt、またはコア)
• 既知の制約 (新しいサンドボックス ブートストラップ、トリガー動作、マッチングキーのカスタマイズ)

飛行前チェック:

vlocity help
sf org list
sf org display --target-org <alias> --json
test -f <job-file>.yaml

---

推奨ワークフロー

1. ツール準備状況の確認

npm install --global vlocity
vlocity help

2. プロジェクト データをローカルで検証

vlocity -sfdx.username <source-alias> -job <job-file>.yaml validateLocalData

--fixLocalGlobalKeys は明確に要求された場合のみ、その影響を説明した後に使用してください。

3. ソースからエクスポート (必要に応じて)

vlocity -sfdx.username <source-alias> -job <job-file>.yaml packExport
vlocity -sfdx.username <source-alias> -job <job-file>.yaml packRetry

4. ターゲットにデプロイ

vlocity -sfdx.username <target-alias> -job <job-file>.yaml packDeploy
vlocity -sfdx.username <target-alias> -job <job-file>.yaml packRetry

5. 中断されたジョブを継続

vlocity -sfdx.username <target-alias> -job <job-file>.yaml packContinue

6. デプロイ後のパリティを検証

vlocity -sfdx.username <target-alias> -job <job-file>.yaml packGetDiffs

ジョブファイル テンプレート: references/job-file-template.md

---

高シグナル失敗パターン

エラー / 症状	考えられる原因	デフォルト修正方向
No match found for ...	ターゲット org で依存関係が欠落	欠落している DataPack キーを含めて再デプロイ
Duplicate Results found for ... GlobalKey	ターゲット内の重複レコード	重複を削除して再実行
Multiple Imported Records ... same Salesforce Record	ソース内の重複マッチングキー レコード	ソースで重複を削除して再エクスポート
No Configuration Found	古い DataPack 設定	packUpdateSettings を実行するか autoUpdateSettings を有効化
Some records were not processed	設定の不一致 / 部分的な依存関係の状態	両方の org で設定を更新してリトライ
SASS / テンプレート コンパイル エラー	参照されている UI テンプレート アセットが欠落	参照されているテンプレート依存関係を最初にエクスポート/デプロイ

詳細マトリックス: references/troubleshooting-matrix.md

---

CI/CD ガイダンス

デフォルト パイプライン形状:

1. org を認証 (sf org login ...)
2. ローカル DataPack 整合性を検証 (validateLocalData)
3. 変更スコープをエクスポート (packExport またはマニフェスト駆動エクスポート)
4. デプロイ (packDeploy)
5. リトライ ループ (packRetry) が安定するまで実行
6. 比較 (packGetDiffs) してデプロイ レポートを公開

段階的なデプロイ最適化のため、以下のようなジョブファイル オプションを使用してください:

• gitCheck: true
• gitCheckKey: <folder>
• manifest で決定論的スコープ制御

---

クロススキル統合

必要事項	デリゲート先	理由
DataPack 外のメタデータ デプロイ	sf-deploy	Metadata API ワークフロー
OmniStudio コンポーネント オーサリング	sf-industry-commoncore-*	デプロイ前にアーティファクトを作成
EPC 製品およびオファー ペイロード オーサリング	sf-industry-cme-epc-model	Product2/DataPack モデル品質
Apex トリガー/ログ エラー診断	sf-debug、sf-apex	自動化側の根本原因修正

---

リファレンス マップ

ここから開始

• references/job-file-template.md
• references/troubleshooting-matrix.md
• examples/business-internet-plus-bundle/TRANSCRIPT.md
• examples/business-internet-plus-bundle-deploy/TRANSCRIPT.md

外部リファレンス

• Vlocity Build GitHub

---

完了形式

DataPack ゴール: <エクスポート / デプロイ / リトライ / diff / ci-cd>
ソース org: <エイリアスまたは N/A>
ターゲット org: <エイリアスまたは N/A>
スコープ: <ジョブ ファイル + マニフェスト/キー/フル>
結果: <成功 / 失敗 / 部分>
主要な検出: <エラー、依存関係、リトライ、diff>
次のステップ: <安全な後続アクション>