Skip to content
CPQ DevKit™
CPQ DevKit™ for Salesforce
Salesforce CPQ

Salesforce QCPスクリプトを5倍速く構築

QCP開発のAI支援に加えて、差分比較、バックアップ、インポート/エクスポート、デプロイ、信頼性の高いプル/プッシュ自動化を提供します。

VS Code にインストールサインインしてAIを利用機能を見る変更履歴

macOS • Windows • Linux

Salesforce CPQ 開発者のための No.1 VS Code 拡張機能。 Quote Calculator Plugin（QCP）スクリプトと CPQ 設定の開発、同期、差分比較、バックアップ、デプロイを、すべて VS Code から行えます。

CPQ DevKit Commands

クイックスタート

  1. VS Code Marketplace から拡張機能をインストールします
  2. フォルダーを開き、CPQ DevKit™ for Salesforce: Initialize Project を実行します
  3. OAuth 経由で Salesforce 組織に対して認証します
  4. コーディングを開始します — QCP ファイルを src/ にプルし、変更を加え、プッシュして戻します！

拡張機能は、tsconfig.json、package.json、.env、サンプル QCP ファイル、ユニットテストのテンプレートも自動生成するため、すぐに QCP スクリプトの作成とテストを始められます。

プロジェクト構造

Initialize Project は、拡張機能が使用する主要ファイルを作成・維持します：

  • プロジェクトと認証のメタデータ用の .cpqdevkit/sfcpq/qcp-config.json
  • プル/プッシュ履歴用の .cpqdevkit/sfcpq/qcp-log.json
  • ローカルの QCP ソースファイル用の src/
  • tests/ のテンプレートと、ローカルテスト用の QuoteModel ダウンロード
  • 必要に応じて tsconfig.json、package.json、.env、サンプルファイル

拡張機能には組み込みのウォークスルーも同梱されており、新しいワークスペースでも、ウェブサイトで提供されているものと同じオンボーディングフローでサインイン、初期化、最初の QCP レコードのプルを行えます。

2.6.3 の新機能

  • DevKit 拡張機能間で共有されるファイル変換コマンド（JSON / XML / CSV）
  • より充実したバックアップインサイトのためのバックアップ分析ヘルパー
  • ウォークスルーコンテンツとエクスプローラーアイコンセットの刷新

詳細なリリースノートは CHANGELOG.md をご覧ください。

機能

QCP の双方向同期

Quote Calculator Plugin スクリプトを VS Code と Salesforce の間でプッシュ/プルできます。完全な IDE サポート（IntelliSense、リンティング、フォーマット）のもとローカルで編集し、ワンクリックで変更を同期します。

  • QCP レコードのプル — すべての QCP スクリプトを Salesforce からダウンロードします
  • アクティブファイルのプル — 現在開いているファイルを Salesforce の内容で更新します
  • QCP ファイルのプッシュ — ローカルの変更をすべて Salesforce にアップロードします
  • アクティブファイルのプッシュ — 作業中のファイルだけをプッシュします
  • 保存時のプッシュ — ファイル保存時にプッシュするかどうかを確認するプロンプトを表示できます（任意）

差分比較

プッシュ前に変更をレビューするため、ローカルファイルを Salesforce 側の対応レコードと比較したり、2 つのローカルファイルを並べて比較したりできます。

バックアップとエクスポート

CPQ 設定全体の包括的なバックアップを作成できます：

  • Create CPQ Configuration Backup — QCP、Price Rules、Product Rules、Discount Schedules の完全バックアップ
  • Export QCP Records — すべての QCP スクリプトをエクスポート
  • Export Price Rules — 条件とアクションを含む Price Rules をエクスポート
  • Export Product Rules — Selection、Validation、Alert の各ルールをエクスポート
  • Export Discount Schedules — ティアを含むスケジュールをエクスポート
  • Export Products — CPQ 項目を含む Product2 レコードをエクスポート（CSV または JSON）

インポートとデプロイ

CPQ 設定を組織間で移行できます。サンドボックスからエクスポートし、本番環境にインポートします。

  • Import Price Rules — エクスポートした JSON ファイルから、アップサートロジック付きでインポート（新規は作成、既存は Name で更新）
  • Import Product Rules — Product Rules を組織間でデプロイ
  • Import Discount Schedules — ティア対応でバックアップからスケジュールを復元
  • Deploy CPQ Configuration — バックアップファイルから設定全体をデプロイ
  • ドライランモード — 適用前に変更内容をプレビュー

組織の調査とドリフトレビュー

コンサルタントやサポートチームが、変更を加える前に組織を素早く把握できるようにします：

  • Inspect Org — パッケージ/バージョン詳細、CPQ 設定、構成数、プライシングルールの複雑さを含む Markdown レポートを生成
  • Compare Snapshots — 2 つの CPQ バックアップ/エクスポート JSON ファイルを比較し、欠落または変更された QCP レコード、ルール、スケジュール、テンプレートを検出

AI によるコード補完

QCP 開発のための、コンテキストを理解したインテリジェントなコード提案を利用できます（Pro プラン）：

  • onBeforeCalculate、onAfterCalculate などの QCP コールバックメソッドの補完
  • QuoteModel、QuoteLineModel、Salesforce CPQ の項目を理解
  • GPT-4o または Claude 3.5 Sonnet を利用（設定可能）
  • 補完がトリガーされた際には、カーソル周辺の小さなコードウィンドウのみが送信されます

ガイド付きオンボーディング

組み込みのウォークスルーを使えば、コマンドを手探りで探すことなく、サインイン、プロジェクトの初期化、最初の QCP レコードのプルを行えます。

ユニットテスト

Salesforce から取得した実際の QuoteModel データを使って QCP スクリプトをローカルでテストし、デプロイ前に問題を発見できます。

JSON テーブルビュー

エディタータイトルバーのボタンを使って、任意の JSON ファイルをインタラクティブなテーブルとして開けます（AG Grid を使用）。

トラブルシューティングツール

  • Validate Org Credentials — 現在の Salesforce 認証情報が引き続き有効かを確認します
  • Open Project Configuration — .cpqdevkit/sfcpq/qcp-config.json を開きます
  • Open Sync Log — .cpqdevkit/sfcpq/qcp-log.json を開きます
  • Copy Diagnostics — デバッグやサポートのために、環境および設定情報をクリップボードにコピーします

コマンド

すべてのコマンドは、コマンドパレット（Ctrl+Shift+P / Cmd+Shift+P）の CPQ DevKit™ for Salesforce カテゴリから利用できます。

コマンド説明
Sign InCPQ DevKit サービスで認証します
Sign OutCPQ DevKit サービスからサインアウトします
Initialize Projectプロジェクト構造をセットアップし、Salesforce で認証します
Create Example QCP Filesプロジェクトにサンプル QCP スクリプトを生成します
Pull QCP Recordsすべての QCP スクリプトを Salesforce からダウンロードします
Pull Active File現在のファイルを Salesforce の内容で更新します
Push QCP Filesローカルの変更をすべて Salesforce にアップロードします
Push Active File現在のファイルを Salesforce にプッシュします
Compare Recordsローカルとリモートの QCP スクリプトを差分比較します
Compare Active File現在のファイルを Salesforce のレコードと差分比較します
View Transpiled Codeアクティブファイルのトランスパイル済み JavaScript を表示します
Open QCP Record in Salesforceレコードをブラウザーで開きます
Create BackupQCP ファイルのローカルバックアップを作成します
Download QuoteModelローカルテスト用に QuoteModel を Salesforce から取得します
Export ProductsProduct2 レコードを CSV または JSON にエクスポートします
View as TableJSON ファイルをインタラクティブなテーブルで表示します
Create CPQ Configuration BackupQCP、Price Rules、Product Rules の完全バックアップ
Export QCP Recordsすべての QCP スクリプトをエクスポートします
Export Price Rules条件/アクションを含む Price Rules をエクスポートします
Export Product RulesProduct Rules をエクスポートします
Export Discount Schedulesティアを含む Discount Schedules をエクスポートします
List Backups過去のバックアップを閲覧します
Import Price Rulesエクスポート済みファイルから Price Rules をインポートします
Import Product Rulesエクスポート済みファイルから Product Rules をインポートします
Import Discount Schedulesエクスポート済みファイルから Discount Schedules をインポートします
Deploy CPQ ConfigurationCPQ 設定全体を Salesforce にデプロイします
Inspect Orgコンサルタント向けの組織調査レポートを生成します
Compare Snapshots2 つの CPQ バックアップ/エクスポートを比較してドリフトを検出します
Set AI API KeyAI 補完のための API キーを設定します
Toggle AI CompletionsAI コード提案を有効化または無効化します
Clear AI API Key保存されている API キーを削除します
Open Project Configurationqcp-config.json を開きます
Open Sync Logqcp-log.json を開きます
Copy Diagnostics環境情報をクリップボードにコピーします
Validate Org CredentialsSalesforce 認証情報が有効かをテストします

設定

VS Code の設定で sfdcQcp.* 配下から拡張機能を設定できます。

設定既定値説明
sfdcQcp.pushOnSavefalse保存時にファイルを Salesforce へプッシュするかを確認します
sfdcQcp.saveLogtrueプッシュ/プル操作ごとにログエントリを保存します
sfdcQcp.maxLogEntries150同期ログのエントリの最大数
sfdcQcp.prettiertrueプロジェクト初期化時に .prettierrc ファイルを作成します
sfdcQcp.prettierConfig（下記参照）Prettier の設定オブジェクト
sfdcQcp.export.outputFormat"csv"データエクスポートの出力フォーマット（csv または json）
sfdcQcp.debugModefalse詳細なデバッグログを有効にします
sfdcQcp.enableTelemetryfalse匿名のプロダクトテレメトリを有効にします（ファイルの内容や CPQ データは一切含まれません）
sfdcQcp.aiCompletionsEnabledtrueAI コード補完を有効にします（Pro プランが必要です）
sfdcQcp.aiModel"gpt-4o"補完に使用する AI モデル（gpt-4o または claude-3-5-sonnet）
sfdcQcp.apiBaseUrl"https://app.cpqdevkit.com/api"CPQ DevKit API のベース URL
sfdcQcp.requestTimeout30000Salesforce API リクエストのタイムアウト（ミリ秒、5 000～120 000）
sfdcQcp.export.products.outputFormat"csv"Product2 エクスポートの既定の出力フォーマット（csv または json）
sfdcQcp.export.products.fields（組み込みの項目リスト）製品エクスポート時に含める既定の Product2 および Salesforce CPQ 項目

要件

  • VS Code 1.105+
  • CPQ 管理パッケージがインストールされた Salesforce 組織
  • 組織内の Custom Script（QCP）レコードへのアクセス権

セキュリティとプライバシー

  • OAuth 認証 — パスワードは保存されません
  • 認証情報はワークスペース固有のキーで暗号化され、ローカルに保存されます
  • .cpqdevkit/sfcpq と .env は自動的に .gitignore に追加されます
  • バックアップ/インポート/デプロイおよび AI 補完は、CPQ DevKit サービス（sfdcQcp.apiBaseUrl）と通信します
  • AI 補完は、有効化されている場合でも、カーソル周辺のごく小さなコードウィンドウのみを送信します

プライバシーポリシー

ドキュメント

サポート

ライセンス

詳細は LICENSE.md をご覧ください。

よくある質問

CPQ DevKit™ for Salesforce とは何ですか？

プル/プッシュのワークフロー、設定のバックアップとデプロイツール、AI 補完、ローカルテストユーティリティによって、Salesforce CPQ の Quote Calculator Plugin（QCP）開発を効率化する VS Code 拡張機能です。

組織にはどのように接続しますか？

Initialize Project を使用して OAuth で認証し、ローカルのプロジェクト構造を作成し、拡張機能が必要とするワークスペース設定を保存します。

CPQ 設定の比較、バックアップ、デプロイはできますか？

はい。拡張機能は、レコードの比較、ローカルおよび完全な CPQ バックアップ、製品のエクスポート、そして QCP、Price Rules、Product Rules、Discount Schedules のインポート/エクスポート/デプロイのワークフローをサポートしています。

対応しているオペレーティングシステムは何ですか？

macOS、Windows、Linux です。

Salesforce、Salesforce CPQ および関連するマークは Salesforce, Inc. の商標です。CPQ DevKit™ は Salesforce から承認を受けておらず、同社と提携関係にもありません。