Oracle CPQの変更を5倍速くリリース

Oracle CPQ Cloud（BigMachines）開発者向けの VS Code 拡張機能。 BML/BMQL ツール、AI 支援による補完、環境を意識したワークフローにより、Oracle CPQ プロジェクトの開発、同期、検証、バックアップを実現します。

クイックスタート

1. VS Code Marketplace から拡張機能をインストールします
2. フォルダーを開き、CPQ DevKit™ for Oracle: Set Up Project を実行します
3. Create Developer Configuration File でローカルの開発者用設定ファイルを作成するか、Open Configuration Files で両方の設定ファイルを開きます
4. *.bigmachines.com 環境を追加し、必要に応じて AI およびクラウド接続ワークフローのために CPQ DevKit™ にサインインします
5. ファイル、関数、テーブルをダウンロードし、ローカルでの編集を開始します

拡張機能は、project.config.jsonc、.cpqdevkit/developer.config.jsonc、フォルダー規約、.gitignore エントリ、ステータスバーでの環境切り替え、Oracle ワークスペース向けのガイド付きオンボーディングを自動生成します。

2.6.3 の新機能

• リクエストタイムアウトを設定可能にし、Oracle CPQ への REST 呼び出しが無期限に応答待ちにならないようにしました
• 大きな結果セットを取得する際の自動ページネーション
• 低速な CPQ トランザクションを診断するためのパフォーマンスログ取得と非効率トランザクションレポート
• BML、データテーブル、プライシング、インテグレーション、設定ファイルにまたがるワークスペース影響分析の拡張

詳細なリリースノートは CHANGELOG.md をご覧ください。

機能

BML/BMQL の作成支援

• 日々の BML/BMQL 作業のためのオートコンプリート補助とスニペット
• .bml、.json、.xml に対応するフォーマッターおよびビューティファイアー
• util.* / commerce.* 関数と BMQL データテーブル参照に対する定義へ移動（Go to Definition）
• 適切なプロジェクトフォルダー内に Create BML Function でスケルトンを生成
• Oracle CPQ の一般的なパターンに対応した組み込み定数、属性、安全なループスニペット

プロジェクト同期と環境管理

• 設定ファイル駆動のプロジェクトセットアップと、予測可能なフォルダー構造
• dev、test、uat、prod 形式のワークフローに対応した高速な環境切り替え
• ファイル、アセット、パーツ、製品、BML、データテーブル、プライシング成果物、インテグレーション、管理リソース向けの専用ダウンロード
• アクションパレット、エクスプローラービュー、ウォークスルーによるオンボーディング、一般的なワークフロー向けの VS Code タスク統合
• エディター内のステータスバーで環境を可視化

ワークスペース影響分析

• Find Workspace Impact により、現在の選択範囲、シンボル、ファイルを、ダウンロード済みの Oracle CPQ 成果物全体にわたって追跡
• Search Workspace Artifacts により、ローカルの BML、データテーブル、プライシング、インテグレーション、メタデータ、設定を 1 つのレポートで横断検索
• BML 関数の外部依存関係を抽出し、参照されている util.*、commerce.*、BMQL テーブルの利用状況を確認可能

デプロイ、検証、プライシングのワークフロー

• VS Code から BML 関数の保存、デプロイ、テスト、検証を実行
• 対象の Oracle CPQ 環境に対してプライシングを計算
• ワークスペース設定の問題を診断し、トラブルシューティング時にはコマンドのセルフテストを実行

バックアップと移行

• 拡張機能から Oracle CPQ の完全バックアップを作成
• 移行や復旧ワークフローのためのサイトスナップショットを取得
• 利用可能なバックアップの一覧表示と、CPQ DevKit が管理するサービスからの移行パッケージのエクスポート

AI によるコード補完

• BML および BMQL ファイル向けのインライン補完
• gpt-4o または claude-3-5-sonnet のモデルを設定可能
• 補完のリクエスト時には、カーソルの前後最大 10 行とファイルパスのメタデータのみが送信されます

テーブルビューとフォーマット変換

• JSON、CSV、XML データを検索可能なテーブルとしてプレビュー
• VS Code を離れることなく、JSON、XML、CSV ファイルを相互に変換

コマンド

すべてのコマンドは、コマンドパレット（Ctrl+Shift+P / Cmd+Shift+P）の CPQ DevKit™ for Oracle カテゴリから利用できます。

認証

• Sign In — CPQ DevKit™ サービスで認証します
• Sign Out — 現在の CPQ DevKit™ セッションをクリアします
• Open Authentication Settings — 認証設定を開きます

セットアップとワークスペース

• Open Actions — 一般的な Oracle ワークフロー向けのアクションパレットを開きます
• Set Up Project — プロジェクト設定、フォルダー、.gitignore を初期化します
• Create Developer Configuration File — .cpqdevkit/developer.config.jsonc を生成します
• Open Configuration Files — project.config.jsonc と .cpqdevkit/developer.config.jsonc を開きます
• Change Environment — アクティブな Oracle CPQ 環境を切り替えます
• Diagnose Workspace — 設定とアクティブな環境のセットアップを検証します
• Show Status Bar — 環境ステータスバーを再表示します
• Open CPQ DevKit Website — CPQ DevKit のウェブアプリへ移動します

作成支援とユーティリティ

• Create BML Function — 新しい util.* または commerce.* の BML ファイルを作成します
• Find Workspace Impact — 現在の選択範囲、シンボル、ファイルを、ローカルの CPQ ワークスペース全体で分析します
• Search Workspace Artifacts — ダウンロード済みの Oracle CPQ 成果物を検索語で横断検索し、統合レポートを開きます
• View as Table — JSON/CSV/XML を検索可能なテーブルとしてプレビューします
• Convert to JSON — XML または CSV ファイルを JSON に変換します
• Convert to XML — JSON または CSV ファイルを XML に変換します
• Convert to CSV — JSON または XML ファイルを CSV に変換します
• Self-Test All Commands — 組み込みのコマンド利用可否チェックを実行します

ダウンロードと同期

• プロジェクトの主要なダウンロード — Download Files、Download Assets、Download Parts、Download Products、Download BML Functions、Download Data Tables、Download Data and Metadata、Download Data Table
• プライシングおよびコマースの成果物 — 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、Download Price Books
• サイトおよび管理系の成果物 — 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、Download Usage Metrics

デプロイ、検証、バックアップ

• Calculate Pricing — Oracle CPQ に対してプライシング計算を実行します
• Deploy Functions — BML 関数をアクティブな環境にデプロイします
• Save Functions — ローカルの BML 変更を Oracle CPQ に保存します
• Test Functions — サーバー上で BML テストを実行します
• Validate Functions — デプロイ前に BML を検証します
• Create Full Backup — 現在の環境のバックアップパッケージを作成します
• Create Site Snapshot — サイト全体の Oracle CPQ スナップショットを取得します
• List Available Backups — 利用可能なバックアップパッケージを閲覧してエクスポートします

AI

• Set AI API Key — AI 補完のための API キーを設定します
• Toggle AI Completions — インライン AI サジェストを有効化または無効化します
• Clear AI API Key — 保存されている AI API キーを削除します

設定

VS Code の設定で cpqdevkit.* 配下から拡張機能を設定できます。

要件

• VS Code 1.105+
• REST API アクセスが可能な Oracle CPQ Cloud 環境
• 次の条件を満たす BigMachines ユーザー：
  1. FullAdmin
  2. User Administrator が有効であること
  3. All Access 管理者グループに所属していること
• AI 支援機能を利用するための CPQ DevKit™ アカウントと API キー

プロジェクト設定ファイル

CPQ DevKit™ for Oracle を利用するには、プロジェクトディレクトリに 2 つの設定ファイルを作成します。Set Up Project と Create Developer Configuration File で自動生成できます。

1. project.config.jsonc — プロジェクト設定

このファイルは、プロジェクト全体のフォルダー規約と 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"  }}

主なオプション：

• apiVersion — Oracle CPQ の API バージョン（例：v19、v17、v15）
• tableFormat — ダウンロードするテーブルのフォーマット（json または csv）
• folderSettings — ファイル、パーツ、テーブル、BML、アセット、プライシング、メタデータ、ディクショナリー、インテグレーション用のローカルフォルダー名
• fileSettings — BML のプレフィックス、meta/test タグの動作、既定のデータフォーマットの設定

2. .cpqdevkit/developer.config.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>"    }  ]}

セキュリティとプライバシー

• ブラウザー経由で CPQ DevKit™ サービスにサインインすると VS Code に戻り、DevKit セッションは VS Code のシークレットストレージに保存されます
• Oracle CPQ インスタンスの URL、ユーザー名、パスワードは .cpqdevkit/developer.config.jsonc に保存されます。このファイルは .gitignore に登録し、ワークスペースのローカルに留めてください
• 匿名テレメトリは既定で無効であり、ファイルの内容や CPQ の顧客データは一切含まれません
• AI 補完は、有効化されている場合でも、カーソル周辺のごく小さなコードウィンドウのみを送信します
• バックアップ、スナップショット、テレメトリなどのクラウド接続ワークフローは、CPQ DevKit が管理するサービスを使用します

サポート

• 問題を報告する
• 機能をリクエストする
• メール：sales@cpqdevkit.com
• LinkedIn の CPQ Consultant

ライセンス

詳細は LICENSE.md をご覧ください。

よくある質問

CPQ DevKit™ for Oracle とは何ですか？

BML/BMQL ツール、環境を意識した同期ワークフロー、検証ツール、バックアップ、AI 支援補完によって Oracle CPQ 開発を加速する VS Code 拡張機能です。

複数環境とバックアップには対応していますか？

はい。複数の Oracle CPQ 環境を設定し、すばやく切り替え、VS Code の中から完全バックアップやサイトスナップショットを作成できます。

Oracle CPQ の成果物をダウンロードおよびデプロイできますか？

はい。拡張機能は、BML 関数、ファイル、アセット、パーツ、製品、データテーブル、プライシング成果物、インテグレーション、ディクショナリー、そして幅広い Oracle CPQ 管理リソースをカバーしています。

対応しているオペレーティングシステムは何ですか？

macOS、Windows、Linux です。

法的情報

Oracle および Java は、Oracle やその関連会社の登録商標です。その他の名称は、それぞれの所有者の商標である場合があります。

Node.js は Joyent, Inc. の商標です。当社は Joyent から承認を受けておらず、同社と提携関係にもありません。