1. カート サービス レイヤー

カートパイプライン

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Cart APIで使用される統合ロジックとエンゲージメント ロジックは、必要に応じてカスタマイズできるパイプラインによって実装されます。APIの各メソッドにはパイプラインがあります。一部のパイプラインは、SaveCartパイプラインやLoadCartパイプラインなどの他の一般的なパイプラインを呼び出します。場合によっては、ロジックはいくつかのサブパイプラインに分割され、CreateOrResumeCartパイプラインで使用されるようなif-than-else状況を処理します。

GetCartsパイプライン

名前：

GetCartsの

形容：

パイプラインは、すべてのカートに対して検索を実行し、指定された検索条件に一致する、見つかったカートのCartBaseインスタンスの一覧を返す役割を担います。

カートは、ECSとEAの両方の状態で保持される場合があります。

メインカートリポジトリの場所に応じて、パイプライン用に設定されたプロセッサは、異なるConnectプロバイダーの実装間で異なります。

使い：

カートを検索するときに、Connect APIのGetCartsメソッドを介して呼び出されます。

引数:

要求 - 検索条件 (UserID、CustomerID、CartName、CartStatus、IsLocked、ShopName) が含まれます。これは、パイプラインを呼び出す前に設定されます。

Response - カートオブジェクトが含まれます。これは、パイプラインの実行後に読み取られます。

プロセッサ：

GetCartsFromEAState –

責任 - 入力パラメータ(UserID、CustomerID、CartName、ShopName)に一致するすべてのユーザーのEA状態に保存されているカートに対してクエリを実行します。

デフォルトの実装では、プロセッサは次の名前の2つに分割されます。

  • BuildQueryです。

  • ExecuteQueryです。EAリポジトリをクエリします

使用法:プロセッサは、EA状態での検索とカートのリストを返すための汎用です。 If the external commerce system supports persisting carts then the processor(s) should be replaced by the custom GetCarts processor querying against ECS, see below.

Ownership:プロセッサにはConnectが付属しています

Customization: さらに検索パラメータが必要な場合は、プロセッサを継承して上書きして検索する必要があります

GetCartsの -

Responsibility - 外部コマースシステムに保存されているカートのうち、入力パラメーター (UserID、CustomerID、CartName、ShopName) に一致するものに対してクエリを実行します。

Usage:ECSがカートの永続性をサポートしている場合、このプロセッサはEAの状態に対してクエリを実行するデフォルトのConnectプロセッサを置き換えます。

If not supported, EA state and GetCartsFromEAState processor(s) must be used instead .

Ownership:ECSベンダー

Customization: プロセッサはECSに対してカスタムです。より多くの検索パラメータが必要な場合は、それをサポートするようにプロセッサを拡張する必要があります。

CreateOrResumeCartパイプライン

名前：

CreateOrResumeCart (英語)

形容：

ショッピング・カートの作成を開始し、その過程で次のことを行います。

  • 放棄された可能性のある永続化されたカートをロードし (存在する場合)、それを返します。

  • 新しいカートが作成された場合にDMSでイベントをトリガーします。

  • 新しいショッピングカートのIDを使用してEngagement Automationプランにユーザーを入力します。

パイプラインは、既存のカートが見つかり、再開できるかどうかに応じて、異なるパイプラインを呼び出します。

使い：

Connect APIのCreateOrResumeCartメソッドを介して呼び出されます。

引数:

依頼- 既存のカートの検索にも使用される基本的なカートパラメータが含まれています。パイプラインを呼び出す前に設定されます。

応答- カート オブジェクト、または指定されたパラメーターに一致するカートが複数存在する場合のCartBaseインスタンスの一覧が含まれます。パイプラインが呼び出された後にカート プロバイダーによって読み取られます。

プロセッサ：

FindCartInEAステイト –

Responsibility:現在の連絡先/訪問者のEA状態で、入力パラメータUserID、CustomerID、CartName、およびShopNameに一致するカートを見つけます。

一致が見つかった場合、カートIDはカスタム パイプライン引数CartID (args.CustomData"カートID")

プロセッサは、LoadCartメソッドを呼び出す前に、既存のカートのカートIDを取得する必要があります

Usage: プロセッサは、EA状態で検索し、指定された入力パラメーターに一致するカートのカートIDを返すための汎用プロセッサです。

Ownership:プロセッサにはConnectが付属しています。

Customization: 追加のクエリ パラメーターが導入されない限り、既定の機能をすぐに上書きする必要はありません

ランロードカート –

Responsibility: LoadCart パイプラインを呼び出し、指定されたIDでカートをロードします。IDはCartId パラメーターで指定されます。

カートが見つからなかった場合、カートはパイプライン引数でnullまたは空です。

Usage：必須。プロセッサは、CartIDでカートを読み込むLoadCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

カートの読み込みに使用されるCartIDは、顧客パイプラインに格納されていると想定されます: arg "CartID" (args.CustomData"カートID")

RunResumeCartパイプラインは、再開するカートが実行される前に読み込まれていることを前提としています。

Ownership:プロセッサにはConnectが付属しています

Customization: デフォルトの機能をすぐに上書きする必要はありません。

RunResumeCart –

Responsibility: 可能であれば、ロードされたカートを再開するためにResumeCartパイプラインを呼び出します。

パイプライン引数にカートが存在することが想定されます。

カートが存在しない場合、プロセッサはResumeCartパイプラインを呼び出しません。

Usage：必須。プロセッサは、ResumeCartパイプラインを呼び出すための汎用プロセッサです。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

RunCreateCart –

Responsibility: 新しいカートを作成するためにCreateCartパイプラインを呼び出します。

パイプライン引数にカートが存在しないことが想定されます。

カートが存在する場合、プロセッサはCreateCartパイプラインを呼び出しません。

Usage：必須。プロセッサは、CreateCartパイプラインを呼び出すための汎用プロセッサです。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

CreateCartパイプライン

名前：

クリエイトカート

形容：

新しいショッピングカートを作成して保存し、その過程で次の操作を行います。

  • 新しいカートのDMSでイベントをトリガーします。

  • 訪問者/コンタクトを新しいショッピングカートでエンゲージメント自動化プランに入力します。

使い：

カートが存在しない場合にブランチの1つとしてCreateOrResumeCartパイプラインから呼び出されます。

引数:

依頼- CreateOrResumeCartパイプラインと同じパラメーターが含まれます。CreateOrResumeCartパイプラインから引き継がれます。

応答- カート オブジェクトが含まれます。パイプラインが呼び出された後にカート プロバイダーによって読み取られます。

プロセッサ：

クリエイトカート –

Responsibility: 新しいカートを作成するには、引数から値を初期化して返します。

カートがパイプライン引数に既に存在する場合、そのカートは無視され、上書きされます。

Usage：随意。デフォルトのプロセッサは、ドメインモデルのカートを作成し、値を初期化するための汎用プロセッサですが、ECSを呼び出すことはありません。

一部の統合シナリオでは、この時点でECSを呼び出して新しいカートを作成することが適切です。その場合、このプロセッサは、カート ドメイン オブジェクトを初期化するため、基本クラスとして拡張することも、完全に置き換えることもできます。

他の統合シナリオでは、この時点ではECSは呼び出されません。代わりに、カートのラインを操作するとき、またはカートを保存するときにのみ呼び出される可能性があります。これは、統合するシステムによって異なります。

Ownership:プロセッサにはConnectが付属しています

Customization: プロセッサを基本クラスとして使用し、カート ドメイン モデル オブジェクトを初期化した後にECSを呼び出して拡張すると便利です。

RunSaveCart –

Responsibility: SaveCart パイプラインを呼び出して、指定したカートを保存します。

Usage: オプションですが、カートに変更が加えられた場合 (この場合) は常に呼び出す必要があります。このプロセッサは、SaveCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

TriggerPageEventForResultCart –

Responsibility: 指定したページ イベントをトリガーし、カートの値 (ExternalCartId、UserId、CartName、CartStatus) を登録します。

ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。このプロセッサは、argsに格納されているカートの指定されたパラメーターを使用してページ・イベントをトリガーするための汎用です。Result引数。

トリガーされるイベントは、PageEventName プロセッサ パラメーターで指定されます。

使用するイベント・テキストは、PageEventText プロセッサー・パラメーターで指定されます。

Ownership:プロセッサにはConnectが付属しています。

Customization:カートから他の値を登録したい場合は、プロセッサを上書きします。

ResumeCartパイプライン

名前：

CreateOrResumeCart (英語)

形容：

argumentsとプロセスで指定されたカートを検証し、再開します。

  • 放棄されたカートのエンゲージメント (再起動) の初期状態に状態を変更します。

  • カートの状態を更新します

  • カートを保存します

  • DMSでイベントをトリガーします。

使い：

SitecoreからConnect APIを介して呼び出されます。

引数:

依頼- 検索条件が含まれ、パイプラインを呼び出す前にカート プロバイダーによって設定されます。

応答- カート オブジェクトが含まれ、パイプラインが呼び出された後にカート プロバイダーによって読み取られます。

プロセッサ：

ChangeCartStatus –

Responsibility: カート ステータス フィールドを、定数CartStatus.InProcessから取得したInProcess値で更新します。

Usage：随意。プロセッサは汎用ですが、カートに設定されたステータス値はInProcessに固定されています。

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを更新して、コード内の定数ではなくパラメータから状態値を取得できます。

RunSaveCart –

Responsibility: SaveCartパイプラインを呼び出して、指定したカートを保存します。

Usage：必須。このプロセッサは、SaveCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

TriggerPageEventForResumedCart –

Responsibility: カートの再開時に指定したページイベントをトリガーし、次のカート値を登録します。

  • ExternalCartId、UserId、CartName、CartStatus、StateName (移動元の以前の状態を含む)。

ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。このプロセッサは、カートの再開と、argsに格納されているカートから指定されたパラメーターを使用してページ イベントをトリガーするための専用です。Result引数。

前の状態の値は、PreviousState パイプラインの引数にあり、ExternalCartIdと共にページ イベント テキストに挿入されます .

使用するイベント・テキストは、PageEventText ・プロセッサー・パラメーターで指定します

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを上書きして、カートから他の値を登録したり、テキストの書式設定を変更したりします。

LoadCartパイプライン

名前：

ロードカート

形容：

指定した条件に一致するカートをロードします。たとえば、IDやShopNameなどです。

このパイプラインは、コマース システムによって管理されている特定のカートのデータを読み取る役割を担います。このパイプラインは、コマース システムやEngagement Automation状態からカート データを読み取ります。

使い：

  • SitecoreからConnect API LoadCartメソッドを介して直接呼び出されます。

  • Connect API CreateOrResumeCart メソッドを介して間接的に呼び出されます。

引数:

依頼- 取得するカートを決定する基準が含まれています。は、パイプラインを呼び出す前に設定されます。

応答- パイプラインが呼び出された後のカート オブジェクトが含まれます。

プロセッサ：

LoadCartFromEAState –

Responsibility:

EAの状態から、指定されたCartIDを持つ既存のカートを、ShopNameパラメータで指定されたショップにロードします。

パフォーマンス上の理由から、デフォルトの実装は次のように機能します。

  • まず、カートは現在の訪問者/連絡先EAの状態データからロードされ、指定されたパラメータによってフィルタリングされます。見つかった場合は、パイプラインのResponse argプロパティに書き込まれ、実行が停止します。

  • 見つからない場合、すべての連絡先のすべてのカートがロードされ、指定されたパラメーターによってフィルタリングされます。すべての連絡先を検索するのは、コストのかかる操作です。

  • カートがEA状態で見つかった場合、パイプラインのResponse argプロパティに書き込まれます。

Usage: プロセッサは、EA状態からカートをロードするための汎用プロセッサです。

ECSでカートの永続性が利用できない場合、またはカートの処理がSitecoreのみで行われる場合は、プロセッサをLoadCart パイプラインで単独で使用できます。

また、ECSがカートリポジトリを単独で管理している場合も、パイプラインから除外される可能性があります。

一部のECSシステムでは、カート ドメイン モデルで指定されたすべての情報が提供されず、メイン データがECSから読み取られ、追加のプロセッサを挿入してEA状態に格納された追加のカート データで拡張されるハイブリッド構成が使用される場合があります。

放棄されたカートはECSからパージされる可能性がありますが、SitecoreではEA状態のままです。この場合、パイプラインに両方のプロセッサを含めるのが理にかなっている場合があります。その後、Sitecoreはカートのバックアップ ストレージとして機能します。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません

ロードカート –

Responsibility :

ECSから、指定されたCartIDを持つ既存のカートを、ShopNameパラメーターで指定されたショップにロードします。

Usage: このプロセッサは、ECSからカートをロードするための専用プロセッサです。

ECSでカートの永続性が使用可能な場合、プロセッサはLoadCart パイプラインで単独で使用できます。LoadCartFromEAStateプロセッサの説明のシナリオも参照してください。

一部のECSシステムでは、カート ドメイン モデルで指定されたすべての情報が提供されず、メイン データがECSから読み取られ、追加のプロセッサを挿入してEA状態に格納された追加のカート データで拡張されるハイブリッド構成が使用される場合があります。

LoadCartFromEAStateと組み合わせて使用する場合は、カートが既にEA状態から読み込まれている場合でも、ECSに確認し、そこからカートを読み込み、最新バージョンが使用されていることを確認することが重要です。

カートが外部のコマースシステムで見つかった場合は、パイプラインのResponse argプロパティに既に保存されているカートを上書きまたはマージできます。これは、ECSを使用したConnectプロバイダーの実装次第です。

Ownership: プロセッサはECSによって提供されます。

Customization: ECS専用に構築する必要があります。

SaveCartパイプライン

名前：

セーブカート

形容：

カートを外部コマースシステムとEngagement Automation状態の両方に保存します。

使い：

他のサービス・レイヤー・メソッドから呼び出されますが、明示的に呼び出されることはめったにありません。

引数:

依頼- 取得するカートを決定する基準が含まれています。は、パイプラインを呼び出す前に設定されます。

応答- パイプラインが呼び出された後のカート オブジェクトが含まれます。

プロセッサ：

セーブカート –

Responsibility:

指定されたカートをECSに保存します。

Usage: このプロセッサは、カートをECSに保存するための専用プロセッサです。

既存のカートを再開する機能は、EA状態に格納されているカートにも依存するため、プロセッサをSaveCartパイプラインで単独で使用しないでください。FindCartInEAStateプロセッサは、ECSからLoadCartをカートにロードするためのCartIdを取得するために、EA状態のカートを検索します。

一部のECSシステムでは、カート ドメイン モデルで指定されたすべての情報が提供されず、メイン データがECSに保存され、追加のカート データがEA状態に格納されるハイブリッド構成が使用される場合があります。

一部のECS実装では、SaveCartパイプラインがECSシステムにConnectからカートを提供する最初で唯一の場所です。

ECSはカートのプライマリ リポジトリであるため、一意のCartIDキーはECSによって提供されると想定されます。

Ownership: プロセッサはECSによって提供されます。

Customization: ECS専用に構築する必要があります。

SaveCartToEAState –

Responsibility :

カートをEA状態に保存します。

使用法:必須です。プロセッサは、カートをEA状態に保存するための汎用です。

ECSでカートの永続性が利用できない場合、またはカートの処理がSitecoreのみで行われる場合は、プロセッサをLoadCart パイプラインで単独で使用できます。

既存のカートを再開する機能は、EA状態に格納されているカートにも依存するため、プロセッサはSaveCartパイプラインで使用する必要があります。FindCartInEAStateプロセッサは、ECSからLoadCartパイプラインでカートをロードするためのCartIdを取得するために、EA状態のカートを検索します。

一部のECSシステムでは、カート ドメイン モデルで指定されたすべての情報が提供されず、メイン データがECSから読み取られ、追加のプロセッサを挿入してEA状態に格納された追加のカート データで拡張されるハイブリッド構成が使用される場合があります。

放棄されたカートはECSから購入しても、SitecoreではEA状態のままである場合があります。この場合、パイプラインに両方のプロセッサを含めるのが理にかなっている場合があります。その後、Sitecoreはカートのバックアップ ストレージとして機能します。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

AddCartLinesパイプライン

名前：

AddCartLines (カートラインを追加)

形容：

このパイプラインは、ショッピング カートに新しい行を追加し、対応するページ イベントをDMSに記録する役割を担います。これは、商品がカートに追加されたときに発生します。

使い：

Sitecoreから呼び出されます。

引数:

依頼- 更新するカートと、カートに追加する行が含まれます。

パイプラインを呼び出す前に設定されます。

応答- パイプラインが呼び出された後に更新されたカート オブジェクトが含まれます。

プロセッサ：

チェック・イフ・ロック –

Responsibility: カートがロックされているかどうかを確認し、ロックされている場合はパイプラインを中止し、ロックされた状態を通知するためにSystemMessagesを返します。

Usage：随意。プロセッサは、カートがロックされているかどうかを確認するための汎用です。プロセッサは、カートの内容を変更する可能性のあるすべてのパイプラインで使用する必要があります。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

AddLinesToCart –

責任: 指定された行を提供されたカートに追加します。

このメソッドを呼び出すと、同じ製品を含むカートにすでに行が存在する場合でも、指定された行がカート内の既存の行のコレクションに常に追加されます。または、数量を単純に調整する必要がある製品にラインがすでに存在する場合は、UpdateLinesOnCartメソッドを呼び出すこともできます。

Usage：随意。このプロセッサは、カートに行を追加するための汎用的なものですが、ECS固有の実装に置き換える必要がある可能性があります。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの実装は、Sitecoreのカート ドメイン モデルでのみ動作します。

ほとんどのECS統合では、この実装を継承して上書きするか、置き換えてECSを呼び出すことが適切であり、カートへの変更が渡され、任意のビジネス ロジックを適用できます。

RunSaveCart -

Responsibility: SaveCartパイプラインを呼び出し、指定したカートを保存します。

Usage: オプションですが、カートに変更が加えられた場合 (この場合) は必ず呼び出す必要があります。このプロセッサは、SaveCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

TriggerPageEventsForCartLines –

Responsibility: カートに明細行を追加するときに、指定したページイベントをトリガーし、次の値を登録します。

  • 製品ID、数量、価格、通貨

トリガーされるイベントは、ページイベントテキストと同様にパラメータとして渡されます。

この場合、イベントは「カートに追加された行」です。ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。このプロセッサは、カートの品目を変更するときにページイベントをトリガーするための汎用です。

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを上書きして、カートから他の値を登録したり、テキストの書式を変更したりします。

TriggerAddToCartStockStatusPageイベント –

Responsibility:ページイベントAddToCartStockStatusをトリガーし、ShopName、Cart ID、Product ID、Stock Status、Pre-orderable、In-Stock Date、およびShipping Dateをトリガーします。これは、在庫ステータスがInStockでない場合のみです

Usage：必須。

Ownership:プロセッサにはConnectが付属しています。

Customization: 不要です。

UpdateVisitorInAutomationPlan –

Responsibility: 現在の連絡先をAbandonedCartキャンペーンプロセッサに登録します。

Usage: 随意。Commerce Marketing Automationキャンペーンで使用されます。

Ownership: プロセッサにはConnectが付属しています。

Customization: 次のパラメーターを使用して、現在の連絡先をAbandoned Cartマーケティングオートメーションキャンペーンに登録します。

  • basePlanNameはキャンペーンプラン名です。デフォルト値はAbandoned Cartです。

  • allowDuplicateContactsマーケティングオートメーションキャンペーンに同じコンタクトを複数回登録することを許可するかどうかを示します。デフォルト値はfalseです。

  • allowUnauthenticatedContacts匿名ユーザーおよび未登録ユーザーの登録を許可するかどうかを示します。デフォルト値はtrueです。

さらにカスタマイズするために、プロセッサを継承できます。

RemoveCartLinesパイプライン

名前：

リムーブカートライン

形容：

カートからカートのラインを削除する責任があります。

使い：

Sitecoreから呼び出されます。

引数:

依頼- 更新するカートと、削除するカートの明細行が含まれます。

パイプラインを呼び出す前に設定されます。

応答- パイプラインが呼び出された後に更新されたカート オブジェクトが含まれます。

プロセッサ：

チェック・イフ・ロック –

Responsibility: カートがロックされているかどうかを確認し、ロックされている場合はパイプラインを中止し、ロック状態を通知するSystemMessageを返します

Usage：随意。プロセッサは、カートがロックされているかどうかを確認するための汎用です。プロセッサは、カートの内容を変更する可能性のあるすべてのパイプラインで使用する必要があります。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

RemoveLinesFromCart –

Responsibility: 指定された行を指定されたカートから削除します。

削除する行の一覧は、カートのCartLinesコレクション内の行を直接参照する必要があります。これらは参照によって削除されます。 cart.CartLines = cart.CartLines.Except(request.CartLines).ToList();

Usage：随意。このプロセッサは、カートから行を削除するための汎用的なものですが、ECS固有の実装に置き換える必要がある可能性があります。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの実装は、Sitecoreのカート ドメイン モデルでのみ動作します。

ほとんどのECS統合では、この実装を継承して上書きするか、置き換えてECSを呼び出すことが適切であり、カートへの変更が渡され、任意のビジネス ロジックを適用できます。

セーブカート –

Responsibility: SaveCart パイプラインを呼び出し、指定したカートを保存します。

Usage: オプションですが、カートに変更が加えられた場合 (この場合) は常に呼び出す必要があります。このプロセッサは、SaveCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

TriggerPageEventsForCartLines –

Responsibility: カートに明細行を追加するときに、指定したページイベントをトリガーし、次の値を登録します。

  • 製品ID、数量、価格、通貨

トリガーされるイベントは、ページイベントテキストと同様にパラメータとして渡されます。この場合、イベントは カートから削除された行 です。ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。このプロセッサは、カートの品目を変更するときにページイベントをトリガーするための汎用です。

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを上書きして、カートから他の値を登録したり、テキストの書式を変更したりします。

UpdateVisitorInAutomationPlan -

Responsibility: 現在の連絡先をAbandonedCartキャンペーンプロセッサに登録します。

Usage:随意。Commerce Marketing Automationキャンペーンにコンタクトを登録するために使用されます。

Ownership: プロセッサにはConnectが付属しています。

Customization:次のパラメーターに基づいて、Commerceマーケティング オートメーション キャンペーンに連絡先を登録します。

  • basePlanNameはキャンペーンプラン名です。デフォルト値はAbandoned Cartです。

  • allowDuplicateContactsマーケティングオートメーションキャンペーンに同じコンタクトを複数回登録することを許可するかどうかを示します。デフォルト値はfalseです。

  • allowUnauthenticatedContacts匿名ユーザーおよび未登録ユーザーの登録を許可するかどうかを示します。デフォルト値はtrueです。

UpdateCartLinesパイプライン

名前：

UpdateCartLines (アップデートカートライン)

形容：

カートのラインを更新する責任があります。

使い：

Sitecoreから呼び出されます。

引数:

依頼- カートと更新するカートの明細行が含まれます。

パイプラインを呼び出す前に設定されます。

応答- パイプラインが呼び出された後に更新されたカート オブジェクトが含まれます。

プロセッサ：

チェック・イフ・ロック –

Responsibility: カートがロックされているかどうかを確認し、ロックされている場合はパイプラインを中止し、ロックされた状態を通知するためにSystemMessagesを返します。

Usage：随意。このプロセッサは、カートがロックされているかどうかを確認するための汎用プロセッサです。プロセッサは、カートの内容を変更する可能性のあるすべてのパイプラインで使用する必要があります。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

UpdateLinesOnCart –

Responsibility:提供されたカートの指定された行を更新します。

デフォルトの実装では、元のカートの明細は処理されず、渡され、カート明細がすでに更新されているカートを単に返します。

したがって、更新された行の一覧は、カートのCartLinesコレクションへの参照である必要があります。

Usage：随意。プロセッサは、カートの行を更新するための汎用的ですが、ECS固有の実装に置き換える必要がある可能性があります。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの実装は、Sitecoreのカート ドメイン モデルでのみ動作します。

ほとんどのECS統合では、この実装を継承して上書きまたは置き換え、ECSを呼び出すことが重要であり、これによりカートへの変更が渡され、任意のビジネスロジックを適用できるようになります。

セーブカート –

Responsibility: SaveCartパイプラインを呼び出し、指定したカートを保存します。

Usage: オプションですが、カートに変更が加えられた場合 (この場合) は必ず呼び出す必要があります。このプロセッサは、SaveCartパイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

TriggerPageEventsForCartLines –

Responsibility: カートに明細行を追加するときに、指定したページ イベントをトリガーし、次の値を登録します。

  • 製品ID、数量、価格、通貨

トリガーされるイベントは、ページイベントテキストと同様にパラメータとして渡されます。この場合、イベントは カートで更新された行 です。ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。このプロセッサは、カートの品目を変更するときにページイベントをトリガーするための汎用です。

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを上書きして、カートから他の値を登録したり、テキストの書式を変更したりします。

UpdateVisitorInAutomationPlan –

Responsibility: 現在の連絡先をAbandonedCartキャンペーンプロセッサに登録します。

Usage: 随意。Commerce Marketing Automationキャンペーンに登録されているユーザーを決定するために使用されます。

Ownership: プロセッサにはConnectが付属しています。

Customization: 次のパラメーターに基づいて、コマース マーケティング オートメーション キャンペーンに登録するユーザーを決定します。

  • basePlanNameはキャンペーンプラン名です。デフォルト値はAbandoned Cartです。

  • allowDuplicateContactsマーケティングオートメーションキャンペーンに同じコンタクトを複数回登録することを許可するかどうかを示します。デフォルト値はfalseです。

  • allowUnauthenticatedContacts匿名ユーザーおよび未登録ユーザーの登録を許可するかどうかを示します。デフォルト値はtrueです。

さらにカスタマイズするために、プロセッサを継承できます。

DeleteCartパイプライン

名前：

デリートカート

形容：

カートを完全に削除する責任があります。

  • カートが削除されます。

  • カートが削除されたことを示すイベントをDMSでトリガーします。

使い：

Sitecoreから呼び出されます。

引数:

依頼- 削除するカートが入っています。

パイプラインを呼び出す前に設定されます。

応答– システムメッセージ

プロセッサ：

チェック・イフ・ロック –

Responsibility: カートがロックされているかどうかを確認し、ロックされている場合はパイプラインを中止し、ロック状態を通知するためにSystemMessagesを返します

Usage：随意。プロセッサは、カートがロックされているかどうかを確認するための汎用です。プロセッサは、カートの内容を変更する可能性のあるすべてのパイプラインで使用する必要があります。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

デリートカート –

Responsibility: カートを削除し、ECSのストレージから削除します。

Usage：必須。

Ownership: プロセッサはECSによって提供されます。

Customization: ECS専用に構築する必要があります。

DeleteCartFromEAState –

Responsibility: EAの状態からカートを見つけて削除します。

Usage：随意。プロセッサは、EA状態のカートを削除するための汎用です。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

TriggerPageEventForRequestCart –

Responsibility: カートを削除するときに指定したページイベントをトリガーし、次の値を登録します。

  • ExternalCartId、UserId、CartName、CartStatus

トリガーされるイベントは、ページイベントテキストと同様にパラメータとして渡されます。この場合、イベントはCart Deletedです。ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。プロセッサは、CartRequest パラメータの型に基づいて引数を取るプロセッサのページ イベントをトリガーするための汎用プロセッサです。

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを上書きして、カートから他の値を登録したり、テキストの書式を変更したりします。

UpdateCartパイプライン

名前：

アップデートカート

形容：

責任は、更新されたカートを外部のコマースシステムに渡すことです

カートが更新されていることを通知するイベントをDMSでトリガーします。

使い：

Sitecoreから呼び出されます。

引数:

依頼- カートと、カートベースで更新するデータが含まれます。

パイプラインを呼び出す前に設定されます。

応答- パイプラインが呼び出された後に更新されたカート オブジェクトが含まれます。

プロセッサ：

チェック・イフ・ロック –

Responsibility: カートがロックされているかどうかを確認し、ロックされている場合はパイプラインを中止し、ロック状態を通知するためにSystemMessagesを返します。

Usage: 随意。プロセッサは、カートがロックされているかどうかを確認するための汎用です。プロセッサは、カートの内容を変更する可能性のあるすべてのパイプラインで使用する必要があります。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

SetAnonymousPreferredEmail -

Responsibility: 請求ページから匿名ユーザーのメールアドレスを取得し、優先メールとして設定します。

Usage: Commerceマーケティングオートメーションキャンペーンで、匿名ユーザーのメールアドレスを取得するために使用されます。 UpdateVisitorinAutomationPlanプロセッサと連携して動作します。

Ownership: プロセッサにはConnectが付属しています。

Customization:

アップデートカート –

Responsibility: カート本体の更新された値でカートを更新するには (CartBaseオブジェクトのみ、行などは更新しない)。

デフォルトの実装では、CustomerIDを除くCartBaseのすべてのデフォルト プロパティが更新されます。CartName、およびShopName。null値とblack値を含むすべてが含まれます。

Usage：随意。プロセッサは、カート本体を更新するための汎用プロセッサです。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトのConnectドメインモデルがカスタマイズされている場合は、カスタマイズされたプロパティを含めるようにプロセッサを上書きする必要があります。

TriggerPageEventForRequestCartChanges–

Responsibility: カートを削除するときに指定したページイベントをトリガーし、次の値を登録します。

  • CustomerId、カート名、ショップ名

トリガーされるイベントは、ページイベントテキストと同様にパラメータとして渡されます。この場合、イベントはCart Deletedです。ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。プロセッサは、UpdateCartRequest パラメータの型に基づいて引数を取るプロセッサのページ イベントをトリガーするための汎用プロセッサです。

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを上書きして、カートから他の値を登録したり、テキストの書式を変更したりします。

RunSaveCart –

Responsibility: SaveCart パイプラインを呼び出し、指定したカートを保存します。

Usage: オプションですが、カートに変更が加えられた場合 (この場合) は必ず呼び出す必要があります。このプロセッサは、SaveCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

UpdateVisitorInAutomationPlan –

Responsibility: 現在の連絡先をAbandonedCartキャンペーンプロセッサに登録します。

Usage: 随意。Commerce Marketing Automationキャンペーンに登録されているユーザーを決定するために使用されます。

Ownership: プロセッサにはConnectが付属しています。

Customization: 次のパラメーターに基づいて、コマース マーケティング オートメーション キャンペーンに登録するユーザーを決定します。

  • basePlanNameはキャンペーンプラン名です。デフォルト値はAbandoned Cartです。

  • allowDuplicateContactsマーケティングオートメーションキャンペーンに同じコンタクトを複数回登録することを許可するかどうかを示します。デフォルト値はfalseです。

  • allowUnauthenticatedContacts匿名ユーザーおよび未登録ユーザーの登録を許可するかどうかを示します。デフォルト値はtrueです。

さらにカスタマイズするために、プロセッサを継承できます。

LockCartパイプライン

名前：

ロックカート

形容：

カートをロック状態に設定し、変更を防止します。

使い：

Sitecoreから呼び出されます。

引数:

依頼- ロックするカートが入っています。

パイプラインを呼び出す前に設定されます。

応答- パイプラインが呼び出された後のカート オブジェクトが含まれます。

プロセッサ：

ロックカート –

Responsibility: カートをロック状態 (IsLocked = true) に設定します。

Usage：随意。プロセッサは、カートをロックするための汎用です。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの実装では、ECSは呼び出されません。ロック時にECSを呼び出すために、実装を上書きまたは置き換えることが適切である場合があります。

RunSaveCart –

責任: SaveCart パイプラインを呼び出し、指定したカートを保存します。

Usage: オプションですが、カートに変更が加えられた場合 (この場合) は必ず呼び出す必要があります。このプロセッサは、SaveCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

TriggerPageEventForRequestCart –

Responsibility: カートを削除するときに指定したページイベントをトリガーし、次の値を登録します。

  • ExternalCartId、UserId、CartName、CartStatus

トリガーされるイベントは、ページイベントテキストと同様にパラメータとして渡されます。この場合、イベントはCartLockedです。ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。プロセッサは、CartRequest パラメータの型に基づいて引数を取るプロセッサのページ イベントをトリガーするための汎用プロセッサです。

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを上書きして、カートから他の値を登録したり、テキストの書式を変更したりします。

UnlockCartパイプライン

名前：

アンロックカート

形容：

カートをロック解除状態に設定します。

使い：

Sitecoreから呼び出されます。

引数:

依頼- ロックを解除するカートが含まれています。

パイプラインを呼び出す前に設定されます。

応答- パイプラインが呼び出された後のカート オブジェクトが含まれます。

プロセッサ：

アンロックカート –

Responsibility: カートをロックされていない状態 (IsLocked = false) に設定します。

Usage：随意。プロセッサは、カートのロックを解除するための汎用です。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの実装では、ECSは呼び出されません。アンロック時にECSを呼び出すために、実装を上書きまたは置き換えることが適切である場合があります。

RunSaveCart –

Responsibility: SaveCart パイプラインを呼び出し、指定したカートを保存します。

Usage: オプションですが、カートに変更が加えられた場合 (この場合) は必ず呼び出す必要があります。このプロセッサは、SaveCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

TriggerPageEventForRequestCart –

Responsibility: カートを削除するときに指定したページイベントをトリガーし、次の値を登録します。

  • ExternalCartId、UserId、CartName、CartStatus

トリガーされるイベントは、ページイベントテキストと同様にパラメータとして渡されます。この場合、イベントは「カートロック解除」です。ページ イベントのテキストは、Sitecoreディクショナリで検索することでローカライズされます。

Usage：随意。プロセッサは、CartRequest パラメータの型に基づいて引数を取るプロセッサのページ イベントをトリガーするための汎用プロセッサです。

Ownership:プロセッサにはConnectが付属しています。

Customization: プロセッサを上書きして、カートから他の値を登録したり、テキストの書式を変更したりします。

MergeCartパイプライン

名前：

マージカート

形容：

ユーザーカートと匿名カートを統合します。

使い：

Sitecoreから呼び出されます。

引数:

依頼- ユーザーカートと匿名カートが含まれています。

応答- マージされたユーザーカートが含まれています。

プロセッサ：

マージカート –

Responsibility: ユーザーカートと匿名カートを統合します。

Usage：随意。このプロセッサは、カートのマージに汎用的です。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの実装では、ECSは呼び出されません。カスタム・マージ・ルールが必要な場合は、実装を上書きまたは置換することが適切です。

RunSaveCart –

Responsibility: SaveCartパイプラインを呼び出し、指定したカートを保存します。

Usage: オプションですが、カートに変更が加えられた場合 (この場合) は必ず呼び出す必要があります。このプロセッサは、SaveCart パイプラインを呼び出すための汎用であり、他のパイプラインで使用できます。

Ownership:プロセッサにはConnectが付属しています。

Customization: デフォルトの機能をすぐに上書きする必要はありません。

この記事を改善するための提案がある場合は、 お知らせください!