SAP Commerce Cloud

インストール後、次のようにしてインスタンスを設定します。

  1. Geometrixx Outdoors 用にファセット検索を設定する
  2. カタログバージョンを設定します。
  3. 読み込み構造を設定する
  4. 読み込む商品属性を設定する
  5. 商品データを読み込む
  6. カタログインポーターを設定します。
  7. インポーターを使用して、カタログを AEM 内の特定の場所に読み込む

Geometrixx Outdoors 用のファセット検索の設定

メモ

この設定は、hybris 5.3.0.1 以降には必要ありません。

  1. ブラウザーで次の URL にアクセスし、Hybris 管理コンソール​に移動します。

    http://localhost:9001/hmc/hybris

  2. サイドバーから「System」、「Facet search」、「Facet Search Config」の順に選択します。

  3. Sample Solr Configuration for clothescatalog 用に​エディターを開きます。

  4. 「Catalog versions」の下の「Add Catalog version」を使用して、リストに outdoors-Staged と outdoors-Online を追加します。

  5. 設定を保存します。

  6. 「SOLR Item types」を開き、次の SOLR Sort を ClothesVariantProduct に追加します。

    • relevance ("Relevance", score)
    • name-asc ("Name (ascending)", name)
    • name-desc ("Name (descending)", name)
    • price-asc ("Price (ascending)", priceValue)
    • price-desc ("Price (descending)", priceValue)
    メモ

    コンテキストメニュー（通常は右ボタンをクリック）を使用して、「Create Solr sort」を選択します。

    Hybris 5.0.0 の場合は、「Indexed Types」タブを開き、「ClothesVariantProduct」をダブルクリックして「SOLR Sort」タブを開きます。

    chlimage_1-36

  7. 「Indexed Types」タブで、「Composed Type」を次のように設定します。

    Product - Product

  8. 「Indexed Types」タブで、「full」の「Indexer queries」を次のように変更します。

    SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}})

  9. 「Indexed Types」タブで、「incremental」の「Indexer queries」を次のように変更します。

    SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}}) AND {modifiedtime} <= ?lastIndexTime

  10. 「Indexed Types」タブで、category ファセットを変更します。カテゴリリストの最後のエントリをダブルクリックすると、「Indexed property」タブが表示されます。

    メモ

    hybris 5.2 の場合は、「Properties」テーブルの Facet 属性が以下のスクリーンショットに従って選択されていることを確認します。

    chlimage_1-37 chlimage_1-38

  11. 「Facet Settings」タブを開き、フィールドの値を変更します。

    chlimage_1-39

  12. 変更内容を​保存​します。

  13. 再び「SOLR Item types」から、以下のスクリーンショットに従って、price ファセットを変更します。category と同様に、price をダブルクリックすると、「Indexed property」タブが表示されます。

    chlimage_1-40

  14. 「Facet Settings」タブを開き、フィールドの値を変更します。

    chlimage_1-41

  15. 変更内容を​保存​します。

  16. 「System」、「Facet search」の順に選択すると、Indexer operation ウィザード​が表示されます。cron ジョブを開始します。

    • インデクサー操作：full
    • Solr 設定：Sample Solr Config for Clothes

カタログバージョンの設定

読み込まれた​カタログバージョン（hybris.catalog.version）を OSGi サービス用に設定できます。

Day CQ Commerce Hybris 設定
（com.adobe.cq.commerce.hybris.common.DefaultHybrisConfigurationService）

通常、カタログバージョン​は、Online または Staged（デフォルト）に設定されます。

メモ

AEM と連携する場合は、いくつかの方法でこのようなサービスの設定を管理できます。詳しくは、OSGi の設定を参照してください。設定可能なパラメーターとそのデフォルト値の詳細については、コンソールも参照してください。

ログ出力は、作成されたページとコンポーネントに関するフィードバックを提供し、潜在的なエラーを報告します。

読み込み構造の設定

デフォルトで作成される（アセット、ページおよびコンポーネントの）サンプル構造を以下に示します。

+ /content/dam/path/to/images
  + 12345.jpg (dam:Asset)
    + ...
  + ...
+ /content/site/en
  - cq:commerceProvider = "hybris"
  - cq:hybrisBaseStore = "basestore"
  - cq:hybrisCatalogId = "catalog"
  + category1 (cq:Page)
    + jcr:content (cq:PageContent)
      - jcr:title = "Category 1"
    + category11 (cq:Page)
      + jcr:content (cq:PageContent)
        - jcr:title = "Category 1.1"
      + 12345 (cq:Page)
        + jcr:content (cq:PageContent)
          + par
            + product (nt:unstructured)
              - cq:hybrisProductId = "12345"
              - sling:resourceType = "commerce/components/product"
              + image (nt:unstructured)
                - sling:resourceType = "commerce/components/product/image"
                - fileReference = "/content/dam/path/to/images/12345.jpg"
              + 12345.1-S (nt:unstructured)
                - cq:hybrisProductId = "12345.1-S"
                - sling:resourceType = "commerce/components/product"
                + image (nt:unstructured)
                  - sling:resourceType = "commerce/components/product/image"
                  - fileReference = "/content/dam/path/to/images/12345.1-S.jpg"
              + ...

DefaultImportHandler インターフェイスを実装する OSGi サービス ImportHandler によって、このような構造が作成されます。商品、商品バリエーション、カテゴリ、アセットなどを作成するために、実際のインポーターによって読み込みハンドラーが呼び出されます。

メモ

読み込み時に生成される構造を、以下に合わせて設定できます。

``Day CQ Commerce Hybris デフォルトインポートハンドラー
(com.adobe.cq.commerce.hybris.importer.DefaultImportHandler)

AEM と連携する場合は、いくつかの方法でこのようなサービスの設定を管理できます。詳しくは、OSGi の設定を参照してください。設定可能なパラメーターとそのデフォルト値の詳細については、コンソールも参照してください。

読み込む商品属性の設定

商品（バリアント）用に読み込むプロパティと属性を定義するように、応答パーサーを設定できます。

  1. OSGi バンドルの設定：

    Day CQ Commerce Hybris デフォルト応答パーサー
    （com.adobe.cq.commerce.hybris.impl.importer.DefaultResponseParser）

    ここで、読み込みとマップに必要な、様々なオプションと属性を定義できます。

    メモ

    AEM と連携する場合は、いくつかの方法でこのようなサービスの設定を管理できます。詳しくは、OSGi の設定を参照してください。設定可能なパラメーターとそのデフォルト値の詳細については、コンソールも参照してください。

商品データの読み込み

商品データは様々な方法で読み込むことができます。商品データは、環境の初期設定時や、hybris データを変更した後に、次の方法で読み込むことができます。

hybris から読み込まれた実際の商品情報は、次の場所にあるリポジトリに保持されます。

/etc/commerce/products

次のプロパティは、hybris とのリンクを示します。

  • commerceProvider
  • cq:hybrisCatalogId
  • cq:hybrisProductID
メモ

hybris 実装（geometrixx-outdoors/en_US）は、商品 ID と他の基本的な情報のみを /etc/commerce の配下に保存します。

商品に関する情報を要求されるたびに、hybris サーバーが参照されます。

完全読み込み

  1. 必要に応じて、CRXDE Lite を使用して既存の商品データをすべて削除します。

    1. 商品データを保持するサブツリーに移動します。

      /etc/commerce/products

      次に例を示します。

      http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

    2. 商品データを保持しているノード（例：outdoors）を削除します。

    3. 「すべて保存」をクリックして、変更内容を保存します。

  2. AEM で hybris インポーターを開きます。

    /etc/importers/hybris.html

    次に例を示します。

    http://localhost:4502/etc/importers/hybris.html

  3. 必要なパラメーターを設定します。次に例を示します。

    chlimage_1-42

  4. 「Import Catalog」をクリックして読み込みを開始します。

    完了したら、次の URL で読み込んだデータを検証できます。

        /etc/commerce/products/outdoors

    これは CRXDE Lite で開くことができます。次に例を示します。

    [http://localhost:4502/crx/de/index.jsp#/etc/commerce/products](http://localhost:4502/crx/de/index.jsp#/etc/commerce/products)

増分読み込み

  1. AEM で、次の場所の適切なサブツリーに保持されている、関連商品の情報を確認します。

    /etc/commerce/products

    これは CRXDE Lite で開くことができます。次に例を示します。

    http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

  2. hybris で、関連商品に関して保持している情報を更新します。

  3. AEM で hybris インポーターを開きます。

    /etc/importers/hybris.html

    次に例を示します。

    http://localhost:4502/etc/importers/hybris.html

  4. 「増分読み込み」チェックボックスを選択します。

  5. 「カタログをインポート」をクリックして読み込みを開始します。

    完了したら、AEM で更新されたデータを次の場所で確認できます。

        /etc/commerce/products

高速更新

読み込み処理には長い時間がかかることがあるので、商品同期の拡張として、カタログの特定の領域を選択して手動で呼び出される高速更新を実行できます。この機能では、書き出しフィードと標準の属性設定を使用しています。

  1. AEM で、次の場所の適切なサブツリーに保持されている、関連商品の情報を確認します。

    /etc/commerce/products

    これは CRXDE Lite で開くことができます。次に例を示します。

    http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

  2. hybris で、関連商品に関して保持している情報を更新します。

  3. hybris で、商品を Express Queue に追加します。次に例を示します。

    chlimage_1-43

  4. AEM で hybris インポーターを開きます。

    /etc/importers/hybris.html

    次に例を示します。

    http://localhost:4502/etc/importers/hybris.html

  5. 「Express Update」チェックボックスを選択します。

  6. 「カタログをインポート」をクリックして読み込みを開始します。

    完了したら、AEM で更新されたデータを次の場所で確認できます。

        /etc/commerce/products

カタログインポーターの設定

hybris カタログは、hybris カタログ、カテゴリおよび商品用のバッチインポーターを使用して AEM に読み込むことができます。

インポーターが使用するパラメーターは、以下に合わせて設定できます。

Day CQ Commerce Hybris カタログインポーター
（com.adobe.cq.commerce.hybris.impl.importer.DefaultHybrisImporter）

AEM と連携する場合は、いくつかの方法でこのようなサービスの設定を管理できます。詳しくは、OSGi の設定を参照してください。設定可能なパラメーターとそのデフォルト値の詳細については、コンソールも参照してください。

カタログの読み込み

hybris パッケージには、初期ページ構造を設定するためのカタログインポーターが付属しています。

次の場所から使用できます。

http://localhost:4502/etc/importers/hybris.html

ecommerceimportconsole

以下の情報を指定する必要があります。

  • 基本ストア hybris で設定された基本ストアの識別子。

  • カタログ 読み込むカタログの識別子。

  • ルートパス カタログを読み込むパス。

カタログからの商品の削除

1 つまたは複数の商品をカタログから削除するには：

  1. OSGi サービス Day CQ Commerce Hybris Catalog Importer を設定します。カタログインポーターの設定も参照してください。

    以下のプロパティをアクティベートします。

    • Enable product removal
    • Enable product asset removal
    メモ

    AEM と連携する場合は、いくつかの方法でこのようなサービスの設定を管理できます。詳しくは、OSGi の設定を参照してください。設定可能なパラメーターとそのデフォルト値の詳細については、コンソールも参照してください。

  2. 増分更新を 2 回実行して、インポーターを初期化します（カタログの読み込みを参照）。

    • 1 回目の実行では、変更された商品セットがログリストに表示されます。
    • 2 回目の実行では、更新される商品はありません。
    メモ

    1 回目の読み込みは、商品情報を初期化するためのものです。2 回目の読み込みでは、すべてが問題なく機能していることと、商品セットの準備が完了していることを確認します。

  3. 削除する商品を含むカテゴリページを確認します。商品の詳細が表示されています。

    例えば、次のカテゴリには Cajamara 商品の詳細が表示されます。

    http://localhost:4502/editor.html/content/geometrixx-outdoors/en_US/equipment/biking.html

  4. hybris コンソールで商品を削除します。「Change approval status」オプションを使用して、ステータスを「unapproved」に設定します。商品がライブフィードから削除されます。

    次に例を示します。

    • http://localhost:9001/productcockpit ページを開きます。
    • カタログ Outdoors Staged を選択します
    • Cajamara を検索します
    • この商品を選択し、承認ステータスを「unapproved」に変更します。

  5. もう一度増分更新を実行します（カタログの読み込みを参照）。削除された商品がログに記録されます。

  6. 該当するカタログをロールアウトします。商品と商品ページが AEM 内から削除されます。

    次に例を示します。

  7. 商品を元に戻すには：

    1. hybris で、承認ステータスを「approved」に戻します。

    2. AEM では、

      1. 増分更新を実行します。
      2. 該当するカタログを再度ロールアウトします。
      3. 該当するカテゴリページを更新します。

注文履歴特性の ClientContext への追加

注文履歴を ClientContext に追加するには：

  1. 次のどちらかの方法で、ClientContext のデザインページを開きます。

    • 編集するページを開いてから、Ctrl + Alt + C キー（Windows）または control + option + C キー（Mac）を使用してクライアントコンテキストを開きます。ClientContext の左上隅にある鉛筆アイコンを使用して、ClientContext のデザインページを開きます。
    • http://localhost:4502/etc/clientcontext/default/content.html に直接移動します。

  2. 注文履歴​コンポーネントを ClientContext の​買い物かご​コンポーネントに追加します。

  3. ClientContext に注文履歴の詳細が表示されていることを確認できます。次に例を示します。

    1. ClientContext を開きます。

    2. アイテムを買い物かごに追加します。

    3. チェックアウトを完了します。

    4. ClientContext を確認します。

    5. 別のアイテムを買い物かごに追加します。

    6. チェックアウトページに移動します。

      • ClientContext に注文履歴の概要が表示されます。
      • 「以前買い物されたお客様です」というメッセージが表示されます。
    メモ

    このメッセージは、次の方法で実現されています。

このページ