環境から環境への詳細計画の移行

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • CPQ環境間で詳細計画を移行して、一貫した構成管理を確保します。マトリクスローダーを使用して詳細計画パッケージを安全にエクスポート、更新、およびインポートし、テスト済みの構成を開発から本番に昇格します。

    始める前に

    CPQ アップグレードスケジュールで説明されているアップグレード期間CPQ理解します。公開されたアップグレード期間を避けるように移行をスケジュールします。このトピックについて質問がある場合は、カスタマーサクセスマネージャーにお問い合わせください。

    このタスクでは、次の用語が使用されます。

    ソース
    機能の移行元の環境。
    移動先
    機能の移行先の環境。
    移行パッケージ
    宛先環境にインポートするために、ソース環境からエクスポートされたファイル。

    このタスクは、移行が一度に 1 つ以上の詳細計画で実行されることを前提としています。

    必要なロール:(不明)

    手順

    1. ソースから詳細計画をエクスポートします。
      1. ソース環境で、名前の横にあるチェックボックスをクリックして、移動する詳細計画を選択します。ブレプリント
      2. [エクスポート] をクリックします。ブループリントのエクスポート
        左下隅にあるベルアイコンで通知を確認します。最初の通知は、エクスポートプロセスが開始されたことを示します。エクスポートが完了すると、詳細計画をダウンロードする準備ができたことを示す 2 回目の通知が表示されます。
      3. ブループリントをダウンロードするには、ベルアイコンメニューの [ ダウンロード ] リンクをクリックします。ブループリントをダウンロード
      4. 詳細計画をローカルマシンまたは Git などの集中管理リポジトリに保存します。
      5. 環境が Salesforce と統合されており、詳細計画を初めて移行する場合は、前提条件を確認し、 SFDC 統合宛先への詳細計画の移行のステップ 1 を実行します。
    2. 移行パッケージを変更します。
      1. 手順 1 でダウンロードした詳細計画 ZIP ファイルを解凍します。
        ファイルが blueprint.yaml ファイルに解凍されます。

        blueprint.yaml ファイルの選択

      2. テキストエディターで blueprint.yaml ファイルを開きます。

        詳細計画の以前のバージョンが存在する保存先に詳細計画を移行する場合は、ファイルの最後に次の行を追加することをお勧めします。

        fullBlueprintMigration: true

        編集された blueprint.yaml ファイルのサンプル:

        ---
blueprints:
- variableName: someBlueprint
  related Fields:
  - field1
  - field2
  - field3
  lastModifiedBy: dev5@dev.logik.io
  name: someBlueprintName
  description: BP description goes here
  relatedSets: null
  scripts: null
  layouts: null
  products: null
productPickers: /fields/productPickers.yaml
sets: null
fieldOptions: /fields/fieldOptions.csv
rules: /rules/rules.csv
fields: /fields/fields.csv
fullBlueprintMigration: true

        このパラメーターが詳細計画の移行にどのように影響するかについては、「 fullBlueprintMigration パラメーター」を参照してください。

      3. 環境が Salesforce と統合されていて、詳細計画を初めて移行する場合は、「 SFDC 統合宛先への詳細計画の移行」のステップ 2 を実行します。
      4. 編集内容を保存し、blueprint.yaml ファイルを閉じます。
    3. 移行パッケージのすべてのコンポーネント (blueprint.yaml、blueprints フォルダー、fields フォルダー、rules フォルダー、および移行パッケージには存在しているが親フォルダーには存在しないその他のアーティファクトを含む) を新しい ZIP ファイルに圧縮します。ブループリントをダウンロード
      重要:
      圧縮するときは、親フォルダ自体ではなく、解凍したブループリントのエクスポートの内容のみを選択してください。親フォルダーが選択されている場合、 CPQ アドミンにアップロードするとエラーが表示されます。

      インポートログ

    4. 移行する詳細計画に関連するコンポーネント (詳細計画で使用される管理対象テーブルや外部接続など) を本番テナントに移行します。
    5. 詳細計画を宛先にインポートします。
      1. CPQ宛先環境の管理領域にログインします。
      2. マトリクスローダーを開きます。
      3. 編集した移行パッケージの ZIP ファイルをマトリクスローダーのドロップ領域にドラッグします。
      4. [ 次へ] をクリックし、[ インポート] をクリックします。
      インポート後にエラーが発生した場合は、画面の指示に従ってエラーログを確認してください。
    6. 移行をテストします。
      1. 環境が Salesforce と統合されていて、詳細計画を初めて移行する場合は、「 SFDC 統合宛先への詳細計画の移行」のステップ 3 と 4 を実行します。
      2. 移行先 CPQ 環境のエンドユーザー UI から、移行された詳細計画を確認します。