Skip to content
CPQ DevKit™
Zurück zum Blog

Erste Schritte mit CPQ DevKit™ for Salesforce (QCP in VS Code)

CPQ DevKit™ for Salesforce ist eine VS-Code-Erweiterung mit Fokus auf die Entwicklung des Salesforce CPQ Quote Calculator Plugin (QCP). Sie ersetzt den Edit-Loop im Browser durch einen lokalen Workflow: in src/ bearbeiten, mit SBQQ__CustomScript__c synchronisieren und Änderungen wie normalen Code diffen.

Voraussetzungen

  • VS Code + die installierte Extension (CPQConsultant.cpq-devkit-sf)
  • Eine Salesforce-Org mit installiertem Salesforce CPQ
  • QCP in den CPQ-Paketeinstellungen aktiviert (damit Ihre Custom-Script-Records verwendet werden)

Wichtige Ordner und Dateien

  • src/*.ts — Ihre lokalen QCP-Skripte (als .ts gespeichert für bessere Editor-Unterstützung, Sie müssen aber gültiges JavaScript schreiben, kein TypeScript)
  • .cpqdevkit/sfcpq/qcp-config.json — verschlüsselte Org-Authentifizierung + Datei-/Record-Zuordnungen (aus Git heraushalten)
  • .cpqdevkit/sfcpq/qcp-log.json — optionale Sync-Logs

1) Projekt initialisieren und authentifizieren

  1. Öffnen Sie einen leeren Ordner in VS Code (oder ein bestehendes Repository).
  2. Führen Sie CPQ DevKit™ for Salesforce: Initialize Project aus.
  3. Wählen Sie Ihren Org-Typ (Sandbox / Dev / Prod / Custom) und schließen Sie den OAuth-Login-Flow ab.

Nach der Authentifizierung speichert die Extension die Zugangsdaten verschlüsselt unter .cpqdevkit/sfcpq/ und aktualisiert .gitignore, damit Sie sie nicht committen.

2) QCP-Skripte erstellen oder pullen

Holen Sie nach der Initialisierung Skripte in Ihren Workspace:

  • CPQ DevKit™ for Salesforce: Pull QCP records from Salesforce (lädt alle Skripte herunter)
  • CPQ DevKit™ for Salesforce: Create example QCP files in your project (fügt Beispiele in src/ hinzu)

3) Kurzer Funktionscheck

Führen Sie CPQ DevKit™ for Salesforce: Validate org credentials are valid aus, um zu bestätigen, dass Sie eine Verbindung herstellen und die Org abfragen können.

Wichtiger Hinweis zu „TypeScript“

Die Dateien werden als .ts gespeichert, aber sie werden nicht kompiliert, bevor sie zurück zu Salesforce gepusht werden. Vermeiden Sie TypeScript-spezifische Syntax (Typen, Enums, Interfaces, as, Decorators usw.) – bleiben Sie bei ES6-kompatiblem JavaScript.