注文サービスレイヤー

注文サービス方法

Version:

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

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

サービスプロバイダーは、Connectパイプラインとの対話を容易にするために設計されたラッパーオブジェクトです。プロバイダーは、Connectパイプラインを呼び出す以外のロジックを実装しません。すべてのビジネスロジックは、パイプラインプロセッサに実装されます。

Orderサービスプロバイダーには、注文データを操作するための次のメソッドが含まれています。

SubmitVisitorOrderメソッド

名前：	SubmitVisitorOrder (ビジター注文の提出)
形容：	ショッピングカートに基づいて注文を作成します。 SubmitVisitorOrderパイプラインを呼び出します。
使い：	訪問者が注文を作成するためにショッピングカートを送信しているときにSitecoreから呼び出されます。
署名：	`SubmitVisitorOrderResult SubmitVisitorOrder(SubmitVisitorOrderRequest request)`
インプット：
	カート - カート。ショッピングカートのインスタンス。
アウトプット：
	Order –カート。成功すると、注文が返され、注文はカートから継承されるため、これは正常に機能しますが、注文としてキャストする必要があります。失敗した場合は、cartオブジェクトのインスタンスが返され、変更され、より多くのデータとエラーコメントが追加される可能性があります。
	SystemMessages - 外部システムからのメッセージのコレクション。

使用例:

var cartService = new CartServiceProvider();
// get the cart
var cart = cartService.CreateOrResumeCart(new CreateOrResumeCartRequest("MyShop", "Me")).Cart;
// add parties, payment and shipping info
cart.Parties = new List<Party> 
{ 
    new Party() { ExternalId = "1", PartyId = "{F73904C0-2A45-4A2F-A99B-F934ABDCFC99}", FirstName = "Joe", LastName = "Smith", Address1 = "123 Street", City = "Ottawa", State = "Ontario", Country = "Canada" },
    new Party() { ExternalId = "2", PartyId = "{294B7DD1-7397-4322-996C-E87E592EF621}", FirstName = "Jane", LastName = "Smith", Address1 = "234 Street", City = "Toronto", State = "Ontario", Country = "Canada" } 
};
cart.BuyerCustomerParty = new CartParty() { ExternalId = "1", PartyID = "{F73904C0-2A45-4A2F-A99B-F934ABDCFC99}" };
cart.AccountingCustomerParty = new CartParty() { ExternalId = "2", PartyID = "{294B7DD1-7397-4322-996C-E87E592EF621}" };
cart.Payment = new List<PaymentInfo>
{
    new PaymentInfo() { ExternalId = "1" },
    new PaymentInfo() { ExternalId = "2" },
};
cart.Shipping = new List<ShippingInfo>
{
    new ShippingInfo() { ExternalId = "1" },
    new ShippingInfo() { ExternalId = "2" },
};
cartService.SaveCart(new SaveCartRequest(cart));
var orderService = new OrderServiceProvider();
var request = new SubmitVisitorOrderRequest(cart);
var result = orderService.SubmitVisitorOrder(request);
var order = result.Order;
var orderId = order.OrderID;

GetAvailableCountriesメソッド

このメソッドは、ECSがサポートする国の一覧を返します。

名前：	GetAvailableCountries(利用可能な国)
形容：	ECSがサポートするすべての国の一覧を提供します。
使い：	Sitecoreから呼び出された場合
署名：	`GetAvailableCountriesResult GetAvailableCountries( GetAvailableCountriesRequest request)`
インプット：
アウトプット：
	システムメッセージ - 外部システムからの国のコレクション。

使用例:

var orderService = new OrderServiceProvider();
var request = new GetAvailableCountriesRequest();
var result = orderService.GetAvailableCountries(request);

GetAvailableRegionsメソッド

ECSでサポートされている国の地域の一覧を返します。

名前：	GetAvailableRegions
形容：	ECSでサポートされている国のすべての地域の一覧を提供します。
使い：	Sitecoreから呼び出された場合
署名：	`GetAvailableRegionsResult GetAvailableRegions( GetAvailableRegionsRequest request)`
インプット：
	国コード – リージョンを返す国。
アウトプット：
	システムメッセージ - 外部システムからの国のコレクション。

使用例:

var orderService = new OrderServiceProvider();
var request = new GetAvailableRegionsRequest(“Canada”);
var result = orderService.GetAvailableRegions(request);

GetVisitorOrderメソッド

名前：	GetVisitorOrder (ビジターオーダー)
形容：	訪問者が発行したIDで注文を取得します。 GetVisitorOrderパイプラインを呼び出します。
使い：	特定の注文に注文の詳細が必要な場合にSitecoreから呼び出されます。
署名：	`GetVisitorOrderResult GetVisitorOrder(GetVisitorOrderRequest request)`
インプット：
	ショップ名 – ショップの名前。
	オーダーID – 注文のID。
	CustomerID – 必須顧客/訪問者/連絡先のID。顧客IDが提供されない場合、すべての訪問者がすべての顧客の注文にアクセスできるという潜在的なセキュリティリスクがあります。
アウトプット：
	Order – 注文オブジェクトのインスタンスが返されます。注文オブジェクトは、外部のコマースシステムによって作成されます。
	SystemMessages - 外部システムからのメッセージのコレクション。

使用例:

var orderService = new OrderServiceProvider();
// need a valid order id for the first param
var visitorOrderRequest = new GetVisitorOrderRequest("Order_7777", "Me", "MyShop");
var result = orderService.GetVisitorOrder(visitorOrderRequest);

GetVisitorOrdersメソッド

名前：	GetVisitorOrders(ビジターオーダーズ)
形容：	指定された訪問者が行った注文の注文概要データを取得します。 GetVisitorOrdersパイプラインを呼び出します。
使い：	訪問者の注文履歴が必要な場合にSitecoreから呼び出されます。
署名：	`GetVisitorOrdersResult GetVisitorOrders(GetVisitorOrdersRequest request)`
インプット：
	ショップネーム - ショップの名前。
	カスタマーID – 購入者の顧客パーティのID。
アウトプット：
	IReadOnlyCollection<OrderBase> – 注文オブジェクトのインスタンスが返されます。注文オブジェクトは、外部のコマースシステムによって作成されます。
	システムメッセージ - 外部システムからのメッセージの収集。

使用例:

var orderService = new OrderServiceProvider();
var visitorOrdersRequest = new GetVisitorOrdersRequest("Me", "MyShop");
var result = orderService.GetVisitorOrders(visitorOrdersRequest);

OrderStatusChangedメソッド

名前：	OrderStatusChanged(注文ステータス変更)
形容：	注文のステータスに変更が加えられたことをSitecoreに通知するために使用されます。
使い：	Sitecoreから呼び出され、注文のステータスの変更についてSitecoreに通知します。
署名：	`OrderStatusChangedResult OrderStatusChanged(OrderStatusChangedRequest request)`
インプット：	OrderId - ステータスが変更された注文のID。
	CustomerId - 注文に関連付けられている顧客のID。
	オーダーステータス – オーダーの新しいステータス。
アウトプット：

使用例:

var orderService = new OrderServiceProvider();
var visitorOrdersRequest = new GetVisitorOrdersRequest("Me", "MyShop");
var result = orderService.GetVisitorOrders(visitorOrdersRequest);

並べ替え方法

名前：	並べ替える
形容：	以前に注文した1つ以上の商品を、お客様の現在のカートに追加します。これにより、reorderパイプラインが呼び出されます。
使い：	顧客が以前に発注した注文から1つ以上のアイテムを再注文したい場合に呼び出されます。
署名：	`CartResultReorder(ReorderRequest request)`
インプット：
	ショップ名 – ショップの名前。
	OrderId – 必須注文のID。
	CustomerID – 必須顧客/訪問者/連絡先のID。顧客IDが提供されない場合、すべての訪問者がすべての顧客の注文にアクセスできるという潜在的なセキュリティリスクがあります。
	ReorderLineExternalIds – オプション再注文される注文明細行の外部ID。指定しない場合、注文のすべてのアイテムが並べ替えられます。
	ForceNewLines – オプション trueの場合、カート品目は新しいカート品目として顧客カートに追加されます。それ以外の場合、可能な場合は、明細行は既存のカート明細行にマージされます。メモこのパラメーターは、外部コマースシステムがこの機能をサポートしている場合にのみサポートされます。
アウトプット：
	カート – 返された顧客の新しいカートの内容のインスタンス。
	追加CartLineExternalIds – 顧客のカートに追加された明細行のIDを含むリスト。
	システムメッセージ - 外部システムからのメッセージの収集。

使用例:

var orderService = new OrderServiceProvider();
// need a valid order id for the second param
var reorderRequest = new ReorderRequest("Me", "Order_7777");
var result = orderService.Reorder(reorderRequest);

VisitorCancelOrderメソッド

この方法の目的は、オプションがウェブショップに存在し、ビジネスロジックによって妨げられない場合(注文がすでに履行または出荷されている場合など)に、訪問者が既存の注文をキャンセルすることです。

この方法は、通常、注文履歴ビューから起動された注文の詳細を顧客に表示し、顧客が注文をキャンセルすることを選択したときにトリガーされます。

名前：	ビジターキャンセルオーダー
形容：	訪問者が行った注文をキャンセルするために使用されます。注文が取り消されるかどうかの決定は、外部コマースシステムのビジネスロジックに委ねられます。通常、ショップの所有者が注文のフルフィルメント/処理を開始した後は、注文をキャンセルすることはできません。注文をキャンセルできない場合は、返されたSystemMessagesに反映する必要があります。
使い：	Sitecoreから呼び出されます。
署名：	`VisitorCancelOrderResult VisitorCancelOrder(VisitorCancelOrderRequest request)`
インプット：
	ショップ名 – 必須ショップの名前。
	OrderId – 必須注文のID。
	CustomerID – 必須顧客/訪問者のID。顧客IDが提供されない場合、すべての訪問者がすべての顧客の注文にアクセスできるという潜在的なセキュリティリスクがあります。
	OrderLineExternalIds – オプション取り消す注文明細行の外部IDの一覧。指定しない場合、注文のすべての明細行がキャンセルされます。手記 Connectは、デフォルトではこのパラメータをサポートしていません。このプロパティを処理するのは、外部コマースシステムコネクタの責任です。
アウトプット：
	SystemMessages - 外部システムからのメッセージのコレクション。
	キャンセルされた注文 – キャンセルされた注文が含まれます。手記この結果プロパティを設定するのは、外部コマースシステムコネクタの責任です。
	CancellationStatus – 注文キャンセル操作のステータス (つまり、Granted、Deniedなど) を示す拡張可能な列挙値。手記この結果プロパティを設定するのは、外部コマースシステムコネクタの責任です。

使用例:

var orderService = new OrderServiceProvider();
// need a valid order id for the first param
var visitorCancelOrder = new VisitorCancelOrderRequest("Order_7777", "Me", "MyShop");
var result = orderService.VisitorCancelOrder(visitorCancelOrder);

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