Salesforce 統合に関する一般的な問題
CPQ と Salesforce の統合で発生する可能性のある問題を解決する方法について説明します。
Salesforce CPQ が CPQ 構成のホストである場合、2 つのサイトを統合すると、いくつかの一般的なエラーが発生します。ここでは、既知の問題とその解決策とその確認事項を一覧表示します。
一般に、Salesforce によって生成されたエラーが表示された場合は、 Salesforce デバッグログ を使用して、そのエラーがトリガーされている場所を見つけることができます。
Salesforce:「SBQQ:SOQL クエリが多すぎます:101」
このエラーは通常、ユーザーが 100 を超えるアイテムを含む BOM を作成し、[見 積もり で CPQ] をクリックし、デフォルトの Salesforce CPQ 動作では処理できないほど多くの見積明細行が作成されている場合に発生します。
ソリューション:Salesforce CPQ パッケージ設定で [大規模な構成を有効にする] が設定されていることを確認します。
この設定により、営業担当者が大きなバンドルを構成するときにガバナーの制限に達する可能性は低くなりますが、全体的なパフォーマンスは低くなります。この設定の詳細については、「 大規模な構成を有効にする」を参照してください。
Salesforce:「null オブジェクトの逆参照を試行」
このエラーは通常、エンドユーザーが見積もりを CPQ で保存し、QLE に戻る前に保存した場合に発生します。これは、影響を受けるアイテムの価格ブックエントリが欠落しているか非アクティブであるか、ネストされたバンドルの問題を表しています。
ソリューション (ネストされたバンドルなし):製品の価格ブックエントリがないか、非アクティブです。
製品のすべての価格ブックエントリを確認します。このエラーは、次のいずれかに該当する場合に発生します。
- 返品された製品に価格ブックエントリがありません
- 返品された製品には非アクティブな価格ブックエントリがあります
- 返品された製品の関連価格ブックは非アクティブです
- 標準価格表はデフォルトで使用されますが、非アクティブです
ソリューション (ネストされたバンドル):ネストされたバンドルを有効にしていて、構成に次の構造に一致する製品構成がある場合、直接的な解決策はありません。この Salesforce の問題が発生しないように構成を設計することも、ネストされたバンドルをオフにすることもできます。
Parent product
Nested child 1
Product X
Nested child 2
Product Xこの問題の詳細については、次の Salesforce.com トピックを参照してください。
ネストされたバンドルを無効にする場合は、SFDC で Salesforce CPQ >インストール済みパッケージのセットアップ>>外部コンフィギュレーターのネストされたバンドル>追加設定を使用して無効にできます。
また、サポートチケットを送信して、この要求を DevOps チームに送信して、 CPQ 側からこの機能をオフにしてください。この機能をオフにするまで、この問題は引き続き発生します。
構成品目または構成フィールドデータセットを生成していません
この機能は多くの実装で使用されていませんが、使用されている場合は、期待される Salesforce オブジェクトを作成することが最も重要です。構成品目 (CLI) と構成フィールドデータセット (CFDS) は、基本管理パッケージによって管理される Salesforce オブジェクトであり、それらの作成は見積明細にプッシュされるデータと非同期です。
ユーザーが CPQ から構成を保存した瞬間に、QLE で作成された最終的な見積品目を保存したかどうかに関係なく、これらのオブジェクトを作成するプロセスが開始されます。このような場合、通常、確認する場所は 1 つだけです。
解決策: これらのオブジェクトの作成は、次の設定が有効になっているかどうかによって異なります。
- (CLI の場合)[BOM データを Salesforce オブジェクト CPQ プッシュ] CPQ 管理設定
- (CFDS の場合)アドミン設定CPQ Salesforce オブジェクトCPQに構成データをプッシュ
- リフレッシュトークンユーザー名の SFDC 権限
これらの設定が有効になっていない場合、ユーザーが [保存] をクリックしても、これらのオブジェクトは作成されません。
これらの設定を有効にしても CLI または CFDS が表示されない場合 (または拡張情報フィールドマッピングが機能していない場合) は、次の操作を試してください。
- ログを調べて、「構成 [******] の LGK__ConfigurationLineItem__c オブジェクトの Salesforce 同期が正常に完了しませんでした (Salesforce syncing of object for configuration [] did not complete successfully)」というエラーが表示されるかどうかを確認します。Salesforce セットアップの [一時停止および失敗したフロー面談] ページに詳細情報がある場合があります。
- 統合ユーザーに必要な権限 のリストに対して統合ユーザーの権限を確認します。
保存しても子見積明細は作成されません
CPQ BOM には製品 CPQ 環境があります。
Salesforce への保存には親構成可能製品のみがあり、 CPQ 環境はありません。
BOM アイテムが次の条件に適合する場合にのみ、見積品目が作成されます。
- アイテムの BOM タイプは、[要求保存に含める BOM タイプ] 設定で指定されます
- 製品は、Salesforce との製品同期からデータベース内に存在します
この問題は、ユーザーが [ CPQ から保存] をクリックし、構成を起動した親構成可能製品のみが表示され、 CPQ コンフィギュレーターで作成された子見積品目が表示されない場合に発生します。これは通常、Salesforce の製品オブジェクトと CPQ で作成された BOM アイテムとの間に切断があることを意味します。
-
製品ルールで決定されているものと同じ製品 ID の製品が Salesforce サイトに存在するかどうかを確認します。製品が存在する場合は、製品レコードのフィールド (「アクティブ」など) を更新し、保存して元に戻し、30 分待ってからもう一度お試しください。
製品レコードの同期は、パフォーマンスを向上させるために product2 レコードの最終変更日に依存します。使用している環境が別の環境から再指定された場合、以前の環境に存在しなかった製品がここに存在し、再接続よりも古い日付になっている可能性があります。製品の同期が 30 分ごとに完了するのを待ってから、構成の保存を再試行します。
-
BOM アイテムが CPQ アドミンで定義されている正しい BOM タイプであることを確認します。
BOM アイテムのタイプが [製造] で、 CPQ アドミンが [設定] タブで [販売] と [インストール] のみを定義している場合、そのアイテムは QLE に返されません。
-
親構成可能製品に、関連する動的機能が定義されているかどうかを確認します。
その場合は、オプションの選択方法も動的であることも確認します。
この関連機能は、構成可能な製品で [Logik Enabled ] をクリックすると自動的に作成されますが、Salesforce 組織の一部のカスタム製品トリガーによってこの自動化が中断される可能性があります。機能の作成を再度トリガーするには、[ Logik Enabled] を無効にして保存し、再度有効にしてみてください。次に、その製品で構成してみてください。
(ネストされたバンドルを使用する場合、子見積品目が関連付けられているすべての製品には、最上位の親構成可能製品だけでなく、その製品に関連するこの動的機能が必要です)。
保存しても見積明細が想定どおりに作成されない
これは通常、子見積品目のフィールドの 1 つが、 CPQ 構成に反映されていない方法で入力されている場合に発生します。明確なエラーがないため、これは追跡するのが難しい問題です。
ソリューション:SFDC 環境に、見積明細に作用する見積算出プラグイン (QCP) スクリプト、フロー、または Apex トリガーがあるかどうかを確認します。
特に QCP の場合は、カスタムスクリプトを検索します。また、[見積もり算出プラグイン] フィールドにスクリプトがあるかどうかも確認します (Salesforce CPQ > プラグイン>インストール済みパッケージ>セットアップ)。
このカスタムスクリプトを確認して、期待どおりに動作しているかどうかを確認します。
CPQ:「JSON 文字列がヒープサイズ制限を超えています」
これは、LGK__BomData__cフィールドに含まれるデータが多すぎる場合 (大量の見積もり明細や拡張情報など)、ユーザーが見積もりを再構成しようとした場合に発生します。
解決策: BOM アイテム制限機能を使用して、書き込むアイテムの数を制御します。解決するには、エラーの原因となっている構成の BOM 内のアイテムをカウントします。(品目数はBOMの行数です。BomData フィールドでは、アイテムは「{}」で区切られます)。次に、サポートケースを作成して、テナント設定をその数の半分に設定します。この Salesforce フィールドを使用していない場合は、ゼロに設定します。
再構成しても選択内容が保存されない CPQ
エンドユーザーは構成を正しく保存でき、問題なく QLE に書き込むことができます。ただし、ユーザーが再構成しようとしても、すべての選択が保持されるわけではありません。
ソリューション:
- この問題が特定のユーザーまたはプロファイルでのみ発生するかどうかを確認します。権限が正しく設定されていない可能性があります。
- 製品に関連する機能名、構成属性、および価格表が定義されているかどうかを確認します。
- 詳細計画で ツインが使用されていないか (特定の選択をクリアするルールをトリガーしている可能性がある)、または [拡張の構成/再構成] が正しく設定されていないかを確認します。この問題の詳細については、「 スクリプティング:最初構成と後続構成の確認」を参照してください。
保存しても子見積明細は作成されません
構成しようとしている構成可能製品には、 CPQ が有効な自動化に問題があり、再構成に必要な構成属性が作成されていない可能性があります。再構成するには、見積明細行が以前の構成の UUID を参照する場所であるため、構成 ID 属性が存在する必要があります。
構成可能製品の詳細ページで、[ 有効] Logik.io オフにして保存し、構成属性が作成されているかどうかを再確認します。
SFDC から CPQ アドミンにアクセスできません
この問題により、アドミニストレーターが CPQの設計と実装に取り組めなくなる可能性があります。この問題の原因は多数あります。
ソリューション：
- これが 1 人のユーザーに対してのみ発生している場合:
- アドミンアクセス権があることを確認します。「ユーザーアクセス」を参照してください。
- ブラウザーの問題が発生していないかどうかを確認します。「使用中の一般的なブラウザの問題 CPQ」を参照してください。
- これがユーザーのグループで発生している場合:
- プロファイルと権限グループに適切な SFDC 権限があることを確認してください。「 Logik 構成の起動時に十分な権限がない、または空白の画面が表示される場合の対処方法」を参照してください。
- iFrame を有効にして、[セットアップ] セクションの [信頼できる URL] に CPQ が追加されていることを確認します。これはすべてのケースで必要というわけではありませんが、この追加機能は、複数の異なる国の CPQ ユーザーを持つ組織や、サブスクリプションマネージャー/RLM を使用している組織に役立つことがわかっています。
- これがすべてのユーザーで発生する場合は、URL が [カスタム設定] に正しく入力されているかどうかを確認してください。
これは通常、 CPQ 環境を SFDC 組織と統合するときに最初に実行されるステップの 1 つです。場合によっては、URL を設定したユーザーが、すべてのユーザー (中央のボックス) にアクセスできるのではなく、意図せずにプロファイル (下部のボックス) の上書きとして URL を設定してしまうことがあります。
構成を起動できません
Salesforce からの「権限が不十分です」というエラーメッセージは、QLE でレンチアイコンをクリックしたとき、または見積もりの [ 行を編集 ] をクリックした後に製品を選択したときに表示される多くの画面のうちの 1 つにすぎません。
この問題が発生すると、他の問題としては、[コンテンツがブロックされました] 画面の表示 (SFDC から CPQ アドミンにアクセスできない問題を参照)、空白の画面が表示される、エラーメッセージが表示されるなどがあります。
これは、 CPQ アドミンへのアクセスに必要なのと同じ権限に関する問題など、さまざまな理由で発生する可能性があります。ただし、この問題はコンフィギュレーターのエンドユーザー (つまり、営業/パートナーユーザー) にのみ影響します。
ソリューション:
- これが 1 つの詳細計画でのみ発生する場合、または 1 つの見積もりから起動した場合は、 CPQ アドミンの [ログ] タブでエラーがないか確認します。
ログにエラーがない場合は、 一般的なエラーメッセージと原因を確認してください。これは、詳細計画の構成/再構成時スクリプトの問題、または見積もりから予期されるツインフィールドが原因である可能性があります。
- これが 1 人のユーザーに対してのみ発生している場合は、ブラウザーの問題が発生していないかどうかを確認します。「使用中の一般的なブラウザの問題 CPQ」を参照してください。
- ユーザーのグループでこれが発生している場合は、そのプロファイルと権限グループに適切な SFDC 権限があるかどうかを確認してください。「 Logik 構成の起動時に十分な権限がない、または空白の画面が表示される場合の対処方法 」を参照してください。
- これがすべてのユーザーで発生する場合は、Salesforce CPQ で URL が正しいことを確認してください。[セットアップ] > [インストール済みパッケージ] > [Salesforce CPQ >] に移動し> [外部コンフィギュレーター URL] と [サードパーティコンフィギュレーター] > [追加設定を構成] に移動します。
これは通常、 CPQ 環境を SFDC 組織と統合するときに最初に実行されるステップの 1 つです。URL は通常
https://<domain-name>.<sector>.logik.io/ui/configureの形式をとりますが、VisualForce ページを使用してコンフィギュレーターを起動するかどうかによって異なる場合があります。URL が上記のフォームにない場合は、組織に CPQ コンフィギュレーターを起動するためのカスタムセットアップのドキュメントが必要です。
パートナーユーザー/RFQ API 共有設定
- 価格ブック
- 製品の特徴
- 見積もり
- 見積明細
- 構成属性
- 構成品目
Salesforce CPQ は、再構成された統合の一部でこれらのオブジェクトにアクセスする必要があります。
通常、このオブジェクトは統合ユーザーによって作成されるため、このオブジェクトの共有設定を編集する必要はありませんが、多くの場合、パートナーユーザーが RFQ 中にこれらのレコードを参照しようとする可能性があるため、パブリック読み取り専用またはパブリック読み取り/書き込みのいずれかに設定する必要があります。
Salesforce プラットフォームの問題
「レコードの保存中にエラーが発生しました」というメッセージが表示される場合があります。
レコードの保存中にエラーが発生しました:構成可能な製品を静的製品に変換できませんでした。子コンポーネントが要件を満たしていることを確認して、もう一度やり直してください。
このエラーは、Product2 レコードの [ LGK__IsConfigurable__c ] フィールドのチェックを外そうとしたときに発生する可能性があります。この問題を解決するには、Salesforce アプリランチャーから Logik.io アドミンカスタム設定ページにアクセスし、[ 構成可能な製品セットアップトリガーをスキップ ] 設定を有効にします。