B2B カスタマイズの Commerce カタログの拡張性に対する影響
この記事では、Microsoft Dynamics 365 Commerce の B2B のコマース カタログ 機能の拡張性への影響について説明します。
カタログ コンテキストをカスタム シナリオに拡張することに関心を持っている場合は、カスタマイズを更新する必要があります。 この更新は、アップグレードの実行後にカスタマイズが最新の機能を自動的にサポートしない可能性があるため、顧客が従う必要のある標準プロセスに従います。 カスタマイズに新しい機能やバグ修正プログラムが含まれる場合は、それ経験に応じてカスタマイズ コードを更新することをお勧めします。 この更新は、Microsoft がコア コードに対して行った可能性のある変更に似ています。
以下のカスタマイズ ケースを確認して、カスタマイズを更新する必要があるかどうかを判断します。
メモ
- すべての販売促進アプリケーション プログラミング インターフェイス (APIs) は、カタログに対応している必要があります。 したがって、CatalogID パラメーターを渡すことが重要です。
- 既定のカタログ (CatalogID=0) は、サインインした企業間 (B2B) ユーザーの有効なカタログではありません。 したがって、サイト ユーザーはカタログ 0 にアクセスできないため、「0」を渡すか既定値を使用するすべての API 呼び出しは失敗します。 正しいエクスペリエンスを得るには、カタログ ピッカーで選択されたカタログ ID を渡すように、カスタマー API 呼び出しを更新する必要があります。 既定値を使用し、ユーザーがカタログを切り替える場合、Web サイトは選択したカタログのデータを提供する必要があります。 したがって、コア コマース コードから実行される API と一致させるには、カスタマイズされた API が選択されたカタログを渡す必要があります。
次のカスタマイズ ケースでは、開発の更新が必要です。
ケース1: 顧客が独自のデータ アクション 紹介する 製品関連のAPIまたはデータ アクションを呼び出します。 次の更新手順が必要です。
データ アクションで直接 API 呼び出しを使用する場合は、次の例に示すように、データ アクションを更新して、カタログ ID を渡すようにします。
データ アクションがカスタマイズ内で別の製品関連のデータ アクションを呼び出す場合は、requestContext などの新しいパラメーターを渡すようにコードを更新する必要があります。 次の例に示すように、requestContext パラメーターは、現在のカタログ ID を取得するために使用されます。
ケース2: 顧客に アクションがある場合。 次の更新手順が必要です。
- ケース 1 のデータ アクションを更新します。
ケース3 : A顧客に表示拡張子、スクリプト モジュール、または に含まれるモジュール APIまたはデータ アクションへの呼び出しが含まれる場合 次の更新手順が必要です。
次の例に示すように、ケース 1 のコードを更新します。
ケース4 : 顧客 がagetById API 使用する場合 次の更新手順が必要です。
- getById APT 呼び出しにはいくつかの制限があり、カタログ認識をサポートしていないため、代わりに getByIds API 呼び出しに切り替えます。
ケース5: A顧客が、異なるカタログから複数の製品の情報を取得するデータ アクションがある場合 次の更新手順が必要です。
API 呼び出しをカタログ ID で分割します。 たとえば、カートの API の場合は、カートには異なるカタログの商品が含まれている可能性があります。 次の例に示すように、製品明細行はカタログ ID ごとにグループ化する必要があります。また、各カタログの API を個別に呼び出す必要があります。