Skip to content
CPQ DevKit™
Volver al blog

Primeros pasos con CPQ DevKit™ for Oracle en VS Code

CPQ DevKit™ for Oracle es una extensión de Visual Studio Code que agiliza el desarrollo de Oracle® CPQ Cloud (BigMachines) con una estructura de proyecto local limpia, mejor edición de BML/BMQL y comandos de sincronización con un solo clic.

Requisitos previos

  • VS Code y la extensión instalada (CPQConsultant.cpq-devkit-o)
  • Un usuario de Oracle CPQ Cloud con permiso para llamar a las API REST (habitualmente: FullAdmin + User Administrator + grupo All Access)
  • Una carpeta nueva y vacía para su proyecto (se recomienda un repositorio Git)

1) Ejecute el scaffolding del proyecto

  1. Abra la carpeta de su proyecto en VS Code.
  2. Abra la Command Palette (Cmd/Ctrl+Shift+P) y ejecute CPQ DevKit™ for Oracle: Setup Project.

Este comando garantiza que:

  • project.config.jsonc existe (convenciones de carpetas y archivos a nivel de proyecto)
  • .cpqdevkit/developer.config.jsonc existe (sus credenciales locales; manténgalas fuera de Git)
  • Las carpetas del workspace existen (tablas, archivos, funciones, assets, etc., según project.config.jsonc)
  • .gitignore contiene .cpqdevkit/**
  • .vscode/extensions.json recomienda la extensión a sus compañeros de equipo

También puede acceder a muchos comandos de DevKit haciendo clic derecho sobre la carpeta de su workspace en el Explorer.

Status bar with active environment

2) Configure los entornos

Abra .cpqdevkit/developer.config.jsonc y agregue sus entornos:

jsonc
{  "name": "CPQ DevKit",  "_git_auto_commit": false,  "_table_format": "json",  "_ocpq_environment_active": "dev",  "_ocpq_environments": [    {      "name": "dev",      "url": "https://<your-dev>.bigmachines.com",      "username": "<your-username>",      "password": "<your-password>"    }  ]}

A continuación, ejecute CPQ DevKit™ for Oracle: Change Environment para seleccionar el entorno activo.

3) (Opcional) Inicie sesión en CPQ DevKit™

Si utiliza los servicios de CPQ DevKit (como el autocompletado con IA), ejecute Login to CPQ DevKit™. Este inicio de sesión es independiente de sus credenciales de Oracle CPQ.

4) Su primera sincronización

Comience por descargar lo esencial a sus carpetas locales:

  • CPQ DevKit™ for Oracle: GET ALL BML
  • CPQ DevKit™ for Oracle: GET ALL Tables
  • CPQ DevKit™ for Oracle: GET ALL Files

A partir de ahí, sus assets de Oracle CPQ residen localmente, de modo que puede buscar, comparar y revisar cambios como en cualquier otra base de código.