コンテンツ項目の同期

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

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

Commerceコントロール パネル (Sitecoreコンテンツ エディター) で新しいCommerceコンテンツ アイテムを追加する場合、または既存のコンテンツ アイテムに変更を加える場合は、コンテンツ アイテム (Sitecoreコンテンツ エディターで定義) をCommerce Engineデータベースのデータと同期する必要があります。たとえば、新しいCommerce用語 (たとえば、Business Toolsユーザーに表示する新しいアイテム) を追加する場合、新しいコンテンツ アイテムを同期して、Business Toolsユーザー インターフェイスに表示できるようにする必要があります。

Sync content itemサンプルAPI要求を使用して、1つのコンテンツ項目を同期できます。新しいコンテンツ項目または変更されたコンテンツ項目が複数ある場合は、Sync content pathサンプル要求を使用してすべてのコンテンツ項目を同期する必要があります。どちらのリクエストも、Sitecore Commerce Engine SDKに含まれるPostmanサンプル コレクションで利用できます。

1つのコンテンツ項目を同期する

同期するSitecoreコンテンツ アイテムが1つある場合は、PostmanでSync content itemサンプル リクエストを使用できます。

前提 条件

PostmanでSync content itemリクエストを使用する前に、Sitecoreコンテンツ アイテムのパス (URL) が手元にあることを確認してください。PostmanでSync content item要求を呼び出すときに、この情報をパラメーター値として渡す必要があります。以下は、Sitecoreコンテンツ エディターでのCommerceコンテンツ アイテムのContent path (URL) の例を示しています。

The Item path value of a Commerce item in the Sitecore Content Editor.

Sitecoreコンテンツ エディターとCommerce Engine間でコンテンツ アイテムを同期するには:

  1. Postmanを開き、Postman CollectionsウィンドウでContentAPISamplesコレクションを展開します。

  2. Viewsフォルダを開き、Sync itemリクエストをクリックします。

  3. Bodyパネルで、viewNameパラメータとforActionパラメータの値が両方ともSynchronizeContentItemに設定されていることを確認し、Sendをクリックします。

    メモ

    Sync itemリクエストは、エンティティビューに関する情報を返します。"Version"のプロパティセクションで、"Value"をメモします(次の例を参照)。この情報は、Sync content item要求の後続のステップで入力として指定する必要があります。

    The version value property.
  4. DoActionsフォルダを開き、Sync content itemリクエストをクリックします。

  5. Bodyウィンドウで、前の手順で返された値で"Version"を更新し、同期するカスタム コマース アイテムのコンテンツ アイテム パス (URL) で "Path" プロパティ値を更新します。次に、更新する必要があるプロパティ値の例を示します。

    The "value" property for the content item version and path.
  6. Send」をクリックします。

  7. コンテンツ項目をBusiness Toolsで使用できるようにするには、Redisキャッシュをフラッシュする必要があります。C:\Program Files\Redisに移動し、redis-cli.exeを実行して 、flushall コマンドを実行します。

コントロールパネルのすべてのコンテンツ項目を同期する

Commerceコントロール パネル (Sitecoreコンテンツ エディター) に複数のカスタムCommerceアイテムが含まれている場合は、Sync content path APIサンプルを使用してすべてのCommerceコンテンツ アイテムを同期します。

手記

この操作により、すべてのコントロール パネルのコンテンツ アイテムがCommerce Engineから削除され、Sitecore Commerceコントロール パネルからCommerce Engineのコンテンツ テーブルにコンテンツ アイテムが再コピーされます。同期するコンテンツ項目の数によって、この操作の完了にかかる時間が決まります。

すべてのコンテンツ項目を同期するには:

  1. Postman Collectionsウィンドウで、ContentAPISamplesコレクションを展開します。

  2. Viewsフォルダを開き、Sync itemリクエストをクリックします。

  3. Bodyウィンドウで、"viewName" パラメーターと "forAction" パラメーターの値がSynchronizeContentPathに設定されていることを確認し、Sendをクリックします。

    手記

    Sync itemリクエストは、エンティティビューに関する情報を返します。コンテンツ項目の"Version"値は、Sync content path要求の入力としてこの情報を提供する必要があるため、メモしておいてください。

    The version value property.
  4. DoActionsフォルダを開き、Sync content pathリクエストをクリックします。

  5. Bodyペインで、version "Value" プロパティを、ステップ3で実行したSync itemリクエストへのレスポンスで返された値と同じ値で更新します

    次に、Sync content path requestで更新する必要がある"Version"プロパティの例を示します。

    The "Version" property in the Sync content path request.
  6. Send」をクリックします。

  7. Business Toolsでコンテンツ項目を使用可能にするには、Redisキャッシュをフラッシュする必要があります (Redisでflushall コマンドを使用します)。

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