Skip to content
CPQ DevKit™
CPQ DevKit™ for Oracle
Oracle CPQ

Entregue cambios de Oracle CPQ 5X más rápido

Desarrollo BML/BMQL asistido por IA, backups de Oracle CPQ, workflows de validación y sincronización fiable de artefactos desde un único workspace de VS Code.

Instalar en VS CodeIniciar sesión para la IAVer funcionalidadesChangelog

macOS • Windows • Linux

La extensión de VS Code para desarrolladores de Oracle CPQ Cloud (BigMachines). Desarrolle, sincronice, valide y respalde proyectos de Oracle CPQ con herramientas BML/BMQL, autocompletado asistido por IA y flujos de trabajo adaptados a cada entorno.

Status bar with environment Action menu with icons Create config command

Inicio rápido

  1. Instale la extensión desde el VS Code Marketplace
  2. Abra una carpeta y ejecute CPQ DevKit™ for Oracle: Set Up Project
  3. Cree su configuración local de desarrollador con Create Developer Configuration File o abra ambos archivos de configuración con Open Configuration Files
  4. Agregue sus entornos *.bigmachines.com y, si es necesario, inicie sesión en CPQ DevKit™ para los flujos de trabajo de IA y conectados a la nube
  5. Descargue archivos, funciones o tablas y comience a editarlos localmente

La extensión genera automáticamente project.config.jsonc, .cpqdevkit/developer.config.jsonc, las convenciones de carpetas, las entradas de .gitignore, el cambio de entorno desde la barra de estado y un onboarding guiado para los Workspaces de Oracle.

Novedades de la versión 2.6.3

  • Tiempos de espera configurables para las solicitudes, de modo que las llamadas REST a Oracle CPQ ya no queden bloqueadas indefinidamente
  • Paginación automática al recuperar conjuntos de resultados de gran tamaño
  • Recuperación de registros de rendimiento e informe de transacciones de bajo rendimiento para diagnosticar transacciones CPQ lentas
  • Análisis de impacto ampliado del Workspace que abarca BML, tablas de datos, pricing, integraciones y archivos de configuración

Consulte las notas de versión completas en CHANGELOG.md.

Funcionalidades

Redacción BML/BMQL

  • Ayudas de autocompletado y snippets para el trabajo diario con BML/BMQL
  • Compatibilidad con formateador y beautifier para .bml, .json y .xml
  • Ir a la definición (Go to Definition) para funciones util.* / commerce.* y referencias a Data Tables de BMQL
  • Generación de plantillas con Create BML Function en la carpeta correcta del proyecto
  • Constantes integradas, atributos y snippets de bucles seguros para los patrones comunes de Oracle CPQ

Sincronización de proyecto y gestión de entornos

  • Configuración de proyecto basada en archivos de configuración, con una estructura de carpetas predecible
  • Cambio rápido de entorno para flujos de trabajo del tipo dev, test, uat y prod
  • Descargas dedicadas para archivos, assets, piezas, productos, BML, tablas de datos, artefactos de pricing, integraciones y recursos de administración
  • Paleta de acciones, vista del Explorer, onboarding mediante walkthrough e integración con tareas de VS Code para los flujos de trabajo habituales
  • Visibilidad del entorno en la barra de estado, directamente en el editor

Análisis de impacto del Workspace

  • Find Workspace Impact para rastrear la selección, el símbolo o el archivo actual a través de los artefactos de Oracle CPQ descargados
  • Search Workspace Artifacts para buscar en el BML local, las tablas de datos, el pricing, las integraciones, los metadatos y la configuración en un único informe
  • Extracción de dependencias salientes de las funciones BML para visualizar los usos referenciados de util.*, commerce.* y tablas BMQL

Flujos de trabajo de despliegue, validación y pricing

  • Guarde, despliegue, pruebe y valide funciones BML desde VS Code
  • Calcule el pricing contra el entorno Oracle CPQ de destino
  • Diagnostique problemas de configuración del Workspace y ejecute una autocomprobación de comandos al solucionar incidencias

Copia de seguridad y migración

  • Cree copias de seguridad completas de Oracle CPQ desde la extensión
  • Capture instantáneas del sitio para flujos de trabajo de migración o recuperación
  • Liste las copias de seguridad disponibles y exporte paquetes de migración desde los servicios gestionados por CPQ DevKit

Autocompletado de código asistido por IA

  • Sugerencias inline para archivos BML y BMQL
  • Modelos gpt-4o o claude-3-5-sonnet configurables
  • Al solicitar sugerencias se envían hasta 10 líneas antes y después del cursor, además de los metadatos de la ruta del archivo

Vistas en tabla y conversión de formatos

  • Previsualice datos JSON, CSV y XML como una tabla con búsqueda
  • Convierta archivos JSON, XML y CSV entre formatos sin salir de VS Code

Comandos

Todos los comandos están disponibles desde la Command Palette (Ctrl+Shift+P / Cmd+Shift+P) en la categoría CPQ DevKit™ for Oracle.

Autenticación

  • Sign In — autenticarse en los servicios de CPQ DevKit™
  • Sign Out — borrar la sesión actual de CPQ DevKit™
  • Open Authentication Settings — abrir la configuración de autenticación

Configuración y Workspace

  • Open Actions — abrir la paleta de acciones para los flujos de trabajo habituales de Oracle
  • Set Up Project — inicializar la configuración del proyecto, las carpetas y el .gitignore
  • Create Developer Configuration File — generar .cpqdevkit/developer.config.jsonc
  • Open Configuration Files — abrir project.config.jsonc y .cpqdevkit/developer.config.jsonc
  • Change Environment — cambiar el entorno Oracle CPQ activo
  • Diagnose Workspace — validar la configuración y el entorno activo
  • Show Status Bar — volver a habilitar la barra de estado de entorno
  • Open CPQ DevKit Website — acceder a la aplicación web de CPQ DevKit

Redacción y utilidades

  • Create BML Function — crear un nuevo archivo BML util.* o commerce.*
  • Find Workspace Impact — analizar la selección, el símbolo o el archivo actual a través del Workspace CPQ local
  • Search Workspace Artifacts — buscar por término en los artefactos de Oracle CPQ descargados y abrir un informe consolidado
  • View as Table — previsualizar JSON/CSV/XML como una tabla con búsqueda
  • Convert to JSON — convertir archivos XML o CSV a JSON
  • Convert to XML — convertir archivos JSON o CSV a XML
  • Convert to CSV — convertir archivos JSON o XML a CSV
  • Self-Test All Commands — ejecutar una verificación integrada de la disponibilidad de los comandos

Descargas y sincronización

  • Descargas principales del proyecto — Download Files, Download Assets, Download Parts, Download Products, Download BML Functions, Download Data Tables, Download Data and Metadata y Download Data Table
  • Artefactos de pricing y commerce — Download Pricing Rules, Download Pricing Options, Download Pricing Lookup Types, Download Pricing Attributes, Download Pricing Models, Download Pricing Charge Definitions, Download Pricing Charge Attributes, Download BOM Item Setups y Download Price Books
  • Artefactos de sitio y administración — Download Shopping Carts, Download Accounts, Download Groups, Download Eligibility Rules, Download SSO Configuration, Download Document Generators, Download Email Generators, Download RTE Templates, Download Global Branding, Download Global Dictionary, Download Integrations, Download Conversion Units, Download Parts Setup, Download Extract Data Definitions, Download DOCX Merge Definitions, Download DOCX Compare Definitions, Download External Configurator, Download Favorites, Download Saved Searches, Download User Navigation Links, Download User Personalizations, Download Tasks, Download Intelligence, Download Metrics, Download Performance Debugger Logs y Download Usage Metrics

Despliegue, validación y copia de seguridad

  • Calculate Pricing — ejecutar cálculos de pricing contra Oracle CPQ
  • Deploy Functions — desplegar las funciones BML en el entorno activo
  • Save Functions — guardar los cambios BML locales en Oracle CPQ
  • Test Functions — ejecutar pruebas BML en el servidor
  • Validate Functions — validar el BML antes del despliegue
  • Create Full Backup — crear un paquete de copia de seguridad para el entorno actual
  • Create Site Snapshot — capturar una instantánea de Oracle CPQ de todo el sitio
  • List Available Backups — explorar y exportar los paquetes de copia de seguridad disponibles

IA

  • Set AI API Key — configurar su clave de API para el autocompletado con IA
  • Toggle AI Completions — activar o desactivar las sugerencias de IA inline
  • Clear AI API Key — eliminar la clave de API de IA almacenada

Configuración

Configure la extensión en cpqdevkit.* dentro de la configuración de VS Code.

ParámetroValor predeterminadoDescripción
cpqdevkit.debugModefalseActivar el modo de depuración con registro detallado
cpqdevkit.enableTelemetryfalseActivar la telemetría anónima del producto (nunca incluye el contenido de los archivos ni los datos de clientes de CPQ)
cpqdevkit.aiCompletionsEnabledtrueActivar el autocompletado de código con IA para archivos BML/BMQL (requiere el plan Pro)
cpqdevkit.aiModel"gpt-4o"Modelo de IA para el autocompletado (gpt-4o o claude-3-5-sonnet)
cpqdevkit.apiBaseUrl"https://app.cpqdevkit.com/api"URL base de los servicios de API de CPQ DevKit
cpqdevkit.requestTimeout30000Tiempo de espera en ms para las solicitudes de API a Oracle CPQ

Requisitos

  • VS Code 1.105+
  • Entorno Oracle CPQ Cloud con acceso a la API REST
  • Usuario de BigMachines con:
    1. FullAdmin
    2. la opción User Administrator habilitada
    3. pertenencia al grupo de administradores All Access
  • Cuenta de CPQ DevKit™ y clave de API para las funcionalidades asistidas por IA

Archivos de configuración del proyecto

Para usar CPQ DevKit™ for Oracle, cree dos archivos de configuración en el directorio de su proyecto. Set Up Project y Create Developer Configuration File pueden generarlos por usted.

1. project.config.jsonc — Configuración del proyecto

Este archivo define las convenciones de carpetas a nivel de proyecto y las preferencias de Oracle CPQ:

jsonc
{  "apiVersion": "v19", // any version after v15 is supported  "tableFormat": "json",  "folderSettings": {    "files": "_files",    "parts": "_parts",    "tables": "_tables",    "utilFunctions": "_utils",    "commerceFunctions": "_commerce",    "assets": "_assets",    "pricing": "_pricing",    "metadata": "_metadata",    "dictionary": "_dictionary",    "integrations": "_integrations"  },  "fileSettings": {    "bmlUtilPrefix": "util.",    "bmlCommercePrefix": "commerce.",    "bmlIncludeMetaTag": "true",    "bmlIncludeTestTag": "true",    "defaultDataFormat": "json"  }}

Opciones principales:

  • apiVersion — versión de la API de Oracle CPQ, por ejemplo v19, v17 o v15
  • tableFormat — formato de las tablas descargadas (json o csv)
  • folderSettings — nombres de las carpetas locales para archivos, piezas, tablas, BML, assets, pricing, metadatos, diccionario e integraciones
  • fileSettings — prefijos BML, comportamiento de las etiquetas meta/test y preferencias de formato de datos predeterminado

2. .cpqdevkit/developer.config.jsonc — Configuración de desarrollador

Este archivo almacena sus credenciales personales de entorno. Manténgalo fuera del control de versiones.

jsonc
{  "name": "CPQ DevKit™ for Oracle CPQ Cloud - developer's secret file",  "_git_auto_commit": false,  "_table_format": "json",  "_ocpq_environment_active": "dev",  "_ocpq_environments": [    {      "name": "dev",      "url": "https://<subdomain-dev>.bigmachines.com",      "username": "<username>",      "password": "<password>"    },    {      "name": "uat",      "url": "https://<subdomain-uat>.bigmachines.com",      "username": "<username>",      "password": "<password>"    }  ]}

Seguridad y privacidad

  • El inicio de sesión en los servicios de CPQ DevKit™ a través del navegador regresa a VS Code y guarda la sesión de DevKit en el almacenamiento seguro (secret storage) de VS Code
  • Las URL de instancias de Oracle CPQ, los nombres de usuario y las contraseñas residen en .cpqdevkit/developer.config.jsonc; mantenga ese archivo en .gitignore y local al Workspace
  • La telemetría anónima está desactivada de forma predeterminada y nunca incluye el contenido de los archivos ni los datos de clientes de CPQ
  • El autocompletado con IA envía únicamente una pequeña ventana de código alrededor del cursor cuando está activado
  • Las copias de seguridad, las instantáneas, la telemetría y otros flujos de trabajo conectados a la nube utilizan los servicios gestionados por CPQ DevKit

Soporte

Licencia

Consulte LICENSE.md para más detalles.

Preguntas frecuentes

¿Qué es CPQ DevKit™ for Oracle?

Una extensión de VS Code que acelera el desarrollo de Oracle CPQ con herramientas BML/BMQL, flujos de trabajo de sincronización adaptados a cada entorno, herramientas de validación, copias de seguridad y autocompletado asistido por IA.

¿Admite varios entornos y copias de seguridad?

Sí. Puede configurar varios entornos de Oracle CPQ, cambiar rápidamente entre ellos y crear copias de seguridad completas o instantáneas del sitio directamente desde VS Code.

¿Puedo descargar y desplegar artefactos de Oracle CPQ?

Sí. La extensión cubre funciones BML, archivos, assets, piezas, productos, tablas de datos, artefactos de pricing, integraciones, diccionarios y una amplia gama de recursos de administración de Oracle CPQ.

¿Qué sistemas operativos son compatibles?

macOS, Windows y Linux.

Avisos legales

Oracle y Java son marcas registradas de Oracle y/o sus filiales. Otros nombres pueden ser marcas de sus respectivos propietarios.

Node.js es una marca de Joyent, Inc. No contamos con el respaldo de Joyent ni estamos afiliados a dicha empresa.