Entregue mudanças no Oracle CPQ 5X mais rápido

A extensão do VS Code para desenvolvedores Oracle CPQ Cloud (BigMachines). Desenvolva, sincronize, valide e faça backup de projetos Oracle CPQ com ferramentas BML/BMQL, completions assistidas por IA e workflows sensíveis ao ambiente.

Início rápido

1. Instale a extensão pelo VS Code Marketplace
2. Abra uma pasta e execute CPQ DevKit™ for Oracle: Set Up Project
3. Crie sua configuração local de desenvolvedor com Create Developer Configuration File ou abra os dois arquivos de configuração com Open Configuration Files
4. Adicione seus ambientes *.bigmachines.com e, se necessário, faça login no CPQ DevKit™ para os workflows de IA e conectados à nuvem
5. Baixe arquivos, funções ou tabelas e comece a editar localmente

A extensão gera automaticamente project.config.jsonc, .cpqdevkit/developer.config.jsonc, convenções de pastas, entradas no .gitignore, troca de ambiente na barra de status e um onboarding guiado para Workspaces Oracle.

Novidades da versão 2.6.3

• Tempos limite de requisição configuráveis, para que as chamadas REST do Oracle CPQ não fiquem mais travadas indefinidamente
• Paginação automática ao recuperar grandes conjuntos de resultados
• Recuperação de logs de performance e relatório de transações de baixo desempenho para diagnosticar transações CPQ lentas
• Análise de impacto do Workspace estendida cobrindo BML, tabelas de dados, pricing, integrações e arquivos de configuração

Consulte as notas de versão completas em CHANGELOG.md.

Funcionalidades

Escrita de BML/BMQL

• Auxiliares de autocompletar e snippets para o trabalho diário com BML/BMQL
• Suporte a formatador e beautifier para .bml, .json e .xml
• Ir para a definição (Go to Definition) para funções util.* / commerce.* e referências a Data Tables em BMQL
• Geração de esqueletos com Create BML Function na pasta correta do projeto
• Constantes integradas, atributos e snippets de loop seguros para padrões comuns do Oracle CPQ

Sync de projeto e gerenciamento de ambientes

• Configuração de projeto orientada por arquivos de configuração, com estrutura de pastas previsível
• Troca rápida de ambiente para workflows no estilo dev, test, uat e prod
• Downloads dedicados para arquivos, assets, peças, produtos, BML, tabelas de dados, artefatos de pricing, integrações e recursos de administração
• Paleta de ações, visão no Explorer, onboarding por walkthrough e integração com tarefas do VS Code para workflows comuns
• Visibilidade do ambiente na barra de status, dentro do próprio editor

Análise de impacto do Workspace

• Find Workspace Impact para rastrear a seleção, o símbolo ou o arquivo atual pelos artefatos Oracle CPQ baixados
• Search Workspace Artifacts para pesquisar no BML local, nas tabelas de dados, no pricing, nas integrações, nos metadados e na configuração em um único relatório
• Extração de dependências de saída das funções BML para visualizar os usos referenciados de util.*, commerce.* e tabelas BMQL

Workflows de deploy, validação e pricing

• Salve, faça deploy, teste e valide funções BML a partir do VS Code
• Calcule o pricing no ambiente Oracle CPQ de destino
• Diagnostique problemas de configuração do Workspace e execute um autoteste de comandos durante a solução de problemas

Backup e migração

• Crie backups completos do Oracle CPQ a partir da extensão
• Capture snapshots de site para workflows de migração ou recuperação
• Liste os backups disponíveis e exporte pacotes de migração a partir dos serviços gerenciados do CPQ DevKit

Completions de código com IA

• Completions inline para arquivos BML e BMQL
• Modelos gpt-4o ou claude-3-5-sonnet configuráveis
• Até 10 linhas antes e depois do cursor, além dos metadados do caminho do arquivo, são enviadas quando as completions são solicitadas

Visualização em tabela e conversão de formatos

• Pré-visualize dados JSON, CSV e XML como uma tabela pesquisável
• Converta arquivos JSON, XML e CSV entre formatos sem sair do VS Code

Comandos

Todos os comandos estão disponíveis na Command Palette (Ctrl+Shift+P / Cmd+Shift+P) na categoria CPQ DevKit™ for Oracle.

Autenticação

• Sign In — autenticar-se nos serviços do CPQ DevKit™
• Sign Out — limpar a sessão atual do CPQ DevKit™
• Open Authentication Settings — abrir a configuração de autenticação

Configuração e Workspace

• Open Actions — abrir a paleta de ações para workflows Oracle comuns
• Set Up Project — inicializar a configuração do projeto, as pastas e o .gitignore
• Create Developer Configuration File — gerar .cpqdevkit/developer.config.jsonc
• Open Configuration Files — abrir project.config.jsonc e .cpqdevkit/developer.config.jsonc
• Change Environment — alternar o ambiente Oracle CPQ ativo
• Diagnose Workspace — validar a configuração e o ambiente ativo
• Show Status Bar — reativar a barra de status do ambiente
• Open CPQ DevKit Website — acessar o aplicativo web do CPQ DevKit

Escrita e utilitários

• Create BML Function — criar um novo arquivo BML util.* ou commerce.*
• Find Workspace Impact — analisar a seleção, o símbolo ou o arquivo atual em todo o Workspace CPQ local
• Search Workspace Artifacts — pesquisar por termo nos artefatos Oracle CPQ baixados e abrir um relatório consolidado
• View as Table — pré-visualizar JSON/CSV/XML como uma tabela pesquisável
• Convert to JSON — converter arquivos XML ou CSV em JSON
• Convert to XML — converter arquivos JSON ou CSV em XML
• Convert to CSV — converter arquivos JSON ou XML em CSV
• Self-Test All Commands — executar uma verificação integrada de disponibilidade dos comandos

Downloads e Sync

• Downloads principais do projeto — Download Files, Download Assets, Download Parts, Download Products, Download BML Functions, Download Data Tables, Download Data and Metadata e Download Data Table
• Artefatos de pricing e 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 e Download Price Books
• Artefatos de site e administração — 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 e Download Usage Metrics

Deploy, validação e backup

• Calculate Pricing — executar cálculos de pricing no Oracle CPQ
• Deploy Functions — fazer deploy das funções BML para o ambiente ativo
• Save Functions — salvar as alterações BML locais no Oracle CPQ
• Test Functions — executar testes de BML no servidor
• Validate Functions — validar o BML antes do deploy
• Create Full Backup — criar um pacote de backup para o ambiente atual
• Create Site Snapshot — capturar um snapshot Oracle CPQ de todo o site
• List Available Backups — navegar e exportar os pacotes de backup disponíveis

IA

• Set AI API Key — configurar sua chave de API para as completions de IA
• Toggle AI Completions — ativar ou desativar as sugestões inline de IA
• Clear AI API Key — remover a chave de API de IA armazenada

Configurações

Configure a extensão em cpqdevkit.* nas configurações do VS Code.

Requisitos

• VS Code 1.105+
• Ambiente Oracle CPQ Cloud com acesso à API REST
• Usuário BigMachines com:
  1. FullAdmin
  2. a opção User Administrator habilitada
  3. participação no grupo de administradores All Access
• Conta CPQ DevKit™ e chave de API para os recursos assistidos por IA

Arquivos de configuração do projeto

Para usar o CPQ DevKit™ for Oracle, crie dois arquivos de configuração no diretório do seu projeto. Set Up Project e Create Developer Configuration File podem gerá-los para você.

1. project.config.jsonc — Configuração do projeto

Este arquivo define as convenções de pastas do projeto e as preferências do Oracle CPQ:

{  "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"  }}

Opções principais:

• apiVersion — versão da API do Oracle CPQ, como v19, v17 ou v15
• tableFormat — formato das tabelas baixadas (json ou csv)
• folderSettings — nomes das pastas locais para arquivos, peças, tabelas, BML, assets, pricing, metadados, dicionário e integrações
• fileSettings — prefixos BML, comportamento das tags meta/test e preferências de formato de dados padrão

2. .cpqdevkit/developer.config.jsonc — Configuração do desenvolvedor

Este arquivo armazena suas credenciais pessoais de ambiente. Mantenha-o fora do controle de versão.

{  "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>"    }  ]}

Segurança e privacidade

• O login nos serviços do CPQ DevKit™ via navegador retorna ao VS Code e armazena a sessão do DevKit no armazenamento seguro (secret storage) do VS Code
• As URLs de instâncias Oracle CPQ, os nomes de usuário e as senhas residem em .cpqdevkit/developer.config.jsonc; mantenha esse arquivo no .gitignore e local ao Workspace
• A telemetria anônima vem desativada por padrão e nunca inclui o conteúdo dos arquivos nem dados de clientes CPQ
• As completions de IA enviam apenas uma pequena janela de código ao redor do cursor quando ativadas
• Backup, snapshot, telemetria e outros workflows conectados à nuvem usam os serviços gerenciados do CPQ DevKit

Suporte

• Relatar um problema
• Solicitar uma funcionalidade
• E-mail: sales@cpqdevkit.com
• CPQ Consultant no LinkedIn

Licença

Consulte LICENSE.md para mais detalhes.

Perguntas frequentes

O que é o CPQ DevKit™ for Oracle?

Uma extensão do VS Code que acelera o desenvolvimento Oracle CPQ com ferramentas BML/BMQL, workflows de Sync sensíveis ao ambiente, ferramentas de validação, backups e completion assistida por IA.

Ela oferece suporte a múltiplos ambientes e backups?

Sim. Você pode configurar vários ambientes Oracle CPQ, alternar rapidamente entre eles e criar backups completos ou snapshots de site diretamente no VS Code.

Posso baixar e fazer deploy de artefatos do Oracle CPQ?

Sim. A extensão cobre funções BML, arquivos, assets, peças, produtos, tabelas de dados, artefatos de pricing, integrações, dicionários e uma ampla variedade de recursos de administração do Oracle CPQ.

Quais sistemas operacionais são suportados?

macOS, Windows e Linux.

Avisos legais

Oracle e Java são marcas registradas da Oracle e/ou de suas afiliadas. Outros nomes podem ser marcas de seus respectivos proprietários.

Node.js é uma marca da Joyent, Inc. Não somos endossados pela Joyent nem afiliados a ela.