マトリクスローダー:CSV ルールのアップロード

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:5分
  • マトリクスローダーを使用して、 CPQでルールを一括作成、編集、およびエクスポートします。CSV ファイルでルールの条件、アクション、およびロジックを定義して、構成管理を簡素化し、大規模な更新を自動化します。

    マトリクスローダーを使用すると、アドミニストレーターは CPQ内のすべてのルールタイプを効率的にアップロードおよび管理できます。アドミンインターフェイスで各ルールを手動で作成する代わりに、スプレッドシートでルールを定義し、シートを CSV 形式にエクスポートして、環境に直接アップロードできます。これにより、構成セットアップが迅速化され、テストが容易になり、サンドボックス環境と本番環境間の移行が簡素化されます。

    ルールアップロード構造

    CSV ファイルの各行は 1 つのルールレコードを表します。次の表は、マトリクスローダーがルールのアップロードで受け入れる列とデータの概要を示しています。

    表 : 1. ルールのアップロードで許可される列とデータ
    列名 説明 有効な値 メモ
    record_type これをルールアップロードとして識別します ルール 必須
    rule_name ルールリストの管理ページに表示される名前 有効な文字列は、文字、数字、スペース、および次の特殊文字を含む最大 255 文字で構成できます: {}[]()|\~'_^@?<=>;:/.-,+*'&%$#"! 必須
    rule_variable_name ルールを参照するために CPQ によって使用される一意の文字列 有効なフィールド変数名は、最大 128 文字の英字、数字、アンダースコアで構成されます。最初と最後の文字は文字または数字である必要があります。 必須;一意である必要があります
    rule_description アドミニストレーター参照用のコンテキストの説明 有効な文字列は、文字、数字、スペース、および次の特殊文字を含む最大 255 文字で構成できます: {}[]()|\~'_^@?<=>;:/.-,+*'&%$#"! オプション
    rule_status ルールがアクティブかどうかを判別します アクティブ、非アクティブ 必須です。非アクティブなルールはエンジンによって無視されます
    action_type ルールの実行時に実行されるアクションのタイプを定義します ヴィジビリティ、メッセージ、除外、包含、決定、製品 必須
    action_sub_type 補足定義の拡張action_type 非表示、情報、警告、エラー、非表示、無効、設定、forceset、製造、営業 オプション。action_typeに依存
    action_field アクションが適用されるフィールド <field variableName> 必須
    action_value action_fieldに適用される値 アクションタイプによって異なる メッセージ、除外、包含、または決定アクションに必要
    action_product 部品表 (BOM) アクションの製品参照 SFDC 製品コード、製品 2 ID、または外部 ID 製品アクションに必要
    action_quantity BOM に追加された製品の数量 <正の浮動小数点数>または<正の整数> 製品アクションに必要
    action_mandatory BOM 製品がオプションか必須かを指定します TRUE、FALSE、<空> オプション。デフォルトは TRUE です
    グルーピング 条件をグループ化して評価する方法を定義します 任意、すべて、カスタム、常時 必須
    リソース/演算子/値 ルールロジックを形成する条件タプルを定義します <field variableName>、operator、value リソース、演算子、および値とともに条件式を定義します

    条件グループ化

    条件のグループ化によって、ルール条件を論理的に組み合わせる方法が決まります。サポートされているオプションは次のとおりです。
    • any:行に定義されているすべての条件を OR にします。
    • all:行で定義されているすべての条件。
    • custom:(1 OR 2) AND 3 などの複雑なロジック式を許可します。
    • 常時:ルールを無条件に適用します。

    有効な演算子

    条件評価では、次の演算子がサポートされています。
    • 次の値に等しい (=、==、次の値に等しい)
    • 等しくない (!=)
    • 次の値未満 (<)
    • は次の値以下 (<=)
    • 次の値を超える (>)
    • 次の値以上 (>=)
    • 次の値を含む/含まない
    • 入力/含まない

    一般的なガイドライン

    • 変数名がフィールド参照と正確に一致していることを常に確認してください。
    • ルールの説明は、トラブルシューティングに役立つように簡潔かつわかりやすいものにしてください。
    • 本番環境で有効にする前に、非アクティブステータスを使用して新しいルールをテストします。
    • グループ化ロジック (任意/すべて/カスタム) を慎重に検証して、意図しない結果を回避します。
    • 製品参照 (製品 2 ID または外部 ID) が Salesforce 構成と一致していることを確認します。

    CSV へのルールのエクスポート

    アドミニストレーターは、レビューまたは移行のために、 CPQ 環境からすべてのルール定義を CSV 形式にエクスポートできます。結果の ZIP ファイルには、エクスポートされたすべてのルール定義の単一の CSV ファイルが含まれます。
    1. 左側のアドミンナビゲーションペインで、[ ルール] をクリックします。
    2. オプション:検索文字列を入力して Enter キーを押して、結果を絞り込みます。
    3. [エクスポート] をクリックします。エクスポートを確認するメッセージがページの下部に表示されます。
    4. 通知センター (左下) を開き、[ ダウンロード ] リンクをクリックします。

    追加情報

    • 有効な文字列には、文字、数字、スペース、および特殊文字を含めることができます: { } [ ] ( ) | \ ~ ' _ ^ @ ? < = > ; : / . - , + * ' & % $ # "
    • ルール変数名には、最大 255 文字の英数字とアンダースコアを含めることができます。文字または数字で開始および終了する必要があります。
    • サンプルファイルの背景がグレーのセルは、現在のコンテキストとは無関係なフィールドを示します。
    • 書式設定のテンプレートとして、提供されているサンプルファイル (アドミン→マトリクスローダー→サンプルファイル→ルール) を使用します。