Skip to content
CPQ DevKit™
Voltar ao blog

Primeiros passos com o CPQ DevKit™ for Oracle no VS Code

O CPQ DevKit™ for Oracle é uma extensão do Visual Studio Code que simplifica o desenvolvimento Oracle® CPQ Cloud (BigMachines) com uma estrutura de projeto local limpa, melhor edição de BML/BMQL e comandos de sync em um clique.

Pré-requisitos

  • VS Code e a extensão instalada (CPQConsultant.cpq-devkit-o)
  • Um usuário Oracle CPQ Cloud com permissão para chamar as APIs REST (normalmente: FullAdmin + User Administrator + grupo All Access)
  • Uma nova pasta vazia para o seu projeto (repositório Git recomendado)

1) Execute o scaffolding do projeto

  1. Abra a pasta do seu projeto no VS Code.
  2. Abra a Command Palette (Cmd/Ctrl+Shift+P) e execute CPQ DevKit™ for Oracle: Setup Project.

Esse comando garante que:

  • project.config.jsonc exista (convenções de pastas e arquivos para todo o projeto)
  • .cpqdevkit/developer.config.jsonc exista (suas credenciais locais; mantenha-as fora do Git)
  • as pastas do workspace existam (tabelas, arquivos, funções, assets etc., com base em project.config.jsonc)
  • .gitignore contenha .cpqdevkit/**
  • .vscode/extensions.json recomende a extensão aos colegas de equipe

Você também pode acessar muitos comandos do DevKit clicando com o botão direito na pasta do seu workspace no Explorer.

Status bar with active environment

2) Configure os ambientes

Abra .cpqdevkit/developer.config.jsonc e adicione seus ambientes:

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

Em seguida, execute CPQ DevKit™ for Oracle: Change Environment para selecionar o ambiente ativo.

3) (Opcional) Faça login no CPQ DevKit™

Se você usa os serviços do CPQ DevKit (como as completions de IA), execute Login to CPQ DevKit™. Esse login é separado das suas credenciais do Oracle CPQ.

4) Seu primeiro sync

Comece trazendo o essencial para as suas pastas locais:

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

Depois disso, seus assets Oracle CPQ passam a residir localmente: você pode pesquisar, comparar (diff) e revisar alterações como em qualquer outra base de código.