Loading
Salesforce から送信されるメールは、承認済ドメインからのみとなります続きを読む

Salesforce CPQ インストール後スクリプトの考慮事項

公開日: Sep 27, 2025
説明

Salesforce CPQ がインストールされるかパッケージがアップグレードされると、CPQ パッケージは「インストール後スクリプト」を実行して、CPQ 項目を、導入された CPQ 機能の適切な値に調整します。この項目値はダウンストリームの他のプロセスに供給される可能性があります。

注意:インストール後スクリプトを実行すると、このアクションによって影響を受ける項目には、インストールスクリプトを開始したユーザーが [更新者] として記録されます。これらのスクリプトのユーザーやステータスなどの詳細は、[Apex ジョブ] で確認できます。

注意:組織が自動アップグレードプログラムを使用している場合 (https://help.salesforce.com/s/articleView?id=000319060&type=1)、アップグレードは標準のシステム管理者プロファイルを持つ一時ユーザーとしてインストール後スクリプトを実行します。共有が有効になっている Apex クラスを使用してカスタムトリガーまたは管理されたトリガーを呼び出すスクリプト更新は、失敗の原因になります。システム管理者としてスクリプトを再実行してください。


インストール後スクリプトが実行されている間、CPQ パッケージトリガーは無効になります。

注意: インストール後スクリプトは、CPQ 以外の項目には影響しません。

レコード編集時に起動するか、CPQ 項目を実行条件として使用するプロセスオートメーション (ワークフロールール/プロセスビルダー/カスタムトリガー) が組織にある場合、レコード編集時に実行されるカスタムオートメーションがインストール後スクリプトと競合する可能性があります。これは、CPQ が更新する可能性のある特定のオブジェクトの編集時に実行される、他のインストール済みパッケージの Apex トリガーにも当てはまります。

他のパッケージが CPQ インストール後スクリプトで問題を引き起こしている場合、これらのパッケージトリガーを無効にして潜在的な競合を回避する選択肢があります。

更新されるレコードのオブジェクトのカスタム入力規則が、検証基準を満たすか、無効である場合、競合が発生する可能性があります。 

    解決策

    エラーの原因を確認するには、[追加の設定] タブにある [インストール済みパッケージ] の設定に移動し、[更新状況] を押します。そこに表示されるエラーから失敗の原因を特定できます。あるいは、失敗したバッチ処理を [Apex ジョブ] の設定で確認します。インストール後スクリプトには次の一括処理ジョブがあります。これらはインストール時、または [設定] > [インストール済みパッケージ] > Salesforce CPQ パッケージの [設定] > [追加の設定] タブの順に移動して [Execute scripts] (スクリプトを実行) を押したときに実行されます。

    • InstallProcessorBatchAssetCombineKey - 納入商品の SBQQ__CombineKey__c を最新の見積品目 ID または見積品目 ID に更新します。
    • InstallProcessorBatchQLIPriceBookEntry - 見積品目の価格表エントリ ID (SBQQ__PricebookEntryId__c) に、見積の価格表と見積品目の商品に基づいて価格表エントリの ID を入力します。
    • InstallProcessorBatchLocalizationIndex - ローカライズレコードが最新で、正しい商品に関連付けられていることを確認します。
    • InstallProcessorBatchOrderItemListPrice - OrderItem の見積済みリスト価格 (SBQQ__QuotedListPrice__c) に、関連する見積品目のリスト価格を入力します。
    • InstallProcessorBatchOrderItemMultiplier - 注文商品の按分の乗数 (SBQQ__ProrateMultiplier__c) に、関連する見積品目の按分の乗数を入力します。
    • InstallProcessorBatchRegularPrice - 定価 (SBQQ__RegularPrice__c) が null で、関連する見積品目の定価が null でない場合、購読に RegularPrice を入力します。
    • InstallProcessorBatchRequiredByAsset - 納入商品 (SBQQ__RequiredByAsset__c, SBQ__RootAsset__c, SBQ__Number__c) に RequiredByAsset、RootAsset、Number を入力します。
    • InstallProcessorBatchThemeGenerator - ドキュメントを作成し、ドキュメントで定義されているテーマに関連付けます。
    • BatchablePluginTranspileUtil - カスタムスクリプトの QCP 項目をトランスパイルします。
    • BatchableDSExclusionGenerator - 割引率表に除外を追加します。
    • BatchableConfigAttrReferencedFieldUtil - 設定属性の対象項目に基づいて ReferencedFields (保護された SBQQ カスタム設定) が作成されます。
    • InstallProcessorQueueable - これは実行される唯一の Queuable ジョブであり、一括処理ジョブではありません。これにより、計算で使用するための価格ルールおよびサマリー変数の対象項目から計算機能参照項目 (保護された SBQQ カスタム設定) が作成されます。これらの参照項目は、価格ルールの有効化またはサマリー変数の作成時に自動的に作成されます。Salesforce CPQ の初期インストール時にはこれらのレコードが存在しないため、実行されません。

    アップグレード/新規インストール時には、上のすべてのバッチ処理に加え、次が実行されます。

    • InstallProcessorBatchOIPricingMethod - 注文商品の価格設定方法項目 (SBQQ__PricingMethod__c) を更新し、見積品目の価格設定方法と一致させます。
    • InstallProcessorBatchOpportunity2 (以前のバージョンからのアップグレード時のみ) - 非推奨の主従関係 SBQQ__Opportunity__c から見積の SBQQ__Opportunity2__c を更新します。
    • InstallProcessorBatchOrderItemBundleRoot - (関連する見積品目から) バンドル内のルート商品を使用して OrderItems に SBQQ__BundleRoot__c 項目を設定します。
    • InstallProcessorBatchOrderItemFields - 注文商品に SBQQ__ContractAction__c (注文商品レコードの他のデータに基づく) と SBQ__RevisedOrderProduct__c (納入商品/購読に基づく) を設定します。
    • InstallProcessorBatchQuantityEditable - 商品の数量編集可 (SBQQ__QuantityEditable__c) を true に設定します。
    • BatchOrderItemAssetContractSubs - 該当する場合、OrderItems の納入商品、契約、購読項目 (SBQQ__Asset__c, SBQQ__Contract__c ,SBQ__Subscription__c) を更新します。
    ナレッジ記事番号

    000382092

     
    読み込み中
    Salesforce Help | Article