OrderCloudとの統合

属性テンプレートを選択する

検索ドメインを設定するには、属性テンプレートを選択し、OrderCloud同期ターゲットのソースを定義します。APIプッシュコネクターを使って、OrderCloudがSitecore Searchにインクリメンタルアップデートを送信できるようにします。

属性テンプレートを選択するには:

1. Sitecore Searchでは、メインメニューでAdministration > Domain Settingsをクリックします。

2. General Settingsタブで「エンティティ」>編集をクリックします。

   !注General Settingsタブにエンティティが表示されない場合は、ドメインが複数のエンティティに対して有効になっていません。

3. 同期したいエンティティ、例えばProductをClickします。

4. Attribute Templateのドロップダウンメニューで、OrderCloudのデータモデルに一致する属性をマッピングするテンプレートを選択してください。

   • 製品エンティティについては、 OrderCloud製品テンプレートv3 テンプレートを選択してください。
   • その他のエンティティについては、 Base Attribute Templateを選択します。

5. OrderCloudの拡張プロパティを使ってビジネス固有のプロパティをOrderCloudデータモデルに追加する場合は、それらをSitecore Searchの属性として追加してください。

6. API Push型のソースを作成しましょう。

7. Click Save。

(任意)プロパティOrderCloud XP新しい属性を定義する

同期されたOrderCloudエンティティのAPI応答でXPプロパティ を返したり、フィルタリング、ファネスティング、ルール、追加の検索体験に使いたい場合は、Sitecore SearchでそれらのXPプロパティを属性として設定する必要があります。

XPプロパティの新しい属性を設定するには:

1. メニューバーでAdministration > Domain Settings > Attributesをクリックします。

2. エンティティのドロップダウンメニューで**「製品**」を選択します。

3. Click Add Attributeを使い、属性名を小文字で入力し、下線でネストを表現します。

   例えば、OrderCloudのxp.Brandという属性は、Sitecore Searchでxp_brandと名付けられなければなりません。

4. Sitecore Searchで製品のサムネイルを表示するには、OrderCloudに「 xp.ThumbnailImageUrl」というXPプロパティを作成します。

OrderCloudの配信設定を作成する

属性テンプレートを選択しソースを作成してドメインを設定したら、次にOrderCloudの配信設定を作成しなければなりません。

配信構成を作成するには:

1. OrderCloudにログインして「 APIコンソール」をクリックしてください。

2. メインメニューの 統合 セクションで「 Delivery Configurations」をクリックしてください。

3. 上部のドロップダウンメニューで、POST操作を選択して新しい配達構成を作成します。

4. 有効化 のチェックボックス を選択してください。

5. Search Ingestionセクションで、以下の項目を入力してください:

   • ドメイン - あなたのSearchドメインのID。

   • ソース - あなたのSearch source ID。

   • エンドポイント - あなたのSearchソースエンドポイントURL。

   • エンティティ - 商品を入力してください。

   • API Key - あなたのSearch Source APIキー。

   !注

   • ドメインIDを見つけるには、メニューバーでHomeをクリックし、ドメイン名にカーソルを合わせてください。

   • ソースID、エンドポイントURL、APIキーを見つけるには、メニューバーで 「Sources」をクリックし、その後ソースをクリックしてください。 Source Settingsページで「 Source Information」をクリックします。

6. Click Send。

7. メインメニューの統合セクションで**「**Product Synchronization」をクリックします。

8. 上部のドロップダウンメニューで、商品同期を作成または更新するためのPUT操作を選択してください。

9. Request Bodyで、商品を作成または更新した際に同期する「Sync Product Changed」チェックボックスを選択し、削除された際に同期する「Sync Product Deleted」チェックボックスを選択してください。

10. Delivery Config IDでIDを入力し、「Send」をクリックします。

このプロセスを他のSitecore Search事業体( カテゴリ、店舗/サプライヤー、在庫など)にも繰り返します。エンティティ 同期 エンドポイントを使ってそれぞれ作成します。

プロダクト同期をトリガーしてください

OrderCloudで接続を設定したら、OrderCloudからSitecore Searchへの同期をトリガーする準備ができます。

!注カタログやカテゴリーのフル同期を行う前に、セットアップが正しいかを確認するために、単一の製品に対してインクリメンタル同期を行うことをお勧めします。 PATCHクエリを実行して新しい値で商品を更新し、その後インクリメンタル同期を実行することでこれを実現できます。

同期をトリガーするには:

1. OrderCloudで「 セルフサービス 」> 「同期ツール」をクリックします。

   !注OrderCloud Portalを使っているなら、マーケットプレイス > 商品同期に行ってください。

2. カタログ全体を同期するには、Catalog IDフィールドでIDを入力してください。

   または、1つのカテゴリのみを同期するには、カタログIDフィールドにIDを入力し、カテゴリIDフィールドでIDを入力してください。

3. 「 私はロボットじゃない 」チェックボックスを選びます。

4. Click Submit。

5. Sitecore SearchではメインメニューでContent Collectionをクリックします。

6. Click同期エンティティをProduct。そのページにはOrderCloudの製品が掲載されています。

   !注「 商品変更を同期 」や「 商品を削除した 同期」オプションを選択した場合、OrderCloudで商品が作成されたり変更されたり削除されたりすると、その変更はSearchに同期されます。

Sitecore Searchでは、Sourcesを押すと、インデックス待ちのソースの横に感嘆符が表示されます。インデックス作成は、ソースのサイズによっては完了までに時間がかかる場合があります。

また、Analytics > Sources > Overviewにアクセスして、さまざまな指標に関するすべての情報源の詳細情報を確認できます。特定の情報源の詳細を見るには、情報源リストから選択してください。これにより、ソース、直近の実行の概要、実行されたジョブ数の情報が得られます。特定のジョブの詳細を見るには、グラフまたは ジョブ実行リストから選択してください。

(任意)Searchプロキシを設定する

Sitecore Searchプロキシを使えば、OrderCloudから正確な商品の可視性と価格情報を得ることができます。また、Searchで必要な別のシステムに保存されたマルチロケーション属性や非OrderCloud属性を同期することも可能です。これは任意のステップです。OrderCloudからデータを同期するのにプロキシは必要ありません。複雑なマーケットプレイスで複数の価格が存在している場合や、商品の可視性が限られている場合のみ使用してください。

プロキシの設定方法:

1. OrderCloudでは、右上のドロップダウンメニューでMarketplace名を入力し、 OrderCloud地域 と Marketplace ID をメモしてください。
2. Searchのメニューバーで「 Sources」をクリックし、その後ソースをクリックしてください。 ソースSettings ページで「 ソース情報 」をクリックし、 SearchインジェスションAPI URL をメモしてください。
3. この情報をもとにサポートケースに登録してください。