Livrez vos changements Oracle CPQ 5X plus vite

L'extension VS Code pour les développeurs Oracle CPQ Cloud (BigMachines). Développez, synchronisez, validez et sauvegardez vos projets Oracle CPQ grâce à l'outillage BML/BMQL, aux complétions assistées par IA et à des workflows adaptés à chaque environnement.

Démarrage rapide

1. Installez l'extension depuis le VS Code Marketplace
2. Ouvrez un dossier et exécutez CPQ DevKit™ for Oracle: Set Up Project
3. Créez votre configuration développeur locale avec Create Developer Configuration File ou ouvrez les deux fichiers de configuration avec Open Configuration Files
4. Ajoutez vos environnements *.bigmachines.com et, si nécessaire, connectez-vous à CPQ DevKit™ pour les workflows IA et connectés au cloud
5. Téléchargez des fichiers, des fonctions ou des tables et commencez à les modifier localement

L'extension génère automatiquement project.config.jsonc, .cpqdevkit/developer.config.jsonc, les conventions de dossiers, les entrées .gitignore, le changement d'environnement dans la barre d'état et un onboarding guidé pour les Workspaces Oracle.

Nouveautés de la version 2.6.3

• Délais d'expiration configurables pour les requêtes, afin que les appels REST Oracle CPQ ne restent plus bloqués indéfiniment
• Pagination automatique lors de la récupération de grands ensembles de résultats
• Récupération des journaux de performance et rapport sur les transactions non performantes pour diagnostiquer les transactions CPQ lentes
• Analyse d'impact étendue du Workspace couvrant le BML, les tables de données, le pricing, les intégrations et les fichiers de configuration

Consultez les notes de version complètes dans CHANGELOG.md.

Fonctionnalités

Rédaction BML/BMQL

• Aides à l'autocomplétion et snippets pour le travail BML/BMQL au quotidien
• Prise en charge du formateur et du beautifier pour .bml, .json et .xml
• Atteindre la définition (Go to Definition) pour les fonctions util.* / commerce.* et les références aux Data Tables BMQL
• Génération de squelettes Create BML Function dans le bon dossier du projet
• Constantes intégrées, attributs et snippets de boucle sûrs pour les patterns Oracle CPQ courants

Sync de projet et gestion des environnements

• Configuration de projet pilotée par fichiers de configuration, avec une structure de dossiers prévisible
• Changement rapide d'environnement pour les workflows de type dev, test, uat et prod
• Téléchargements dédiés pour les fichiers, assets, pièces, produits, BML, tables de données, artefacts de pricing, intégrations et ressources d'administration
• Palette d'actions, vue Explorer, onboarding par walkthrough et intégration des tâches VS Code pour les workflows courants
• Visibilité de l'environnement dans la barre d'état, directement dans l'éditeur

Analyse d'impact du Workspace

• Find Workspace Impact pour tracer la sélection, le symbole ou le fichier courant à travers les artefacts Oracle CPQ téléchargés
• Search Workspace Artifacts pour rechercher dans le BML local, les tables de données, le pricing, les intégrations, les métadonnées et la configuration au sein d'un seul rapport
• Extraction des dépendances sortantes des fonctions BML afin de visualiser les usages référencés de util.*, commerce.* et des tables BMQL

Workflows de déploiement, de validation et de pricing

• Sauvegardez, déployez, testez et validez les fonctions BML depuis VS Code
• Calculez le pricing sur l'environnement Oracle CPQ cible
• Diagnostiquez les problèmes de configuration du Workspace et exécutez un autotest des commandes en cas de dépannage

Sauvegarde et migration

• Créez des sauvegardes complètes d'Oracle CPQ depuis l'extension
• Capturez des instantanés de site pour les workflows de migration ou de récupération
• Listez les sauvegardes disponibles et exportez des packages de migration depuis les services gérés par CPQ DevKit

Complétions de code assistées par IA

• Complétions inline pour les fichiers BML et BMQL
• Modèles gpt-4o ou claude-3-5-sonnet configurables
• Jusqu'à 10 lignes avant et après votre curseur, ainsi que les métadonnées du chemin de fichier, sont envoyées lorsque des complétions sont demandées

Vues en table et conversion de formats

• Prévisualisez les données JSON, CSV et XML sous forme de table avec recherche
• Convertissez des fichiers JSON, XML et CSV d'un format à l'autre sans quitter VS Code

Commandes

Toutes les commandes sont disponibles depuis la Command Palette (Ctrl+Shift+P / Cmd+Shift+P) dans la catégorie CPQ DevKit™ for Oracle.

Authentification

• Sign In — s'authentifier auprès des services CPQ DevKit™
• Sign Out — effacer la session CPQ DevKit™ en cours
• Open Authentication Settings — ouvrir la configuration de l'authentification

Configuration et Workspace

• Open Actions — ouvrir la palette d'actions pour les workflows Oracle courants
• Set Up Project — initialiser la configuration du projet, les dossiers et le .gitignore
• Create Developer Configuration File — générer .cpqdevkit/developer.config.jsonc
• Open Configuration Files — ouvrir project.config.jsonc et .cpqdevkit/developer.config.jsonc
• Change Environment — changer d'environnement Oracle CPQ actif
• Diagnose Workspace — valider la configuration et l'environnement actif
• Show Status Bar — réactiver la barre d'état d'environnement
• Open CPQ DevKit Website — accéder à l'application web CPQ DevKit

Rédaction et utilitaires

• Create BML Function — créer un nouveau fichier BML util.* ou commerce.*
• Find Workspace Impact — analyser la sélection, le symbole ou le fichier courant à travers le Workspace CPQ local
• Search Workspace Artifacts — rechercher par terme dans les artefacts Oracle CPQ téléchargés et ouvrir un rapport consolidé
• View as Table — prévisualiser du JSON/CSV/XML sous forme de table avec recherche
• Convert to JSON — convertir des fichiers XML ou CSV en JSON
• Convert to XML — convertir des fichiers JSON ou CSV en XML
• Convert to CSV — convertir des fichiers JSON ou XML en CSV
• Self-Test All Commands — exécuter une vérification intégrée de la disponibilité des commandes

Téléchargements et Sync

• Téléchargements principaux du projet — Download Files, Download Assets, Download Parts, Download Products, Download BML Functions, Download Data Tables, Download Data and Metadata et Download Data Table
• Artefacts de pricing et de 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 et Download Price Books
• Artefacts de site et d'administration — 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 et Download Usage Metrics

Déploiement, validation et sauvegarde

• Calculate Pricing — exécuter des calculs de pricing sur Oracle CPQ
• Deploy Functions — déployer les fonctions BML vers l'environnement actif
• Save Functions — enregistrer les modifications BML locales dans Oracle CPQ
• Test Functions — exécuter des tests BML sur le serveur
• Validate Functions — valider le BML avant déploiement
• Create Full Backup — créer un package de sauvegarde pour l'environnement courant
• Create Site Snapshot — capturer un instantané Oracle CPQ de l'ensemble du site
• List Available Backups — parcourir et exporter les packages de sauvegarde disponibles

IA

• Set AI API Key — configurer votre clé API pour les complétions IA
• Toggle AI Completions — activer ou désactiver les suggestions IA inline
• Clear AI API Key — supprimer la clé API IA enregistrée

Paramètres

Configurez l'extension sous cpqdevkit.* dans les paramètres de VS Code.

Prérequis

• VS Code 1.105+
• Environnement Oracle CPQ Cloud avec accès à l'API REST
• Utilisateur BigMachines avec :
  1. FullAdmin
  2. la case User Administrator activée
  3. l'appartenance au groupe d'administrateurs All Access
• Compte CPQ DevKit™ et clé API pour les fonctionnalités assistées par IA

Fichiers de configuration du projet

Pour utiliser CPQ DevKit™ for Oracle, créez deux fichiers de configuration dans le répertoire de votre projet. Set Up Project et Create Developer Configuration File peuvent les générer pour vous.

1. project.config.jsonc — Configuration du projet

Ce fichier définit les conventions de dossiers à l'échelle du projet et les préférences 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"  }}

Options principales :

• apiVersion — version de l'API Oracle CPQ, par exemple v19, v17 ou v15
• tableFormat — format des tables téléchargées (json ou csv)
• folderSettings — noms des dossiers locaux pour les fichiers, pièces, tables, BML, assets, pricing, métadonnées, dictionnaire et intégrations
• fileSettings — préfixes BML, comportement des balises meta/test et préférences de format de données par défaut

2. .cpqdevkit/developer.config.jsonc — Configuration développeur

Ce fichier stocke vos identifiants d'environnement personnels. Tenez-le à l'écart du contrôle de version.

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

Sécurité et confidentialité

• La connexion aux services CPQ DevKit™ via le navigateur revient dans VS Code et stocke la session DevKit dans le stockage sécurisé (secret storage) de VS Code
• Les URL d'instances Oracle CPQ, les noms d'utilisateur et les mots de passe résident dans .cpqdevkit/developer.config.jsonc ; gardez ce fichier dans .gitignore et local au Workspace
• La télémétrie anonyme est désactivée par défaut et n'inclut jamais le contenu des fichiers ni les données clients CPQ
• Les complétions IA n'envoient qu'une petite fenêtre de code autour de votre curseur lorsqu'elles sont activées
• Les workflows de sauvegarde, d'instantané, de télémétrie et autres workflows connectés au cloud utilisent les services gérés par CPQ DevKit

Support

• Signaler un problème
• Demander une fonctionnalité
• E-mail : sales@cpqdevkit.com
• CPQ Consultant sur LinkedIn

Licence

Consultez LICENSE.md pour plus de détails.

Foire aux questions

Qu'est-ce que CPQ DevKit™ for Oracle ?

Une extension VS Code qui accélère le développement Oracle CPQ grâce à l'outillage BML/BMQL, des workflows de Sync adaptés à chaque environnement, des outils de validation, des sauvegardes et la complétion assistée par IA.

Prend-elle en charge plusieurs environnements et les sauvegardes ?

Oui. Vous pouvez configurer plusieurs environnements Oracle CPQ, passer rapidement de l'un à l'autre et créer des sauvegardes complètes ou des instantanés de site directement depuis VS Code.

Puis-je télécharger et déployer des artefacts Oracle CPQ ?

Oui. L'extension couvre les fonctions BML, les fichiers, les assets, les pièces, les produits, les tables de données, les artefacts de pricing, les intégrations, les dictionnaires et un large éventail de ressources d'administration Oracle CPQ.

Quels systèmes d'exploitation sont pris en charge ?

macOS, Windows et Linux.

Mentions légales

Oracle et Java sont des marques déposées d'Oracle et/ou de ses sociétés affiliées. Les autres noms peuvent être des marques de leurs propriétaires respectifs.

Node.js est une marque de Joyent, Inc. Nous ne sommes ni soutenus par Joyent ni affiliés à cette société.