ウォークスルー

大規模なカタログデータセットのインポートのための最適化設定

カタログのサイズやカタログ内のデータ構造の複雑さによっては、カタログデータのインポートに時間がかかったり、場合によっては失敗することもあります。大規模で複雑なデータセットのインポートを始める前に、以下の設定変更を行うべきです:

• インターネット情報サービス(IIS)関連設定の変更
• ワークフローエンティティキャッシュポリシーの設定を変更してください
• SQLのタイムアウト設定を変更する
• Bootstrapコマースエンジン
• Sitecoreの閾値を上げてください。診断。メモリモニターフック

コンテナを使わない展開用にCommerceカタログをインポートする

!注もしCommerceのデプロイメントでコンテナを使用している場合は、この手順の指示に従ってください。

このタスクは、カタログデータを含むZIPファイル(以前にSitecore XC環境からエクスポートされたもの)を別のSitecore XC環境にインポートする方法を説明しています。この手順は、Sitecore Commerce Engine Software Development Kit(SDK)に付属したPostmanサンプルに基づいています。

!注ZIPファイルが1GBを超える場合は、そのファイルをローカルマシン(例えばCommerce Engineサービスのwwwroot\data\Catalogsフォルダ)にコピーし、PostmanのImport Local Catalogsリクエストを以下のように使用してください。

以下の手順は、Postmanアプリケーションのインストールとセットアップ、サンプルコレクション(Sitecore Commerce Engine SDKから)をPostmanにインポートし、環境を設定し、Commerce Engine APIにアクセスするためのベアラートークンを取得したことを前提としています。

カタログ製品データをインポートするには:

1. Postmanを開き、コレクションのペインでCatalogAPISamplesコレクションを展開します。

2. Catalog - APIフォルダを開きます。

   • ZIPファイルが1GB未満の場合は、Import Catalogs (with publishing) リクエストをクリックしてください。

     !注 パブリッシングでインポートすると、パブリッシングのワークフローをバイパスできます。その結果、販売可能なアイテムはインポートされ、コンテンツ配信サーバーに公開するために、ドラ フトや 承認待ちなどの様々な状態から移行する必要はありません。

     ( Postmanサンプルには、公開 せずに カタログをインポートするリクエストも含まれています。この場合、インポートされた販売可能なアイテムはドラフト状態にあり、出版ワークフローを経る必要があります。)

   • ZIPファイルが1GBを超える場合は、Import Local Catalogsリクエストをクリックしてください。

3. 環境フィールドで、データをインポートする必要がある商取引環境(例えばHabitatAuthoring環境)を指定します。

4. ヘッダー タブをクリックし 、HTTPリクエストで以下のヘッダーキーと値を指定します。

   • キー: PolicyKeys
   • 価値
     |IgnoreAddEntityToIndexList|IgnoreIndexUpdatedSitecoreItem|IgnoreLocalizeEntity

5. Bodyタブでインポートしたいファイルを指定してください。

   • Import Catalogs (with publishing)リクエストを実行する場合は、importFileキーの「ファイル選択」をクリックし、インポートするカタログデータを含むZIPファイルをクリックしてください。
   • Import Local Catalogsリクエストを実行する場合は、"importFilePath"パラメータにインポートするカタログデータを含むローカルZIPファイル名を入力してください。

   以下の表は、カタログデータインポートで設定できるパラメータを示しています:

   パラメータ

   価値

   概要

   "mode"

   "replace"

   既存のカタログをすべて削除し、新しいカタログファイルを追加してインポートします。

   注意

   置き換えモードがデフォルト値です。このモードは既存のカタログデータ(新しいカタログの名前が異なっても)をすべて削除します。既存のカタログデータを保持したい場合は、 追加 モードを使いましょう。

   "add"

   新しいカタログデータファイルを追加し、既存のカタログはすべて保持します。

   > [!注]
   > 既存のカタログがインポートするカタログファイルと同じ名前の場合、既存のカタログの内容は新しいカタログファイルの内容に置き換えられます。

   "batchSize"

   900

   バッチで処理するアイテムの数。

   >[!重要]
   > SQLタイムアウトエラーが発生した場合は、バッチサイズを小さく減らします。

   "errorThreshold"

   "10"

   インポート操作中に許容される最大エラー数を示します。この閾値に達するとインポート操作は失敗します。デフォルト値は10です。

6. カタログインポート操作を開始するには、Sendをクリックしてください。

   DevOps APIを使って、長期間実行されているインポートコマンドのステータスを確認できます。

   !注インポート操作中に情報を収集するようにログリングを設定している場合、ログレベルを元の値に戻してください(例: "Information"から"Warning"まで)。

7. インポート操作の状態を確認するには、返された応答コードを確認してください:

   • ResponseCodeが値をFailed返すと、インポート操作中に遭遇するエラー数は設定されたエラー閾値を超えます。
   • ResponseCodeが値をCompletedWithErrors返すと、インポート操作中に遭遇するエラー数は設定済みのエラー閾値内となります。
   • ResponseCodeが値を返すと、誤りなく操作が完了しますSucceeded。

8. この手順を、Sitecore Commerceのデプロイメントにインポートしたい追加のカタログ .zipファイルごとに繰り返します。

   注意

   すべてのカタログのインポートが完了し(関連するインベントリデータがインポートできない状態)後、IISマネージャーとweb.configファイルで以前変更 した設定を元の数値に戻す必要があります。

9. カタログをSitecoreの導入環境にインポートした後、Sitecoreコンテンツエディターでカタログをストア フロントサイトに関連付けるよう設定します。

engine_authoringコンテナ内のカタログデータをインポートする

!注この手順はコンテナを用いたCommerce展開にのみ適用されます。もしあなたのデプロイでコンテナ を使わない場合は 、この手順 の指示に従ってください。

このタスクは、カタログデータ(以前にSitecore XC環境からエクスポートされたもの)を含むZIPファイルをengine_authoringコンテナにインポートする方法を説明しています。この手順は、Sitecore Commerce Engine Software Development Kit(SDK)に付属したPostmanサンプルのImport Local Catalogs APIリクエストに基づいています。

以下の手順は、Postmanアプリケーションのインストールとセットアップ、サンプルコレクション(Sitecore Commerce Engine SDKから)をPostmanにインポートし、環境を設定し、Commerce Engine APIにアクセスするためのベアラートークンを取得したことを前提としています。

カタログ商品データをengine_authoringコンテナにインポートするには:

1. インポート用のカタログZIPファイルを次のフォルダに入れてください: C:\engine\catalogs\ 。

2. コレクションのパネルでCatalogAPISamplesコレクションを展開します。

3. カタログ - APIフォルダを開き、Import Local Catalogsリクエストをクリックします。

4. 環境フィールドで、データをインポートする必要がある商取引環境(例えばHabitatAuthoring環境)を指定します。

5. ヘッダー タブをクリックし 、HTTPリクエストで以下のヘッダーキーと値を指定します。

   • キー: PolicyKeys
   • 価値
     |IgnoredEntityToIndexList|IgnoreIndexUpdatedSitecoreItem|IgnoreLocalizeEntity

6. Bodyタブで、カタログデータインポートのパラメータ値を指定します:

   以下の表は、カタログデータインポートで設定できるパラメータを示しています:

   パラメータ

   価値

   概要

   "importFilePath":

   なし

   インポートするファイルへの相対パス: "..\catalogs\"

   "mode":

   "replace"

   既存のカタログをすべて削除し、新しいカタログファイルを追加してインポートします。

   注意

   置き換えモードがデフォルト値です。このモードは既存のカタログデータ(新しいカタログの名前が異なっても)をすべて削除します。既存のカタログデータを保持したい場合は、 追加 モードを使いましょう。

   "add"

   新しいカタログデータファイルを追加し、既存のカタログはすべて保持します。

   > [!注]
   > 既存のカタログがインポートするカタログファイルと同じ名前の場合、既存のカタログの内容は新しいカタログファイルの内容に置き換えられます。

   "batchSize":

   "900"

   バッチで処理する品目の数。

   >[!重要]
   > SQLタイムアウトエラーが発生した場合は、バッチサイズを小さく減らします。

   "errorThreshold":

   "10"

   インポート操作中に許容される最大エラー数を示します。この閾値に達するとインポート操作は失敗します。

   "publish":

   false

   販売可能な品目をドラフト状態か公開ステータスのどちらでインポートするかを指定します。

   false(デフォルト)に設定されている場合、販売可能なアイテムはドラフトステータスでインポートされ、承認ワークフローを経てからコンテンツ配信サーバーに公開されます。

   trueに設定されている場合、販売可能なアイテムは公開ステータスでインポートされ、承認ワークフローを経ずにコンテンツ配信サーバーに公開されます。

7. カタログインポート操作を開始するには、Sendをクリックしてください。

   DevOps APIを使って、長期間実行されているインポートコマンドのステータスを確認できます。

   !注インポート操作中に情報を収集するようにログリングを設定している場合、ログレベルを元の値に戻してください(例: "Information"から"Warning"まで)。

8. インポート操作の状態を確認するには、返された応答コードを確認してください:

   • ResponseCodeが値をFailed返すと、操作中に遭遇するエラーの数は設定されたエラー閾値を超えます。
   • ResponseCodeが値をCompletedWithErrors返すと、操作中に遭遇するエラーの数は設定されたエラー閾値内です。
   • ResponseCodeが値を返すと、誤りなく操作が完了しますSucceeded。

9. この手順を、Sitecore Commerceの導入にインポートしたい追加のカタログ .zipファイルごとに繰り返してください。

   注意

   すべてのカタログのインポートが完了し(関連するインベントリデータがインポートできない状態)後、IISマネージャーとweb.configファイルで以前変更 した設定を元の数値に戻す必要があります。

10. カタログをSitecoreの導入環境にインポートした後、Sitecoreコンテンツエディターでカタログをストア フロントサイトに関連付けるよう設定します。

製品在庫データのインポート(コンテナを使わない展開用)

!注もしCommerceのデプロイメントでコンテナを使用している場合は、この手順 の指示に従ってください。

カタログデータファイルの導入が完了したら、関連する在庫データをインポートできます。

!注ZIPファイルが1GBを超える場合は、そのファイルをローカルマシン(例えばCommerce Engineサービスのwwwroot\data\Catalogsフォルダ)にコピーし、以下の手順に従ってImport Local Catalogsリクエストを適用してください。

以下の手順は、Postmanアプリケーションのインストールとセットアップ、Sitecore Commerce Engineソフトウェア開発キット(SDK)からサンプルコレクションを取り込み、環境を設定し、Commerce Engine APIにアクセスするためのベアラートークンを取得したことを前提としています。

カタログ在庫データのインポート:

1. Sitecore Identityトークンが期限切れの場合は、新しいトークンを取得するために別のGetTokenリクエストを実行してください。

2. コレクションのパネルでInventoryAPISamplesコレクションを展開します。

3. Inventory - APIフォルダを開きます。

   • ZIPファイルが1GB未満の場合は、 Import Inventory Sets リクエストをクリックしてください。
   • ZIPファイルが1GBを超える場合は、 Import Local Inventory Sets リクエストをクリックしてください。

4. 環境フィールドで、データをインポートする必要がある商取引環境(例えばHabitatAuthoring環境)を指定します。

5. Bodyタブでインポートしたいファイルを指定してください。

   • Import Inventory Setsリクエストを実行する場合は、importFileキーの「ファイル選択」をクリックし、インポートする在庫データを含むZIPファイルをクリックしてブラウズします。
   • Import Local Inventory Setsリクエストを実行する場合は、"importFilePath"パラメータにインポートするインベントリデータを含むローカルZIPファイル名を入力してください。

6. インポート操作パラメータは必要に応じて設定します:

   パラメータ

   価値

   概要

   "importFilePath":

   ""

   例えば、インポートするためのインベントリデータファイルへの相対パス "..\catalogs\"

   "mode":

   "replace"

   既存の在庫データをすべて削除し、新しい在庫ファイルデータを追加します。

   注意

   置換モードがデフォルト値です。このモードは既存のすべてのデータを削除します(新しいデータセットの名前が異なっていても)。

   既存のデータを保持したい場合は 、追加 モードを使いましょう。

   "add"

   新しいデータファイルを追加し、既存の在庫データはすべて保持します。

   > [!注]
   > 既存のインベントリデータセットがインポートするデータセットファイルと同じ名前の場合、その既存データセットの内容は新しいデータファイルの内容に置き換えられます。

   "batchSize":

   "900"

   バッチごとに処理すべきアイテム数。

   >[!重要]
   > SQLタイムアウトエラーが発生した場合は、バッチサイズを小さく減らします。

   "errorThreshold":

   "10"

   インポート操作中に許容される最大エラー数を示します。この閾値に達するとインポート操作は失敗します。

7. インポート操作を開始するには、Sendをクリックしてください。

8. インポート操作の状態を確認するには、返された応答コードを確認してください:

   • ResponseCodeが値をFailed返すと、操作中に遭遇するエラーの数は設定されたエラー閾値を超えます。
   • ResponseCodが値をCompletedWithErrors返すと、操作中に遭遇するエラーの数は設定されたエラー閾値内です。
   • ResponseCodeが値を返すと、誤りなく操作が完了しますSucceeded。

9. この手順は、Sitecore Commerceのデプロイメントにインポートしたい追加の製品在庫ZIPファイルごとに繰り返します。

   注意

   すべてのインベントリセットのインポートが終わったら、IISマネージャーとweb.configファイルで以前に変更 した設定を元の数値に戻さなければなりません。

10. インポート操作中に情報を収集するようにログリングを設定している場合は、ログレベルを元の数値に戻してください(例えば、"Information"から "Warning"まで)。

engine_authoringコンテナに商品在庫データをインポートする

!注この手順はコンテナを用いたCommerce展開にのみ適用されます。もしあなたのデプロイでコンテナ を使用しない場合は 、この手順の指示に従ってください。

コンテナ化されたCommerce展開にカタログデータファイルのインポートが完了したら、関連する在庫データをengine_authoringコンテナにインポートできます。

以下の手順は、Postmanアプリケーションのインストールとセットアップ、Sitecore Commerce Engineソフトウェア開発キット(SDK)からサンプルコレクションを取り込み、環境を設定し、Commerce Engine APIにアクセスするためのベアラートークンを取得したことを前提としています。

製品在庫データをインポートするには:

1. インポート用の在庫データを含むZIPファイルを次のフォルダに入れてください: C:\engine\catalogs\。

2. Sitecore Identityトークンが期限切れの場合は、新しいトークンを取得するために別のGetTokenリクエストを実行してください。

3. コレクションのパネルでInventoryAPISamplesコレクションを展開します。

4. Inventory - APIフォルダを開き、Import Local Inventory Setsリクエストをクリックしてください。

5. 環境フィールドで、データをインポートする必要がある商取引環境(例えばHabitatAuthoring環境)を指定します。

6. Bodyタブで、インベントリデータのインポートパラメータ値を指定します:

   パラメータ

   価値

   概要

   "importFilePath":

   ""

   例えば、インポートするためのインベントリデータファイルへの相対パス "..\catalogs\"

   "mode":

   "replace"

   既存の在庫データをすべて削除し、新しい在庫ファイルデータを追加します。

   注意

   置換モードがデフォルト値です。このモードは既存のすべてのデータを削除します(新しいデータセットの名前が異なっていても)。

   既存のデータを保持したい場合は 、追加 モードを使いましょう。

   "add"

   新しいデータファイルを追加し、既存の在庫データはすべて保持します。

   > [!注]
   > 既存のインベントリデータセットがインポートするデータセットファイルと同じ名前の場合、その既存データセットの内容は新しいデータファイルの内容に置き換えられます。

   "batchSize":

   "900"

   バッチごとに処理すべきアイテム数。

   >[!重要]
   > SQLタイムアウトエラーが発生した場合は、バッチサイズを小さく減らします。

   "errorThreshold":

   "10"

   インポート操作中に許容される最大エラー数を示します。この閾値に達するとインポート操作は失敗します。

7. インポート操作を開始するには、Sendをクリックしてください。

8. インポート操作の状態を確認するには、返された応答コードを確認してください:

   • ResponseCodeが値をFailed返すと、操作中に遭遇するエラーの数は設定されたエラー閾値を超えます。
   • ResponseCodeが値をCompletedWithErrors返すと、操作中に遭遇するエラーの数は設定されたエラー閾値内です。
   • ResponseCodeが値を返すと、誤りなく操作が完了しますSucceeded。

9. この手順は、Sitecore Commerceのデプロイメントにインポートしたい追加の製品在庫ZIPファイルごとに繰り返します。

   注意

   すべてのインベントリセットのインポートが終わったら、IISマネージャーとweb.configファイルで以前に変更 した設定を元の数値に戻さなければなりません。

10. インポート操作中に情報を収集するようにログリングを設定している場合は、ログレベルを元の数値に戻してください(例えば、"Information"から "Warning"まで)。

インデックスコマースエンジンのカタログ項目

カタログおよびインベントリデータのインポートが完了した後、Commerce Engineのフルインデックスミニオンを手動で起動してカタログアイテムの完全なインデックス化を行う必要があります。この手順はSitecore Commerce Engine SDKに提供されているPostmanサンプルを使用します。

完全なインデックスミニオンを呼び出すには:

1. Postmanコレクション のパネルでSitecoreCommerce_DevOpsコレクションを展開します。

2. Minionsフォルダを開き、Run FullIndex Minion - Catalogs itemsリクエストをクリックします。

3. ボディパネルで環境をAuthoring Environmentに設定します(例:"environmentName":"{{AuthoringEnvironment}}")。

4. リクエストを実行するには、「 Send」をクリックしてください。

   !注カタログアイテムの完全なインデックス作成を終えた後は 、Sitecore XPインデックスを手動で再構築する必要があります。