Sincronize o Oracle CPQ em uma estrutura de projeto local limpa

A maneira mais rápida de trabalhar com Oracle CPQ é tratar sua configuração CPQ como uma base de código normal: sincronize-a localmente, versione-a no Git e revise as alterações com diffs.

O CPQ DevKit™ for Oracle oferece exatamente esse workflow com os comandos "GET ALL …", que trazem os objetos CPQ para um layout de pastas previsível.

Sua estrutura de pastas é configurável

project.config.jsonc controla onde cada tipo de objeto CPQ é gravado localmente:

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

Depois que suas pastas corresponderem às convenções da sua equipe, os comandos de sync gravarão nesses locais de forma consistente.

Comandos recomendados para o "primeiro sync"

Abra a Command Palette (Cmd/Ctrl+Shift+P) e execute:

• CPQ DevKit™ for Oracle: Get all Data and Metadata (catálogo de metadados usado pela extensão para uma edição mais inteligente)
• CPQ DevKit™ for Oracle: GET ALL Tables (grava as tabelas na sua pasta tables e um pequeno arquivo de índice em .cpqdevkit/)
• CPQ DevKit™ for Oracle: GET ALL BML (grava as funções util/commerce nas suas pastas de funções)
• CPQ DevKit™ for Oracle: GET ALL Files (baixa os assets do File Manager para a sua pasta files)

Muitos desses comandos também estão disponíveis no menu de contexto do Explorer ao clicar com o botão direito na pasta do seu workspace.

O que o "GET ALL Tables" produz (e por que isso importa)

Quando você baixa as Data Tables, o CPQ DevKit grava:

• Arquivos JSON de tabela na sua pasta de tabelas (exemplo: _tables/<folderVar>/<TableName>.json)
• Um índice de Data Tables em .cpqdevkit/ocpq/data-tables.json

Esse índice é usado pelos recursos de navegação (como o "Go to Definition" a partir de strings BMQL dentro do BML).

Mantenha os segredos fora do Git

Suas credenciais do Oracle CPQ residem em .cpqdevkit/developer.config.jsonc. O comando de configuração do CPQ DevKit adiciona .cpqdevkit/** ao .gitignore automaticamente — mantenha assim e faça commit apenas de project.config.jsonc (e dos seus assets CPQ baixados) no controle de versão.