Skip to content
Retour au blog

Synchronisez Oracle CPQ dans une structure de projet locale propre

La façon la plus rapide de travailler sur Oracle CPQ est de traiter votre configuration CPQ comme une base de code classique : synchronisez-la en local, versionnez-la dans Git et passez en revue les changements avec des diffs.

CPQ DevKit™ for Oracle vous offre exactement ce workflow grâce aux commandes « GET ALL … » qui rapatrient les objets CPQ dans une arborescence de dossiers prévisible.

Votre structure de dossiers est configurable

project.config.jsonc détermine où chaque type d'objet CPQ atterrit en local :

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

Une fois vos dossiers alignés sur les conventions de votre équipe, les commandes de sync écrivent systématiquement à ces emplacements.

Commandes recommandées pour le « premier sync »

Ouvrez la Command Palette (Cmd/Ctrl+Shift+P) et exécutez :

  • CPQ DevKit™ for Oracle: Get all Data and Metadata (catalogue de métadonnées utilisé par l'extension pour une édition plus intelligente)
  • CPQ DevKit™ for Oracle: GET ALL Tables (écrit les tables dans votre dossier tables ainsi qu'un petit fichier d'index sous .cpqdevkit/)
  • CPQ DevKit™ for Oracle: GET ALL BML (écrit les fonctions util/commerce dans vos dossiers de fonctions)
  • CPQ DevKit™ for Oracle: GET ALL Files (télécharge les assets du File Manager dans votre dossier files)

Beaucoup de ces commandes sont aussi disponibles dans le menu contextuel de l'Explorer via un clic droit sur le dossier de votre workspace.

Ce que produit « GET ALL Tables » (et pourquoi c'est important)

Lorsque vous téléchargez des Data Tables, CPQ DevKit écrit :

  • des fichiers JSON de tables sous votre dossier de tables (exemple : _tables/<folderVar>/<TableName>.json)
  • un index des Data Tables dans .cpqdevkit/ocpq/data-tables.json

Cet index est utilisé par les fonctionnalités de navigation (comme « Go to Definition » depuis les chaînes BMQL dans le BML).

Gardez les secrets hors de Git

Vos identifiants Oracle CPQ résident dans .cpqdevkit/developer.config.jsonc. La commande de configuration de CPQ DevKit ajoute automatiquement .cpqdevkit/** à .gitignore — conservez ce réglage et ne committez que project.config.jsonc (ainsi que vos assets CPQ téléchargés) dans le contrôle de version.