Skip to content
CPQ DevKit™ for Salesforce
Salesforce CPQ

Construisez vos scripts QCP Salesforce 5X plus vite

Assistance IA pour le développement QCP, plus diff, backup, import/export, déploiement et automatisation pull/push fiable.

macOS • Windows • Linux

L'extension VS Code n° 1 pour les développeurs Salesforce CPQ. Développez, synchronisez, comparez, sauvegardez et déployez les scripts Quote Calculator Plugin (QCP) et la configuration CPQ — le tout depuis VS Code.

CPQ DevKit Commands

Démarrage rapide

  1. Installez l'extension depuis le VS Code Marketplace
  2. Ouvrez un dossier et exécutez CPQ DevKit™ for Salesforce: Initialize Project
  3. Authentifiez-vous auprès de votre org Salesforce via OAuth
  4. Commencez à coder — récupérez (pull) les fichiers QCP dans src/, faites vos modifications, renvoyez-les (push) !

L'extension génère également tsconfig.json, package.json, .env, des fichiers QCP d'exemple et des modèles de tests unitaires pour que vous puissiez écrire et tester des scripts QCP immédiatement.

Structure du projet

Initialize Project crée et maintient les fichiers principaux utilisés par l'extension :

  • .cpqdevkit/sfcpq/qcp-config.json pour les métadonnées du projet et de l'authentification
  • .cpqdevkit/sfcpq/qcp-log.json pour l'historique des pull/push
  • src/ pour les fichiers sources QCP locaux
  • des modèles dans tests/ ainsi que des téléchargements de QuoteModel pour les tests locaux
  • tsconfig.json, package.json, .env et des fichiers d'exemple selon les besoins

L'extension inclut aussi un walkthrough intégré afin que les nouveaux Workspaces puissent se connecter, s'initialiser et récupérer leurs premiers enregistrements QCP avec le même parcours d'onboarding que celui présenté sur le site web.

Nouveautés de la version 2.6.3

  • Commandes de conversion de fichiers (JSON / XML / CSV) partagées entre les extensions DevKit
  • Assistants d'analyse de sauvegarde pour des informations de sauvegarde plus riches
  • Contenu du walkthrough actualisé et nouveau jeu d'icônes pour l'explorateur

Consultez les notes de version complètes dans CHANGELOG.md.

Fonctionnalités

Sync QCP bidirectionnelle

Envoyez (push) et récupérez (pull) les scripts Quote Calculator Plugin entre VS Code et Salesforce. Travaillez en local avec tout le confort de l'IDE (IntelliSense, linting, formatage) et synchronisez vos modifications en un clic.

  • Pull QCP records — télécharger tous les scripts QCP depuis Salesforce
  • Pull active file — actualiser le fichier actuellement ouvert depuis Salesforce
  • Push QCP files — envoyer toutes les modifications locales vers Salesforce
  • Push active file — envoyer uniquement le fichier sur lequel vous travaillez
  • Push on save — proposer en option d'envoyer le fichier lors de son enregistrement

Diff et comparaison

Comparez les fichiers locaux avec leurs équivalents Salesforce pour passer en revue vos modifications avant de les envoyer, ou comparez deux fichiers locaux côte à côte.

Sauvegarde et export

Créez des sauvegardes complètes de l'ensemble de votre configuration CPQ :

  • Create CPQ Configuration Backup — sauvegarde complète des QCP, Price Rules, Product Rules et Discount Schedules
  • Export QCP Records — exporter tous les scripts QCP
  • Export Price Rules — exporter les Price Rules avec leurs conditions et actions
  • Export Product Rules — exporter les règles Selection, Validation et Alert
  • Export Discount Schedules — exporter les barèmes avec leurs paliers
  • Export Products — exporter les enregistrements Product2 avec les champs CPQ (CSV ou JSON)

Import et déploiement

Migrez les configurations CPQ entre orgs. Exportez depuis la sandbox, importez en production.

  • Import Price Rules — importer depuis des fichiers JSON exportés avec une logique d'upsert (crée les nouveaux enregistrements, met à jour les existants par Name)
  • Import Product Rules — déployer des Product Rules entre orgs
  • Import Discount Schedules — restaurer des barèmes depuis une sauvegarde, avec prise en charge des paliers
  • Deploy CPQ Configuration — déploiement complet de la configuration à partir de fichiers de sauvegarde
  • Mode dry-run — prévisualiser les changements avant de les appliquer

Inspection d'org et revue des écarts

Offrez aux consultants et aux équipes de support un moyen plus rapide de comprendre une org avant de la modifier :

  • Inspect Org — générer un rapport Markdown avec les détails des packages/versions, les paramètres CPQ, les volumes de configuration et la complexité des règles de pricing
  • Compare Snapshots — comparer deux fichiers JSON de sauvegarde/export CPQ pour repérer les enregistrements QCP, règles, barèmes et modèles manquants ou modifiés

Complétions de code assistées par IA

Bénéficiez de suggestions de code intelligentes et contextuelles pour le développement QCP (plan Pro) :

  • Complétions pour onBeforeCalculate, onAfterCalculate et les autres méthodes de callback QCP
  • Compréhension de QuoteModel, QuoteLineModel et des champs Salesforce CPQ
  • Propulsé par GPT-4o ou Claude 3.5 Sonnet (configurable)
  • Une petite fenêtre de code autour de votre curseur est envoyée lorsque les complétions sont déclenchées

Onboarding guidé

Utilisez le walkthrough intégré pour vous connecter, initialiser un projet et récupérer vos premiers enregistrements QCP sans chercher manuellement parmi les commandes.

Tests unitaires

Testez vos scripts QCP en local avec de vraies données QuoteModel récupérées depuis Salesforce — détectez les problèmes avant de déployer.

Vue table JSON

Ouvrez n'importe quel fichier JSON sous forme de table interactive via le bouton de la barre de titre de l'éditeur (propulsé par AG Grid).

Outils de dépannage

  • Validate Org Credentials — vérifier que vos identifiants Salesforce actuels fonctionnent toujours
  • Open Project Configuration — accéder à .cpqdevkit/sfcpq/qcp-config.json
  • Open Sync Log — accéder à .cpqdevkit/sfcpq/qcp-log.json
  • Copy Diagnostics — copier les informations d'environnement et de paramètres dans le presse-papiers pour le débogage ou le support

Commandes

Toutes les commandes sont disponibles depuis la Command Palette (Ctrl+Shift+P / Cmd+Shift+P) dans la catégorie CPQ DevKit™ for Salesforce.

CommandeDescription
Sign InS'authentifier auprès des services CPQ DevKit
Sign OutSe déconnecter des services CPQ DevKit
Initialize ProjectMettre en place la structure du projet et s'authentifier auprès de Salesforce
Create Example QCP FilesGénérer des scripts QCP d'exemple dans votre projet
Pull QCP RecordsTélécharger tous les scripts QCP depuis Salesforce
Pull Active FileActualiser le fichier courant depuis Salesforce
Push QCP FilesEnvoyer toutes les modifications locales vers Salesforce
Push Active FileEnvoyer le fichier courant vers Salesforce
Compare RecordsComparer (diff) les scripts QCP locaux et distants
Compare Active FileComparer le fichier courant avec son enregistrement Salesforce
View Transpiled CodeAfficher le JavaScript transpilé du fichier actif
Open QCP Record in SalesforceOuvrir l'enregistrement dans votre navigateur
Create BackupCréer une sauvegarde locale des fichiers QCP
Download QuoteModelRécupérer un QuoteModel depuis Salesforce pour les tests locaux
Export ProductsExporter les enregistrements Product2 en CSV ou JSON
View as TableAfficher un fichier JSON dans une table interactive
Create CPQ Configuration BackupSauvegarde complète des QCP, Price Rules et Product Rules
Export QCP RecordsExporter tous les scripts QCP
Export Price RulesExporter les Price Rules avec conditions/actions
Export Product RulesExporter les Product Rules
Export Discount SchedulesExporter les Discount Schedules avec leurs paliers
List BackupsParcourir les sauvegardes précédentes
Import Price RulesImporter des Price Rules depuis un fichier exporté
Import Product RulesImporter des Product Rules depuis un fichier exporté
Import Discount SchedulesImporter des Discount Schedules depuis un fichier exporté
Deploy CPQ ConfigurationDéployer une configuration CPQ complète vers Salesforce
Inspect OrgGénérer un rapport d'inspection d'org adapté aux consultants
Compare SnapshotsComparer deux sauvegardes/exports CPQ pour détecter les écarts
Set AI API KeyConfigurer votre clé API pour les complétions IA
Toggle AI CompletionsActiver ou désactiver les suggestions de code par IA
Clear AI API KeySupprimer votre clé API enregistrée
Open Project ConfigurationOuvrir qcp-config.json
Open Sync LogOuvrir qcp-log.json
Copy DiagnosticsCopier les informations d'environnement dans le presse-papiers
Validate Org CredentialsVérifier que vos identifiants Salesforce sont valides

Paramètres

Configurez l'extension sous sfdcQcp.* dans les paramètres de VS Code.

ParamètreValeur par défautDescription
sfdcQcp.pushOnSavefalseProposer d'envoyer le fichier vers Salesforce lors de l'enregistrement
sfdcQcp.saveLogtrueEnregistrer une entrée de journal pour chaque opération push/pull
sfdcQcp.maxLogEntries150Nombre maximal d'entrées dans le journal de Sync
sfdcQcp.prettiertrueCréer un fichier .prettierrc lors de l'initialisation du projet
sfdcQcp.prettierConfig(voir ci-dessous)Objet de configuration Prettier
sfdcQcp.export.outputFormat"csv"Format d'export pour les exports de données (csv ou json)
sfdcQcp.debugModefalseActiver la journalisation détaillée de débogage
sfdcQcp.enableTelemetryfalseActiver la télémétrie produit anonyme (n'inclut jamais le contenu des fichiers ni les données CPQ)
sfdcQcp.aiCompletionsEnabledtrueActiver les complétions de code par IA (plan Pro requis)
sfdcQcp.aiModel"gpt-4o"Modèle d'IA pour les complétions (gpt-4o ou claude-3-5-sonnet)
sfdcQcp.apiBaseUrl"https://app.cpqdevkit.com/api"URL de base de l'API CPQ DevKit
sfdcQcp.requestTimeout30000Délai d'expiration en ms pour les requêtes API Salesforce (5 000–120 000)
sfdcQcp.export.products.outputFormat"csv"Format d'export par défaut pour les exports Product2 (csv ou json)
sfdcQcp.export.products.fields(liste de champs intégrée)Champs Product2 et Salesforce CPQ inclus par défaut lors de l'export de produits

Prérequis

  • VS Code 1.105+
  • Org Salesforce avec le package managé CPQ installé
  • Accès aux enregistrements Custom Script (QCP) dans votre org

Sécurité et confidentialité

  • Authentification OAuth — aucun mot de passe stocké
  • Les identifiants sont chiffrés avec une clé unique par Workspace et stockés en local
  • .cpqdevkit/sfcpq et .env sont automatiquement ajoutés au .gitignore
  • Les fonctions de sauvegarde/import/déploiement et les complétions IA communiquent avec les services CPQ DevKit (sfdcQcp.apiBaseUrl)
  • Les complétions IA n'envoient qu'une petite fenêtre de code autour de votre curseur lorsqu'elles sont activées

Politique de confidentialité

Documentation

Support

Licence

Consultez LICENSE.md pour plus de détails.

Foire aux questions

Qu'est-ce que CPQ DevKit™ for Salesforce ?

Une extension VS Code qui simplifie le développement de Quote Calculator Plugin (QCP) pour Salesforce CPQ, avec des workflows de pull/push, des outils de sauvegarde et de déploiement de configuration, des complétions IA et des utilitaires de tests locaux.

Comment me connecter à mon org ?

Utilisez Initialize Project pour vous authentifier via OAuth, créer la structure de projet locale et enregistrer la configuration de Workspace nécessaire à l'extension.

Puis-je comparer, sauvegarder et déployer la configuration CPQ ?

Oui. L'extension prend en charge la comparaison d'enregistrements, les sauvegardes CPQ locales et complètes, l'export de produits ainsi que les workflows d'import/export/déploiement pour les QCP, Price Rules, Product Rules et Discount Schedules.

Quels systèmes d'exploitation sont pris en charge ?

macOS, Windows et Linux.

Salesforce, Salesforce CPQ et les marques associées sont des marques de Salesforce, Inc. CPQ DevKit™ n'est ni soutenu par Salesforce ni affilié à cette société.