Oracle CPQ in eine saubere lokale Projektstruktur synchronisieren

Der schnellste Weg, an Oracle CPQ zu arbeiten, ist, Ihre CPQ-Konfiguration wie eine normale Codebasis zu behandeln: lokal synchronisieren, in Git versionieren und Änderungen per Diff reviewen.

CPQ DevKit™ for Oracle liefert Ihnen genau diesen Workflow – mit „GET ALL …“-Befehlen, die CPQ-Objekte in eine vorhersehbare Ordnerstruktur ziehen.

Ihre Ordnerstruktur ist konfigurierbar

project.config.jsonc steuert, wo jeder CPQ-Objekttyp lokal landet:

{  "folderSettings": {    "files": "_files",    "assets": "_assets",    "parts": "_parts",    "tables": "_tables",    "utilFunctions": "_utils",    "commerceFunctions": "_commerce",    "integrations": "_integrations"  }}

Sobald Ihre Ordner den Konventionen Ihres Teams entsprechen, schreiben die Sync-Befehle konsistent in genau diese Speicherorte.

Empfohlene Befehle für den „ersten Sync“

Öffnen Sie die Command Palette (Cmd/Ctrl+Shift+P) und führen Sie aus:

• CPQ DevKit™ for Oracle: Get all Data and Metadata (Metadaten-Katalog, den die Extension für intelligenteres Editing nutzt)
• CPQ DevKit™ for Oracle: GET ALL Tables (schreibt Tabellen in Ihren tables-Ordner sowie eine kleine Indexdatei unter .cpqdevkit/)
• CPQ DevKit™ for Oracle: GET ALL BML (schreibt Util-/Commerce-Funktionen in Ihre Funktionsordner)
• CPQ DevKit™ for Oracle: GET ALL Files (lädt File-Manager-Assets in Ihren files-Ordner herunter)

Viele dieser Befehle sind auch über das Explorer-Kontextmenü verfügbar, wenn Sie mit der rechten Maustaste auf Ihren Workspace-Ordner klicken.

Was „GET ALL Tables“ erzeugt (und warum das wichtig ist)

Wenn Sie Data Tables herunterladen, schreibt CPQ DevKit:

• Tabellen-JSON-Dateien unter Ihren Tables-Ordner (Beispiel: _tables/<folderVar>/<TableName>.json)
• einen Data-Table-Index unter .cpqdevkit/ocpq/data-tables.json

Dieser Index wird von Navigationsfunktionen genutzt (etwa „Go to Definition“ aus BMQL-Strings innerhalb von BML).

Secrets aus Git heraushalten

Ihre Oracle-CPQ-Zugangsdaten liegen in .cpqdevkit/developer.config.jsonc. Der Setup-Befehl von CPQ DevKit fügt .cpqdevkit/** automatisch zu .gitignore hinzu – lassen Sie das so und committen Sie nur project.config.jsonc (sowie Ihre heruntergeladenen CPQ-Assets) in die Versionsverwaltung.