Sincronice Oracle CPQ en una estructura de proyecto local limpia

La forma más rápida de trabajar con Oracle CPQ es tratar su configuración de CPQ como una base de código normal: sincronizarla localmente, versionarla en Git y revisar los cambios con diffs.

CPQ DevKit™ for Oracle le ofrece exactamente ese flujo de trabajo con los comandos «GET ALL …», que descargan los objetos de CPQ en una estructura de carpetas predecible.

Su estructura de carpetas es configurable

project.config.jsonc controla dónde se guarda localmente cada tipo de objeto de CPQ:

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

Una vez que sus carpetas se ajusten a las convenciones de su equipo, los comandos de sincronización escribirán en esas ubicaciones de forma coherente.

Comandos recomendados para la «primera sincronización»

Abra la Command Palette (Cmd/Ctrl+Shift+P) y ejecute:

• CPQ DevKit™ for Oracle: Get all Data and Metadata (catálogo de metadatos que la extensión utiliza para una edición más inteligente)
• CPQ DevKit™ for Oracle: GET ALL Tables (escribe las tablas en su carpeta tables y un pequeño archivo de índice en .cpqdevkit/)
• CPQ DevKit™ for Oracle: GET ALL BML (escribe las funciones util/commerce en sus carpetas de funciones)
• CPQ DevKit™ for Oracle: GET ALL Files (descarga los assets del File Manager en su carpeta files)

Muchos de estos comandos también están disponibles en el menú contextual del Explorer al hacer clic derecho sobre la carpeta de su workspace.

Qué produce «GET ALL Tables» (y por qué importa)

Cuando descarga las Data Tables, CPQ DevKit escribe:

• Los archivos JSON de las tablas en su carpeta de tablas (ejemplo: _tables/<folderVar>/<TableName>.json)
• Un índice de Data Tables en .cpqdevkit/ocpq/data-tables.json

Ese índice lo utilizan las funciones de navegación (como «Go to Definition» desde cadenas BMQL dentro de BML).

Mantenga los secretos fuera de Git

Sus credenciales de Oracle CPQ residen en .cpqdevkit/developer.config.jsonc. El comando de configuración de CPQ DevKit agrega automáticamente .cpqdevkit/** a .gitignore: manténgalo así y confirme en el control de versiones únicamente project.config.jsonc (y los assets de CPQ descargados).